downtify

downtify

Docker app from athuull's Repository

Downtify is an open-source music downloader backend powered by FastAPI, yt-dlp, and ffmpeg.

Overview
Downtify is an open-source music downloader backend powered by FastAPI, yt-dlp, and ffmpeg. It provides an automated download engine and queue management for companion clients like Hera.

Downtify

Paste a link. Get the music.

A self-hosted music downloader with a player built in. Paste a Spotify, YouTube Music, Deezer or SoundCloud link and get a perfectly tagged library, ready to play in your browser, on your phone or in your media server.
No Spotify account, no API keys, no Premium.

Latest release Docker pulls GitHub stars Tests Smokeshow License: AGPL-3.0

Quick start · Features · Documentation · Mobile apps · Changelog · Support

https://github.com/user-attachments/assets/a70b6a0d-fa22-4aa4-b6ca-2491c864c6af

Why Downtify

One link is all it takes

Paste a song, an album, a whole playlist or an artist from Spotify, YouTube Music, Deezer or SoundCloud, or just type what you want to hear. Downtify finds the audio and brings it home.

Files worth keeping

Every file carries its cover art, every credited artist, the album, year, track number and lyrics, time-synced when they exist. MP3, FLAC, M4A, OGG or Opus, or the source audio exactly as it came.

Your own streaming service

A full player in the browser, with synced lyrics, karaoke, a queue, liked songs, playlists and podcasts. Apps for Android and iOS take your library with you, offline too.

Set it and forget it

Watch playlists and artists. New songs and new releases download on their own, on the schedule you choose.

Made for your home server

One Docker image for amd64 and arm64, SQLite or PostgreSQL, accounts for everyone at home with optional single sign-on, and playlists that Jellyfin, Navidrome and Plex pick up.

No strings attached

No Spotify API key, no developer account, no Premium. No ads, no analytics, nothing behind a paywall: Downtify is free and open source.

Quick start

All you need is Docker:

docker run -d -p 8000:8000 --name downtify \
  -v /path/to/music:/downloads \
  -v downtify_data:/data \
  --restart unless-stopped \
  ghcr.io/henriquesebastiao/downtify

Open localhost:8000, sign in as admin / downtify and paste a link. Then change that password in Settings → General (or turn accounts off with DOWNTIFY_DISABLE_AUTH=true on a server only you can reach).

Your music lands in /path/to/music; /data keeps the database and settings. Keep both on persistent storage.

Docker Compose
services:
  downtify:
    container_name: downtify
    image: ghcr.io/henriquesebastiao/downtify:latest
    ports:
      - '8000:8000'
    volumes:
      - ./downloads:/downloads
      - downtify_data:/data
    restart: unless-stopped

volumes:
  downtify_data:

To stay on one release line instead of latest, pin a major, minor or exact version tag (:3, for example). For another port, PostgreSQL, a timezone or a cookies file, see Docker Compose and Environment variables; everything else is set in Settings, inside the app.

Prefer one click? Downtify is in the app stores of Umbrel, CasaOS and HomeDock OS.

A closer look

Downtify's full-screen Now Playing: the album cover, time-synced lyrics with the current line highlighted, and the queue.
Now Playing. Lyrics follow the song, line by line, next to the cover and what's up next.

Downtify's home page: a box to paste a link or search, library statistics, the album you were playing and recently added albums. A playlist page with its own cover, play and share buttons, and its songs with album, format and release date.
Home picks up where you left off. Playlists get their own covers, and can be shared.

Karaoke view: large lyrics filling in as the line is sung, over a moving background in the colors of the cover. The Library page: a grid of album covers with tabs for albums, artists, playlists and tracks.
Karaoke fills each line as it is sung, and opens on a second screen. The Library sorts and filters it all.

Downtify on three phones: the home page, Now Playing and the Library.
On your phone, the same app installs from the browser. Or use the Android and iOS apps.

Features

Find Paste a link or search by name · Discover artists and albums you don't have yet · Deezer's Charts · whole discographies in the Finder · Similar tracks · an artist's top songs · CSV imports from Soundiiz, TuneMyMusic and Exportify · where to buy what you love
Download MP3, FLAC, M4A, OGG or Opus at the bitrate you pick, or the source audio untouched (settings) · YouTube Music first, YouTube as fallback, and optional SoundCloud, Soulseek and Deemix sources · a queue you can pause, that survives a restart
Tags Cover art, every credited artist, album artist, year, track number and the explicit mark · plain and time-synced lyrics from LRCLIB, NetEase and Kugou, embedded and as .lrc · Upgrade library repairs small covers, missing lyrics and incomplete tags in place · Replace audio when a song matched the wrong version
Listen A full-screen player with synced lyrics, karaoke, an editable queue, a sleep timer, keyboard shortcuts, media keys and an experimental ten-band equalizer · volume normalization · liked songs · podcasts by RSS feed, Spotify link or name · installs as an app
Automate The Playlist Monitor keeps Spotify, Deezer and YouTube Music playlists and artists in sync on your schedule, suggests artists to follow, and shows what each watch adds and how much space it takes
Organize Albums, artists, playlists and tracks in the Library · playlists of your own, in any order and with their own cover · hide songs from an imported playlist · bring in music folders and M3U playlists you already have · artist photos · storage & usage · a trash · backups · a Doctor that cleans up after older versions
Share Accounts for everyone at home, with OpenID Connect sign-in · one shared library, with songs, albums or artists an admin can hide · playlists shared view-only or together · an activity log
Connect M3U playlists that Jellyfin, Navidrome and Plex pick up · Navidrome playlist sync and ratings from Deezer · an outbound proxy · PostgreSQL · 13 languages

Every feature has its own page, with every option explained, in the documentation.

How it works

Four steps: paste a link, find the audio on YouTube Music, download and tag it, play it anywhere.

Downtify needs no Spotify API key and never downloads from Spotify. It reads what a link points to from public sources, picks the YouTube Music audio whose length matches best, downloads it with yt-dlp, converts it with ffmpeg and tags it with mutagen, all in one container. YouTube steps in when nothing matches well, and SoundCloud, Soulseek and Deemix join in if you turn them on. The whole pipeline, step by step →

What you can paste

Source What works Example
Spotify Tracks, albums, playlists, artists open.spotify.com/playlist/…
YouTube Music Songs, albums, playlists, artists music.youtube.com/playlist?list=…
YouTube Videos youtube.com/watch?v=…
Deezer Tracks, albums, playlists, artists deezer.com/album/…
SoundCloud Tracks soundcloud.com/artist/track
Search Whatever you would type The Night Owls Do I Still Recall
CSV Library exports Soundiiz, TuneMyMusic, Exportify

An artist link opens the artist's page, with their releases and their most popular songs (Top songs).

FAQ

Do I need a Spotify account, Premium or an API key?

No. Downtify reads track, album and playlist details from Spotify's public embed pages, so it needs no credentials of any kind, and the audio never comes from Spotify. See How it works.

Where does the audio come from, and how good is it?

From YouTube Music by default: the result whose length matches the song best, with YouTube as a fallback. Pick MP3, FLAC, M4A, OGG or Opus at the bitrate you want, or keep the best audio the source has without re-encoding it. Lossless files come from sources you add yourself: your own Soulseek (slskd) server, whose files are kept in their original format, or a Deemix server. See Download settings.

Does it work with Jellyfin, Navidrome or Plex?

Yes. Files are tagged the way media servers expect, filed in Artist/Album/ folders, and every playlist gets a standard M3U file they pick up. Navidrome can also get its playlists synced and ratings set from Deezer. See File organization and M3U export.

Will it run on a Raspberry Pi or a NAS?

The image is built for both amd64 and arm64, and Umbrel, CasaOS and HomeDock OS install it in one click. See Installation.

YouTube says "Sign in to confirm you're not a bot". What now?

Upload a cookies.txt in Settings → YouTube cookies; Downtify then keeps that session signed in on its own. If YouTube still rate-limits you, raise Pause between downloads, lower Parallel downloads, then try DOWNTIFY_FORCE_IPV4=1. See Troubleshooting and YouTube cookies.

Mobile apps

Downtify for Android: Now Playing, the library and synced lyrics on three phones.

Downtify for Android is the official app. It finds your server on the home network, signs in with your account (or pairs with a QR code from Settings → Apps), and streams your library in its original quality on Wi-Fi and a smaller one on mobile data, with songs kept on the phone for offline listening and Android Auto support. It is young and still in testing: get it from GitHub Releases or Obtainium.

Downtify for iOS, built by community member michaelmoskie, brings the library, offline songs and lock-screen controls to iPhone and iPad (iOS 17 or later). The public beta is on TestFlight.

Want to build your own client? Everything goes through the same API: see the mobile client contract.

Documentation

Getting started Installation, Docker Compose, one-click installs and every variable
Features One page per feature, with every option explained
How it works The metadata, matching and tagging pipeline
Troubleshooting Symptoms, causes and fixes
API reference Every endpoint the web app and the mobile apps use
Changelog What changed in each release

The app speaks English, Spanish, Brazilian Portuguese, French, German, Greek, Turkish, Hungarian, Bulgarian, Korean, Russian, and Simplified and Traditional Chinese; the documentation, nearly all of them.

Community

Downtify grows in the open. More than 35 people have contributed code, community translators brought the app to 13 languages, and many features began as an idea someone opened as an issue.

People who contributed to Downtify

Support Downtify

Downtify is free, with no ads and no paid tier, and is maintained by Henrique Sebastião with help from the community. If it has earned a place on your server, there are a few ways to give back:

  • Star the repository. It helps other people find Downtify.
  • Tell someone about it: a friend who self-hosts, your homelab forum, a blog post.
  • Sponsor its development on GitHub Sponsors or Buy Me a Coffee. It helps pay for the time that goes into every release.
Downtify's GitHub stars over time

License

Downtify is free software, licensed under the AGPL-3.0.

[!WARNING] Users are responsible for their actions and any legal consequences. Downtify does not support unauthorized downloading of copyrighted material and takes no responsibility for user actions.

Categories

Download Statistics

124,478
Total Downloads
18,673
This Month
18,673
Avg / Month

Total Downloads Over Time

Loading chart...

Related apps

Links

Details

Repository
henriquesebastiao/downtify:latest
Last Updated2026-10-31
First Seen2026-09-13

Runtime arguments

Web UI
http://[IP]:[PORT:8000]
Network
bridge
Privileged
false

Template configuration

API PortPorttcp

HTTP port for Downtify API

Target
8000
Default
8000
Downloads DirectoryPathrw

Download directory where files will be stored (must match Hera's music download directory)

Target
/downloads
Default
/mnt/user/data/media/music