+ ui3Rt^RIt^RIt^RIt^RIt^RIt^RIt^RItR tRt Rt ] 3RRllt R!RRllt R"R R llt R#R ltR R ltRRltR$RRlltR^R^PRRRRRRRRR^/RRlltRt]R8Xd ]!4R#R#)%uDetect voice onset in a VO take and align it to the cue start. Strategy (phase 1 — anchored inside the green focal area): 1. Detect voice onset in the take file. Cascade silencedetect at a few thresholds, then fall back to an RMS envelope on decoded PCM when silencedetect doesn't find a plausible leading silence. 2. Target position inside the file = preroll_ms + anchor_offset_ms, so voice lands slightly INSIDE cue.start on the master timeline (user asked for "somewhat inside" instead of exactly at the edge). 3. Before shifting, sanity-check that the detected onset is inside the plausible green-zone window (preroll_ms ± shadow_lead on the early side, preroll_ms + cue_duration + shadow_trail on the late side). If it's outside that window, detection lied — skip the shift entirely and leave the take as recorded. Never clobber the take with a nonsense pad/trim that pushes voice outside the green zone. 4. If detection is plausible, trim (actor came in late) or pad (actor came in early) so voice lands at target_in_file_ms. Output is a re-encoded webm (libopus 128k) so edit points are sample-accurate. Requires ffmpeg on PATH. Uses numpy for the RMS fallback. Ng?gQ?c TV^8dQhR\R\R\R\R\/#) input_path threshold_db min_silence_smin_voice_burst_sreturnstrfloatint)formats"V/Users/a11/Documents/CLAUDE_ENVIRONMENTS/ATRI-VOX-SUITE/vo-booth/scripts/align_take.py __annotate__r2s2%%%5%QV%/4%NQ%c RRRRVRRV RV 2RR R . p\P!VR R R 7pVPp\P!R V4Uu.uFp\ VP ^44NK pp\P!RV4Uu.uFp\ VP ^44NK p pV'dV^,R8d V 'gR#\ R4p \V 4FWwrV ^,\V48dW^,,MT p W, V8gK<\\V R,44u# R#uupiuupi)uRun silencedetect once and return voice-onset ms if the file has leading silence starting within 10ms of t=0 AND the first non-silent burst sustains for at least min_voice_burst_s. Sub-burst transients (record-start clicks, mouse clicks captured a few ms above threshold) are skipped — the algorithm walks past to the first silence_end whose subsequent voice burst is genuinely sustained. Without this gate, a sub-millisecond click at e.g. 80 ms gets returned as voice onset and the cascade locks in a false positive (B2 from 2026-04-30). Returns -1 if no silence_end has a sustained voice burst — caller relaxes the threshold (next cascade step) or falls back to the RMS envelope detector.ffmpeg -hide_bannerz-nostats-i-afzsilencedetect=noise=z dB:duration=-fnull-T)capture_outputtextzsilence_start:\s*([\d.]+)zsilence_end:\s*([\d.]+)g{Gz?inf) subprocessrunstderrrefinditerr group enumeratelenr round)rrrrcmdoutr msilence_starts silence_endsINFiend next_starts&&&& r_silencedetect_onset_msr02s. .* j %l^< O fc  C ..T =C ZZF13=Y[a1bc1bAeAGGAJ'1bNc13=W[a1bc1bAeAGGAJ'1bLc ~a047L ,CL)./!ec.6I.I^E*s  0 0uS4Z() )* Idcs #E#E cHV^8dQhR\R\R\R\/#)rrmax_duration_s window_msrr )r s"rrrZs*++++s++E++TW++ad++rc:^RIpRpRRRRRTRTR R R R \T4R RR.p\P!TRRR7pTP TPTPR7PTP4R, pTP^8XdR#\^\YB,R, 44pTPT,p T ^8dR#TPTRY,PY4^,P!^R74p \^^T,4p \#TP%T RT 44R,p \T R,R4p Y8pTP'4'gR#\)\+T4^, 4F2pY,'gKY^,,'gK*Y,u# \TP-44T,# \dRu#i;i \P dRu#i;i)uFallback onset detector — decode the first `max_duration_s` of audio to mono PCM and find the first sustained rise above the leading noise floor. Returns onset in ms, or -1 if the envelope is flat / decode failed.Ni>rr -loglevelerrorrz-tz.2fz-ac1z-arrs16lerT)rcheck)dtypeg@r)axisgư>g@g{Gz?r)numpy ImportErrorr rrCalledProcessError frombufferstdoutint16astypefloat32sizemaxr sqrtreshapemeanr mediananyranger%argmax)rr2r3npsrr'r(pcmwinnrmshead_nfloorthreshabover-s&&& r_rms_envelope_onset_msrWZs  B.+w j $ sE3r7 gs  CnnSTB -- "((- 3 : :2:: F PC xx1} aR^d*+ ,C CA1u ''3x=((0A5;;;C DC C9$ %F "))CL) *T 1Ed #F LE 99;; 3u:> " 88!e = # u||~  **I    ( ( s"G-H- G=<G=HH皙?cHV^8dQhR\R\R\R\/#)rrrrrr )r s"rrrs*     5  QV  ad  rc~\Fp\W\4pV^8gKVu# \V4pV^8dV#^#)uReturn ms where voice starts within the file. Cascades silence thresholds, then falls back to RMS envelope. Always returns ≥ 0 (0 = file starts hot).)_SILENCE_THRESHOLDS_DBr0_SILENCE_MIN_DURATION_SrW)rrrthronset rms_onsets&&& rdetect_onset_msr`sC&' 9PQ 19L& 'z2IA~ rc\P!VRRRR7R# \Pd7p\RT RTPP 4R, 24ThRp?ii;i)T)r9rrzffmpeg failed (z): :NiNN)rrr> RuntimeErrorr strip)args descriptiones&& r_ffmpegrgs^^t44H  ( (^_[MQXX^^=Md=S .+w '$,s# j 66    rc<V^8dQhR\R\R\/#)rrripad_msrk)r s"rrrs!SsCrcH\RRRRRRVRRV RV 2R R R R V.R R7R#)rrr5r6rmrrzadelay=|rnrorprqpadrsNrt)rrirws&&&rpad_silence_at_startr{sB .+w j &* 66    rc TV^8dQhR\R\R\R\R\/#)rrrishift_ms tolerance_msr)r r dict)r s"rrrs03SCs[_rc *\V4V8:d\P!W4RpM%V^8d\WV4RpM\ WV)4RpR\ P PV4R\ P PV4RVRVRV/#) uShift the audio timing by shift_ms (applied ABSOLUTELY to input_path). shift_ms > 0 → trim shift_ms from the start (voice plays earlier on timeline) shift_ms < 0 → pad |shift_ms| of silence at the start (voice plays later) |shift_ms| ≤ tolerance_ms → copy unchanged copyrrrzinputoutputr}actionr~)absshutilcopyfilerur{ospathabspath)rrir}r~rs&&&& r shift_takers 8} $ 0 A :Zxi@ ,"''//+.H&  rcue_duration_msanchor_offset_msshadow_lead_ms,shadow_trail_msrrr~cV^8dQhR\R\R\R\R\R\R\R\R \R \R \/ #) rrri preroll_msrrrrrrr~r)r r r r)r s"rrrsv=====  =  ====== =rc\WV4p \^W%, 4p Y#^8dTMR,V,p W8gW8dn\P!W4R\P P V4R\P P V4R^RRRV RV R VR VR VR W.R RRVRV/ #W$,p W, p\WW4pWR&W/R &WOR &W?R &WR&WR&V#)a;Detect voice onset and shift so voice lands at preroll_ms + anchor_offset_ms. cue_duration_ms: width of the green focal area. When > 0, the detected onset is sanity-checked to fall within the plausible green-zone window. If it falls outside, the shift is skipped entirely (take is left as recorded). anchor_offset_ms: how far past cue.start to target voice onset. Small positive value puts voice "somewhat inside" the cue rather than exactly at the edge. shadow_lead_ms / shadow_trail_ms: tolerance on either side of the cue window for the sanity check. irrr}rskipr~detected_onset_msrrrplausible_range_msreasononset_out_of_green_zonerr)r`rErrrrrr)rrirrrrrrrr~onset_ms min_expected max_expectedtarget_in_file_msr}infos&&&$$$$$$$ ralign_take_to_cuers.zGH q*56La4GTRUddL("9  0 RWW__Z0 bggook2  f L  *  0  <"> / L ]  #5+H jx FD ( #/ - ') Krc \P!\P4^,R7pVP RRR7VP RRR7VP R\ RR R 7VP R \ ^R R 7VP R\ ^PRR 7VP R\ RRR 7VP R\ RRR 7VP R\ R RR 7VP R\ RRR 7VP R\ ^RR 7VP4p\VPVPVPVPVPVPVPVP VP"VP$R7 p\'\(P*!V^R74R#)!rsrz Input audio file (webm/wav/etc.))helprzOutput webm filez --prerollTz:Expected voice-onset position in ms (the cue's preroll_ms))typerequiredrz--cue-durationzKCue duration ms (for green-zone sanity check); 0 = unknown, use wide window)rdefaultrz--anchor-offsetz5Target voice this many ms past cue.start (default 80)z --shadow-leadrzEarly-side shadow tolerance msz--shadow-trailrzLate-side shadow tolerance msz --thresholdz"Silence threshold dB (default -40)z --min-silencerXz$Min silence duration s (default 0.1)z --toleranceu-No-op if |shift| ≤ this many ms (default 5))rrrrrrr~)indentND)argparseArgumentParser__doc__ splitlines add_argumentr r parse_argsrrrpreroll cue_duration anchor_offset shadow_lead shadow_trail threshold min_silence toleranceprintjsondumps)aprdresults r_clirsw  W-?-?-A!-D EBOOG"DOEOOH#5O6OOKcDUWOO$3fhOO%CPROOO#sAaObOO$3BaObOOMuCgOhOOO%CiOjOOMQ=lOm ==?D  DKK))++''))^^&&^^ F $**VA &'r__main__r)rg@g<)g@)rrX)))rrrrr!rrsysr[r\_MIN_VOICE_BURST_Sr0rWr`rgrur{rrr__name__rrrs*  /8J%P++\  ^4=  =  === ===@(: zFr