-
Notifications
You must be signed in to change notification settings - Fork 4
Home
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"
- 🎵 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 —
.lrcfiles 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
pip install dotify-cli --upgrade
Requires Python 3.10+. See the Installation page for full setup including external dependencies.
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.
| 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 |
⭐ 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"- 🎵 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 —
.lrcfiles 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
pip install dotify-cli --upgradeRequires Python 3.10+. See the Installation page for full setup including external dependencies.
# 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.
| 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 |
- [PyPI — dotify-cli](https://pypi.org/project/dotify-cli/)
- [GitHub Repository](https://github.com/AsHfIEXE/Dotify)
- [Report a Bug](https://github.com/AsHfIEXE/Dotify/issues)
- [Releases & Changelog](https://github.com/AsHfIEXE/Dotify/releases)
⭐ If Dotify saves you time, please consider giving the repo a star!