About
ListenBrainz builds you a fresh Weekly Jams and Weekly Exploration every week.
tapedeck turns them into music you own. It looks every track up on MusicBrainz, downloads
it with yt-dlp, writes proper tags, files it into a clean Artist/Album/Track tree, keeps
an m3u8 per playlist and pushes the playlist to Plex. Run it once, or let the daemon do it
every few hours.
Vibe coded, built for one person. tapedeck is written with AI assistance for my own
setup and comes with no guarantees. You are welcome to try it and to
file issues; I will try to fix them.
ListenBrainz ──▶ MusicBrainz ──▶ yt-dlp ──▶ tags ──▶ Artist/Album (Year)/01 - Title.opus
playlists metadata audio lofty │
├──▶ playlists/*.m3u8
└──▶ Plex playlist
I used Explo for this and wanted a few things it
doesn't do: a real library layout instead of a flat folder of files, a database so a song
that shows up in three weekly playlists is downloaded once, a daemon with a CLI that talks
to it, and output that scripts (or an AI agent) can parse. tapedeck is that, in Rust. The
binary is called td.
What you get
- A library, not a dump. Lidarr-style path templates:
{album_artist}/{album} ({year})/{track:02} - {title}.{ext} by default, yours if you prefer.
- Metadata from MusicBrainz, keyed by the recording IDs ListenBrainz already gives you.
Consistent artist, album, year and track number, and a hard guarantee against duplicates.
- Tags written by tapedeck, not by whatever the download site had. Album artist and
track artist are kept apart, so featured guests don't split an album across folders.
- An m3u8 per playlist, kept in step with the playlist on Plex and readable by any player,
with last week's copy archived. Tracks that drop out of a playlist stay in your library.
- Downloads from YouTube Music's song results first, matched by length against the
MusicBrainz recording and checked again after the download, so you get the album audio
rather than the music video with the two-minute intro.
- Plex sync that scans the library, matches files and recreates the playlist.
- Plays, too:
Enter in the TUI plays a track and queues the rest through mpv, locally or
streamed from the NAS, and scrobbles to ListenBrainz so next week's playlists know.
- Use it from your laptop: the daemon serves its commands and the audio over HTTP behind a
token, so
td tui on another machine browses and controls the NAS.
- Song requests from Telegram: send a link or "Artist - Title", get the proper recording
filed and a yearly Requests playlist on Plex; it asks only when it is not sure.
- Other libraries respected: point it at Lidarr's folder and a recording that exists there
is never downloaded again; playlists use the better copy, and own duplicates can be swapped out.
- Lyrics. Synced lyrics from LRCLIB land as
.lrc files next to the music, so Plexamp
shows them, and in the database, so Subsonic apps get them too. On by default, no account.
- Steam soundtracks. Point
[steam] at the Steam client's steamapps/music, or give it
a steamcmd account and the daemon downloads every soundtrack you own. They come in with
their own tags and artwork, no MusicBrainz needed.
- A Subsonic server, too. Point cliamp, Symfonium, Feishin or any Subsonic app at the
daemon's port: playlists, browsing by MusicBrainz artist and album, cover art, streaming and
scrobbling to ListenBrainz, with sign-in optional on a LAN.
- Daemon or one-shot, same CLI.
td daemon runs on an interval and listens on a Unix
socket; every other command talks to it if it's running and does the work itself if
not.
Built with
Rust · clap ·
rusqlite · lofty ·
reqwest · tokio ·
yt-dlp · MusicBrainz ·
ListenBrainz
Getting started
Prerequisites
- A ListenBrainz account with listening history, so it has
recommendations to generate.
yt-dlp and ffmpeg on PATH, unless you install through Nix, which bundles them.- Optionally a Plex server and its token.
Installation
Prebuilt binaries for Linux and macOS (x86_64 and arm64) are attached to each
release. With
bin:
bin install github.com/arunoruto/tapedeck
Nix, with x86_64-linux builds served from arunoruto.cachix.org (the flake advertises
the cache; accept it with --accept-flake-config or add it to your substituters):
nix run github:arunoruto/tapedeck -- --help
Cargo:
cargo install --git https://github.com/arunoruto/tapedeck
This is the beginning of the README. Read the rest at the original. Read the full README ↗
