Spooty is a self-hosted Spotify downloader. It allows download track/playlist/album from the Spotify url. It can also subscribe to a playlist or author page and download new songs upon release. Spooty basically downloads nothing from Spotify, it only gets information from spotify and then finds relevant and downloadeds music on Youtube. The project is based on NestJS and Angular.

• 🚀 Installation
  • Docker
    • Docker command
    • Docker compose
  • Build from source
    • Process
    • Requirements
  • Environment variables
• ⚖️ License

Recommended and the easiest way how to start to use of Spooty is using docker.

This fork does not publish an image to Docker Hub, so build it locally first:

git clone https://github.com/dougchansan/spooty.git
cd spooty
docker build -t spooty .

For detailed configuration, see available environment variables.

docker run -d -p 3000:3000 \
  -v /path/to/downloads:/spooty/backend/downloads \
  -v /path/to/cookies.txt:/spooty/cookies.txt:ro \
  spooty

services:
  spooty:
    image: spooty
    container_name: spooty
    restart: unless-stopped
    ports:
      - "3000:3000"
    volumes:
      - /path/to/downloads:/spooty/backend/downloads
      - /path/to/cookies.txt:/spooty/cookies.txt:ro
    environment:
      # Configure other environment variables if needed
      - DOWNLOAD_CONCURRENCY=2

Spooty can be also build from source files on your own.

• Node v20.20.0 (it is recommended to use nvm node version manager to install proper version of node)
• Redis in memory cache
• Ffmpeg
• Python3

• install Node v20.20.0 using nvm install and use that node version nvm use
• from project root install all dependencies using npm install
• copy .env.default as .env in src/backend folder and modify desired environment properties (see environment variables)
• build source files npm run build
  • built project will be stored in dist folder
• start server npm run start

Some behaviour and settings of Spooty can be configured using environment variables and .env file.

Some downloads are restricted unless the request is authenticated. Spooty passes a cookies file straight to yt-dlp, which expects Netscape format — not the name=value; name=value string used by older versions of these instructions.

1. Install a "cookies.txt" browser extension that exports in Netscape format.
2. Go to https://www.youtube.com and log in if needed.
3. Export the cookies for that domain to a file named cookies.txt.
4. Mount that file into the container at /spooty/cookies.txt, as shown in the Docker examples above.

MIT