Skip to content

divpreeet/downloadarr

Folders and files

NameName
Last commit message
Last commit date

Latest commit

725b6f4 · · Apr 8, 2026

History

29 Commits
Mar 18, 2026
Apr 5, 2026
Apr 8, 2026
Apr 3, 2026
Apr 7, 2026
Apr 7, 2026
Apr 7, 2026
Apr 7, 2026
Apr 8, 2026
Apr 7, 2026
Apr 8, 2026
Apr 8, 2026
Apr 8, 2026

Repository files navigation

downloadarr

an on demand music downloader with a web interface that does tagging and proper metadata

how it works

  • you enter a song you want to download
  • downloadarr finds metadata on spotify/deezer
  • gives you 5 results to pick the correct metadata
  • formats the metadata title to search on youtube
  • gives you 5 youtube results
  • your song is downloaded and stored as MUSIC_DIR/Artist/Album/Song

you can choose the output folder — just change MUSIC_DIR in docker-compose.yml.

eg:

MUSIC_DIR=/app/music

spotify usage

by default, downloadarr uses spotify first and deezer as a fallback.
to use spotify, create an app in the spotify developer dashboard (Web API), then::

cp .env.example .env
nano .envv

installation

downloadarr is now a docker app with a web interface for easier setups on home servers!

0. install docker

1. clone the repo

git clone https://github.com/divpreeet/downloadarr.git

cd downloadarr/

2. create a .env file (optional, only if using spotify)

cp .env.example .env
nano .envv

then enter your spotify id + secret.

3. configure ports / volumes (optional)

edit docker-compose.yml to change the port or mount a custom music folder:

ports:
  -  "8000:8000"

volumes:
  -  /path/to/your/music:/app/music

make sure you update MUSIC_DIR too.

4. run

sudo docker-compose up -d --build

then open:

http://localhost:8000/

notes

  • changing env vars in .env only needs a restart, not a rebuild.
  • overwrite is not available yet (coming soon).