Skip to content
Salehin Ashfi edited this page Jun 2, 2026 · 4 revisions

Dotify 🎵

The ultimate command-line tool for downloading anything from Spotify — songs, albums, playlists, artist discographies, podcasts, music videos, and synced lyrics — directly to your machine.

Dotify (dotify-cli) is a self-aware, open-source Python CLI that downloads Spotify content with full metadata, embedded cover art, and support for lossless FLAC, 24-bit FLAC, and high-quality AAC 256kbps audio via Spotify Premium.

pip install dotify-cli --upgrade
dotify env setup
dotify "https://open.spotify.com/track/4cOdK2wGLETKBW3PvgPWqT"

✨ Features

  • 🎵 Songs — AAC 128kbps (free) · AAC 256kbps · FLAC · 24-bit FLAC (Premium)
  • 💿 Albums & Playlists — Full collection downloads with proper folder structure
  • 👤 Artist Discography — Download everything from an artist in one command
  • 🎙️ Podcasts & Episodes — Audio and video podcast support
  • 🎬 Music Videos — Up to 1080p with synced audio/video muxing
  • 📝 Synced Lyrics.lrc files for your entire library
  • 🏷️ Rich Metadata — Cover art, artist, album, track number, release date embedded automatically
  • Fast Downloads — Parallel multi-connection downloads via Aria2c
  • 🛠️ Environment Doctor — Built-in setup wizard and dependency checker

📦 Install

pip install dotify-cli --upgrade

Requires Python 3.10+. See the Installation page for full setup including external dependencies.


🚀 Quick Start


1. Install

pip install dotify-cli --upgrade

2. Set up environment

dotify env setup

3. Verify everything is ready

dotify env doctor

4. Download something

dotify "https://open.spotify.com/track/..."

For Premium quality (FLAC / AAC 256kbps), you'll also need cookies and a Widevine key. See Authentication.


📖 Wiki Pages

Page Description
Installation pip install, Python requirements, external tools
Environment-Setup dotify env setup, dotify env doctor, v1→v2 migration
Authentication Spotify cookies, Widevine .wvd via KeyDive
Basic-Usage Tracks, albums, playlists, artists, batch downloads
Advanced-Usage Templates, quality flags, video, lyrics-only mode
Audio-Quality-Reference All format strings, FLAC/AAC/Vorbis tiers, priority examples
Configuration Full config.json reference and priority rules
Dependencies-Explained FFmpeg, Aria2c, mp4decrypt, MP4Box, WVD/KeyDive
Troubleshooting Common errors, env doctor failures, FAQ
Contributing Bug reports, pull requests, contact

🔗 Links


⭐ If Dotify saves you time, please consider giving the repo a star!

# Dotify 🎵

The ultimate command-line tool for downloading anything from Spotify — songs, albums, playlists, artist discographies, podcasts, music videos, and synced lyrics — directly to your machine.

Dotify (dotify-cli) is a self-aware, open-source Python CLI that downloads Spotify content with full metadata, embedded cover art, and support for lossless FLAC, 24-bit FLAC, and high-quality AAC 256kbps audio via Spotify Premium.

pip install dotify-cli --upgrade
dotify env setup
dotify "https://open.spotify.com/track/4cOdK2wGLETKBW3PvgPWqT"

✨ Features

  • 🎵 Songs — AAC 128kbps (free) · AAC 256kbps · FLAC · 24-bit FLAC (Premium)
  • 💿 Albums & Playlists — Full collection downloads with proper folder structure
  • 👤 Artist Discography — Download everything from an artist in one command
  • 🎙️ Podcasts & Episodes — Audio and video podcast support
  • 🎬 Music Videos — Up to 1080p with synced audio/video muxing
  • 📝 Synced Lyrics.lrc files for your entire library
  • 🏷️ Rich Metadata — Cover art, artist, album, track number, release date embedded automatically
  • Fast Downloads — Parallel multi-connection downloads via Aria2c
  • 🛠️ Environment Doctor — Built-in setup wizard and dependency checker

📦 Install

pip install dotify-cli --upgrade

Requires Python 3.10+. See the Installation page for full setup including external dependencies.


🚀 Quick Start

# 1. Install
pip install dotify-cli --upgrade

# 2. Set up environment
dotify env setup

# 3. Verify everything is ready
dotify env doctor

# 4. Download something
dotify "https://open.spotify.com/track/..."

For Premium quality (FLAC / AAC 256kbps), you'll also need cookies and a Widevine key. See Authentication.


📖 Wiki Pages

Page Description
Installation pip install, Python requirements, external tools
Environment-Setup dotify env setup, dotify env doctor, v1→v2 migration
Authentication Spotify cookies, Widevine .wvd via KeyDive
Basic-Usage Tracks, albums, playlists, artists, batch downloads
Advanced-Usage Templates, quality flags, video, lyrics-only mode
Audio-Quality-Reference All format strings, FLAC/AAC/Vorbis tiers, priority examples
Configuration Full config.json reference and priority rules
Dependencies-Explained FFmpeg, Aria2c, mp4decrypt, MP4Box, WVD/KeyDive
Troubleshooting Common errors, env doctor failures, FAQ
Contributing Bug reports, pull requests, contact

🔗 Links


⭐ If Dotify saves you time, please consider giving the repo a star!

Clone this wiki locally