How moritzgladigau/yt2mpx works
yt2mpX is a local web app for checking YouTube video or playlist links, selecting media options, and downloading converted files. The main workflow runs from browser link checking through job creation, media processing, metadata review, and final delivery; playlists are packaged as ZIPs. The README also documents optional account cookies and fingerprint-based identification, plus fallback metadata and cover-art lookup. Backend processing is concentrated in app/main.py, while app/static/app.js implements the browser workflow. Some backend stages are documented but their implementation details were not sampled.
Main entry points: main.py Job orchestration · app.js Download UI
Components 16
Browser interface
- Download UI
app/static/app.js - Playlist selection
app/static/app.js - Metadata review
app/static/app.js
Media processing
- Link probe
app/main.py - Job orchestration
app/main.py - YouTube / yt-dlp
- Media conversion
app/main.py
Metadata enrichment
- Audio fingerprinting
app/main.py - AcoustID
- MusicBrainz lookup
- Tag writing
app/main.py - Cover art lookup
app/main.py
Job delivery
- Temporary job files
app/main.py - File and ZIP download
app/main.py - Download history
app/static/app.js
Other components
- Home-network user
Connections 20
- Home-network user → Download UI: uses
README.md - Download UI → Link probe: checks link
app/static/app.js - Download UI → Playlist selection: selects items
app/static/app.js - Download UI → Job orchestration: starts job
app/static/app.js - Link probe → YouTube / yt-dlp: inspects URL
README.md - Job orchestration → YouTube / yt-dlp: downloads media
README.md - Job orchestration → Media conversion: converts media
README.md - Job orchestration → Playlist selection: uses selections
- Media conversion → Audio fingerprinting: fingerprints tracks
app/main.py - Audio fingerprinting → AcoustID: identifies audio
README.md - AcoustID → MusicBrainz lookup: matches recording
README.md - Job orchestration → Metadata review: provides suggestions
README.md - Metadata review → Job orchestration: submits edits
app/static/app.js - Job orchestration → Cover art lookup: finds artwork
README.md - Job orchestration → Tag writing: writes tags
README.md - Job orchestration → Temporary job files: stores files
README.md - Job orchestration → File and ZIP download: prepares result
README.md - Download UI → Download history: refreshes history
app/static/app.js - Download history → Job orchestration: requests history
app/static/app.js - File and ZIP download → Home-network user: delivers file
README.md