Yubal

A self-hosted YouTube Music downloader that automatically tags, organizes, and syncs your music library. Paste any YouTube Music URL and get a clean, tagged collection organized by artist and album.

What You Can Do After Deployment

1. Open your domain — access the web UI to start downloading music
2. Paste a link — enter any YouTube Music URL (track, album, or playlist)
3. Get organized files — tracks are automatically tagged with metadata, lyrics, and cover art
4. Sync playlists — subscribe to playlists for automatic scheduled sync of new tracks
5. Connect a media server — point Navidrome, Jellyfin, or Gonic at the data volume for streaming

Key Features

• Web UI with real-time download progress and job queue
• Albums, playlists, and individual track downloads
• Scheduled playlist sync with duplicate detection
• Automatic metadata tagging (artist, album, year, track number)
• Synced lyrics (.lrc files) from lrclib.net
• ReplayGain tagging for consistent playback volume
• Format options — opus (best quality), mp3, or m4a
• Smart deduplication — same track in multiple playlists stored once
• Media server integration (Navidrome, Jellyfin, Gonic)

License

MIT — GitHub