+ TV-jBRt^RIt^RIt^RIt^RIHt^RIHtHtH t ^RI t RRRRRRRRRRR R R R R R /t R R RRRR/t RRltRRltR$RRlltRRltRRltR%RRlltR&RRlltR'R R!lltR&R"R#lltR#)(a]Audio I/O utilities using miniaudio. This module provides functions for reading and writing audio files. - Reading: Uses miniaudio to support WAV, MP3, FLAC, and Vorbis formats. Uses ffmpeg for M4A/AAC, OGG, Opus, and WebM format support. - Writing: Uses miniaudio for WAV and ffmpeg for MP3, FLAC, OGG, Opus, Vorbis, and WebM encoding. N)Path)OptionalTupleUnionwavmp3flacoggvorbism4aaacwebmint16SIGNED16int32SIGNED32float32FLOAT32c0V^8dQhR\R\/#)datareturn)bytesstr)formats"c/Volumes/fast/ai/experiments/ui-tars-smoke/.venv/lib/python3.14/site-packages/mlx_audio/audio_io.py __annotate__r%sEEEEcEc,VR,R8XdVR,R8XdR#VR,R8XgVR,R 8XgVR,R 8XdR #VR,R 8XdR #VR,R8XdR#VR,R8XdR#VR,R8XdR#\R4h)z6Detect audio format from bytes data using magic bytes.NNsRIFF: NsWAVEr:NNsID3:rNssrsfLaCrOggSr r r!Nftypr Eߣr z(Unable to detect audio format from bytes) ValueError)rs&r_detect_format_from_bytesr*%s Bx7tDzW4 bV S [ 8DI>) $ $;<<  "1 %Ffjj67KFJJz1-.I*e$$             N   #      O          N   #z$G 1$5m6J6J6Q6Q6S5TUVVmmM00AG  **rc V^8dQhR\\\\P3,R\ R\R\ \P\3,/#)rfile always_2drDr rrrioBytesIOboolrr-r.r/)rs"rrrsSc c T2::% &c c  c  2::s? c rcRp\V\\34'd=\V4PP R4P 4pVR9dRpM\V\ P4'd`VP^4VP^ 4pVP^4VR,R8XgVR,R8XgVR,R8XdRpV'dU\V\ P4'd#VP^4VP4pMTp\V4wrxp EM^R I p \V\\34'dMV P\V44p V P\V4V PV PR 7p M\V\ P4'dVP^4VP4p \!V 4pVR 8XdV P#V 4p MYVR 8XdV P%V 4p M@VR 8XdV P'V 4p M'VR8XdV P)V 4p M\+RV 24hV P-V V PV PR 7p M\/R\1V4 24hV PpV Pp \2P4!V P6\2P8R7pV ^8dVP;RV 4pVR9dVP=V4R, pMVR8XdMVP=V4pV'd+VP>^8XdVR\2P@3,pWx3#)aRead an audio file using miniaudio (or ffmpeg for M4A/AAC/OGG/Opus/WebM). Args: file: Path to the audio file or a BytesIO object. always_2d: If True, always return a 2D array (samples, channels). dtype: Data type for the output array. Supports 'float32', 'float64', 'int16'. Returns: Tuple of (audio_data, sample_rate). audio_data is a numpy array with shape (samples,) for mono or (samples, channels) for multi-channel. F.Tr&r'rr%r(N)rXr;rrrr zUnsupported format: zUnsupported file type: rCg@r:NNN)r r r opusr )rfloat64)!rHrrsuffixlstriplowerrarbseekreadr\ miniaudio get_file_info decode_filerXr;r* wav_get_info mp3_get_info flac_get_infovorbis_get_infor)rM TypeErrortyper-arrayr[rreshapeastypendimnewaxis)r^r_rD use_ffmpegextheaderr,r[r;rXrninfodecodedrfmts&&& rrmrms"J$d $$4j&&s+113 7 7J D"** % % ! 2 ! 3K7 "bzW$bz00J dBJJ ' ' IIaLJJ*8*D'i  dS$K ( (**3t95D++D .. ,,,G bjj ) ) IIaL99;D+D1Ce| --d3 --d3 ..t4 006 #7u!=>>&&.. ,,'G 5d4j\BC C)) %% ((7??"((;1}//"i0 &&..''1 '  ..'W\\Q&!RZZ-(  rc$V^8dQhR\/#rr)rc)rs"rrrs...rc2\P!R4RJ#)z+Check if ffmpeg is available on the system.r1N)rErFrr_check_ffmpeg_availablers << ! --rc$V^8dQhR\/#r)r)rs"rrr#s#rcP\P!R4pVf \R4hV#)zGet the path to ffmpeg executable. Returns: Path to ffmpeg executable. Raises: RuntimeError: If ffmpeg is not found. r1a? ======================================== ffmpeg not found! ======================================== ffmpeg is required for MP3/FLAC/WebM encoding and M4A/AAC/WebM decoding. Install ffmpeg: macOS: brew install ffmpeg Ubuntu: sudo apt install ffmpeg Alternatively, use WAV format which doesn't require ffmpeg. )rErFrG)rRs r_get_ffmpeg_pathr#s3,,x(K L   rcV^8dQhR\PR\R\R\\\ \ P3,R\R\RR/#) rr sampleraterXoutputrbitraterN)r-r.r/rrrrarb)rs"rrr?stNKNK **NKNKNK #tRZZ' ( NK  NK  NK NKrc \4pVP^8XdVP4pMVP4P4pVRRRR\ V4R\ V4RR. pVR8XdVP R V.4MTVR 8XdVP R R R V.4M7VR 8XdVP R R R V.4MVR9dVP R R.4VR8XdRpVP RV.4\ V\P4'dVPR4\P!VVRR7p V P^8wd'\RV PP4 24hVP!V P"4VP%^4R#VP\ V44\P!VVRR7p V P^8wd'\RV PP4 24hR#)a]Encode audio using ffmpeg. Args: data: Audio data as int16 numpy array (samples,) or (samples, channels) samplerate: Sample rate in Hz nchannels: Number of channels output: Output file path or BytesIO object format: Output format (mp3, flac, ogg, opus, vorbis, etc.) bitrate: Audio bitrate for lossy formats (default: 128k) z-yr=r>r@rAr5r6rz-b:arfz-c:alibopusr r r rrBTr7zffmpeg failed: N)r r )rrztobytesflattenrextendrHrarbappendrIrJrKrGrLrMwriterOrl) rrrXrrrrR pcm_bytescmdresults &&&&&& r_encode_ffmpegr?s$#$K yyA~LLN LLN**,      J  I  C FG$% 6  FIvw78 6  FIvw78 $ $ FF#$JJf~&"**%% 8      !1E1E1G0HIJ J V]]# A 3v;      !1E1E1G0HIJ J "rc V^8dQhR\\\\P3,R\ P R\R\\,RR/#rr^rrrrN rrrrarbr-r.r/r)rs"rrrs`sAsA T2::% &sA **sAsA SM sA  sArc^RIpVfR\V\\34'd4\V4PP R4P 4pMRpVP 4p\V\P4'g\VR4'd8\VR4'g&\P!VP44pM?\VR4'd\P!V4pM\P!V4pVP\P\P39d@\P !VRR4pVR,P#\P$4pM>VP\P$8wd VP#\P$4pVP&^8Xd^pTpM#VP(^,pVP+4pVR8XgVR 8XdVP-4p\V\.P04'd%VP3V4VP5^4R#\7VR 4;_uu_4pVP3V4RRR4R#VR8XEd7^RI p V PR VP44p VP9R VVVP:P<V R 7p \V\.P04'd^RIp V PARRR7;_uu_4p V PBpRRR4VPEXV 4\7VR4;_uu_4pVP3VPG44RRR4VP5^4^RI$pVPKV4R#VPE\V4V 4R#VR9dO\M4'g/^RI'pVPQRVPS4 R2\T^R7\WWWPVR7R#\YRV 24h +'giR#;i +'giEL;i +'giL;i ^RI$pTPKX4i;i)aWrite audio data to a file. Args: file: Path to the output file or a BytesIO object. data: Audio data as numpy array. Shape can be (samples,) for mono or (samples, channels) for multi-channel. samplerate: Sample rate in Hz. format: Output format. Supports 'wav', 'flac', 'mp3', 'ogg', 'opus', 'vorbis', 'webm'. If None, inferred from file extension. Note: WAV uses miniaudio for encoding. MP3, FLAC, OGG, Opus, Vorbis, and WebM use ffmpeg (must be installed: brew install ffmpeg). Nrertolist __array__g?ipcmrawwbhr)namerXr; sample_formatr[z.wavF)rideleterbzffmpeg is required for z encoding but was not found. Install with: brew install ffmpeg (macOS) or sudo apt install ffmpeg (Ubuntu). Falling back will fail - consider using WAV format instead.) stacklevelrzUnsupported output format: g)rrr rfr r )-rnrHrrrirjrkr-r.hasattrrwrasarrayrDrrhclipryrrzshaperrrarbrrlopenDecodedSoundFile SampleFormatrtempfileNamedTemporaryFilerwav_write_filermosunlinkrwarningswarnupperRuntimeWarningrr))r^rrrrnrX samples_flatrfrw samples_arraysoundrtmptmp_pathrrs&&&& rrrsS(~ dS$K ( ($Z&&--c288:FF \\^F dBJJ ' ' 4 " "74+E+E88DKKM*D T; ' '::d#D88D>D zzbjj"**--wwtT3'u $$RXX. rxx {{288$ yyA~  JJqM ||~  &E/ ((* dBJJ ' ' JJy ! IIaLdD!!Q ""! 5 C)<)<)>? **"#0099! +  dBJJ ' ' ,,F5,IIS88J $((59(D))QJJqvvx(* !  (#  $ $SY 6 C C&((  MM)&,,.)9:NN   tH6vh?@@e"!!,JII*) (#s<-P* P>4&Q% Q:Q%* P; > Q  Q" Q%%Q<cV^8dQhR\\\\P3,R\ R\ \P\3,/#)rr^r_rr`)rs"rrrsC<< T2::% &<< 2::s?rs )) 5 5 F 8 h 5 5 F   Z Z yE(|+~c L. 8NKbsAn<$11r