How macielg1/vodrecovery works
Project Type and Purpose
• This is an open-source, command-line Python application (“Vod Recovery”) designed to fetch and download Twitch live streams, VODs, highlights, and clips by orchestrating HTTP scrapers, download engines (ffmpeg/yt-dlp), and optional trimming or live-watch features.
File Structure Analysis
• Top-level scripts:
• install_dependencies.py – bootstraps Python packages & ffmpeg
• vod_recovery.py – main CLI entrypoint
• Configuration:
• config/settings.json, config/help.json – customizable options, help text
• Libraries/helpers:
• lib/domains.txt, lib/user_agents.txt – lists for HTTP requests
• lib/install_ffmpeg.py – helper to install or validate ffmpeg
• lib/requirements.txt – Python dependencies
• Shortcuts: .bat/.sh wrappers for quick CLI invocation
README Insights
• Core features outline the functional modules: URL parsing (Twitch/TwitchTracker/SullyGnome/Streamscharts), download backend (ffmpeg or yt-dlp), M3U8 unmute/trimming, live recording/watch.
Detailed Yet Focused
• At least these components: User CLI, Config Manager, URL Scraper, Download Engine, M3U8 Processor, External Services, Storage.