README.md

metadata

title: timecodegen
sdk: gradio
emoji: 🚀
colorTo: green

YouTube Timecode Generator (Gradio / Hugging Face Spaces)

Generate YouTube-style timecodes from a long audio file.

Features

• Auto-detect track starts using silence detection (pydub + ffmpeg)
• Manual starts (seconds / mm:ss / hh:mm:ss)
• Optional custom titles (one per line)
• Exports ready-to-paste timecodes and downloadable timecodes.txt

How to use

1. Upload your album/playlist audio (mp3/wav/flac).
2. Choose Auto or Manual.
   • Auto: tune Silence threshold, Minimum silence, Seek step.
   • Manual: enter comma-separated starts.
3. (Optional) Paste Titles (one per line).
4. Click Generate Timecodes → copy result or download timecodes.txt.

Notes

• This Space uses ffmpeg via packages.txt.
• For loud continuous mixes or live recordings, Auto mode may need higher min_silence and a less negative silence_threshold (e.g., -26 dBFS).