Bandcamp indexer and download client for Lidarr. Searches your Bandcamp collection and downloads albums you've bought.
This only works with music you own. It connects to your Bandcamp account and searches your purchase history. If you haven't bought it on Bandcamp, it won't show up.
- Lidarr on the nightly branch (plugins aren't on stable yet)
- A Bandcamp account with at least one purchased album
- A browser to grab your session cookie
- In Lidarr, go to System → Plugins
- Paste
https://github.com/jtstothard/lidarr-plugin-bandcamp - Click Install, restart if asked
Bandcamp will now show up as an available indexer and download client.
- Settings → Indexers → Add (
+) - Pick Bandcamp from the list
- Paste your
identitycookie into Session Cookies (see below for how to get it) - Test, then Save
- Settings → Download Clients → Add (
+) - Pick Bandcamp
- Same cookie as above in Session Cookies
- Set Download Path to somewhere Lidarr can write to (like
/downloads/bandcamp) - Test, then Save
You need to enable the Bandcamp protocol or Lidarr won't use it for searches:
- Settings → Profiles → Delay Profiles
- Edit your default profile
- Toggle Bandcamp on
- Save
The plugin authenticates using the identity cookie from your browser.
Chrome:
- Log into bandcamp.com
- Open DevTools (
F12) → Application tab → Cookies →https://bandcamp.com - Find
identity, copy its value - Paste that into the Session Cookies field
Firefox:
- Log into bandcamp.com
- Open Developer Tools (
F12) → Storage tab → Cookies →https://bandcamp.com - Find
identity, copy its value - Paste that into the Session Cookies field
The cookie expires eventually. When downloads start failing, just grab a fresh one.
| Format | Type |
|---|---|
| FLAC | Lossless |
| ALAC | Lossless |
| WAV | Lossless (uncompressed) |
| AIFF | Lossless (uncompressed) |
| MP3 V0 | Lossy |
| MP3 320 | Lossy |
| OGG Vorbis | Lossy |
| AAC | Lossy |
Lidarr picks the best one based on your quality profile.
- Only downloads albums you've bought on Bandcamp. No public search.
- The
identitycookie expires. Re-export it when things stop working. - Searches your collection, not the full Bandcamp catalog.
Plugin doesn't show up in Lidarr
You need the nightly branch, not stable. Go to Settings → General → change branch to nightly, save, and update.
Authentication errors / downloads fail Your cookie expired. Get a fresh one from your browser.
Search returns nothing Check that you actually bought the album on Bandcamp. Also make sure the Bandcamp protocol is enabled in your Delay Profile (Settings → Profiles → Delay Profiles).
See CONTRIBUTING.md for build instructions and PR guidelines.
MIT. See LICENSE.