Repository navigation
v1.0.0 - Initial Working Release
🧠 Initial Stable Release – Whisper-Enhanced Subtitle Downloader
This is the first official release of the yt_download_faster_final_cookies.sh script – a robust macOS-compatible tool that:
• 🧾 Downloads YouTube videos using yt-dlp with optional cookie-based authentication
• 💬 Automatically pulls manually uploaded subtitles if available
• 🎙️ Falls back to Faster Whisper (OpenAI Whisper AI) transcription using a locally installed model (large-v2 or small)
• 🧹 Deep cleans and reconstructs malformed SRTs with Python and validates them with ffmpeg
• 🎞️ Merges video, audio, and subtitles into a final .mkv file using mkvmerge
• 🗂️ Stores everything in the user’s Downloads folder and cleans up temporary files
Key Features
• Auto-detects and sets up virtual environment (whisper-env) if not already created
• Ensures required tools are present: yt-dlp, ffmpeg, mkvmerge, faster-whisper, Python 3.8+
• Uses macOS’s secure temporary directory system
• Checks for Homebrew and Python version at launch
• Cleaner logic around when to download audio (only if Faster Whisper is needed)
• Handles subtitle fallbacks and conversion from .vtt to .srt