-
Notifications
You must be signed in to change notification settings - Fork 0
Installation
This page covers everything you need to get Dotify installed and its external dependencies ready.
| Requirement | Version |
|---|---|
| Python | 3.10 or newer |
| pip | Latest recommended |
Windows: Download from ffmpeg.org, extract, and add the bin/ folder to your system PATH.
macOS:
brew install ffmpeg
Linux (Debian/Ubuntu):
sudo apt install ffmpeg
Windows: Download from aria2.github.io and add to PATH.
macOS:
brew install aria2
Linux:
sudo apt install aria2
Only needed if you plan to download music videos or video podcasts.
After installing Dotify and its dependencies, run the environment doctor:
dotify env setup
dotify env doctor
dotify env doctor checks for all required and optional binaries and reports their status. Fix any issues before proceeding.
- Environment-Setup — Configure your Dotify environment
- Authentication — Set up Spotify cookies and Widevine key for Premium quality
This page covers everything you need to get Dotify installed and its external dependencies ready.
| Requirement | Version |
|---|---|
| Python | 3.10 or newer |
| pip | Latest recommended |
Verify your Python version:
python --versionDotify is published to PyPI as dotify-cli:
pip install dotify-cli --upgradeAfter installing, verify the CLI is available:
dotify --versionIf the
dotifycommand is not found after install, see Troubleshooting.
Dotify relies on external binaries for media processing, downloading, and DRM decryption. Install them and ensure each is accessible in your system PATH.
| Tool | Required? | Purpose |
|---|---|---|
| [FFmpeg](https://ffmpeg.org/download.html) | ✅ Required | Remux audio streams, embed metadata and cover art |
| [Aria2](https://aria2.github.io/) | ⭐ Recommended | Multi-connection parallel downloads (much faster) |
| [MP4Box (GPAC)](https://gpac.wp.imt.fr/mp4box/) | 🎬 Video only | Mux decrypted audio + video into a single .mp4
|
| [mp4decrypt (Bento4)](https://www.bento4.com/downloads/) | 🎬 Video only | Decrypt DRM-protected video streams |
Windows: Download from [ffmpeg.org](https://ffmpeg.org/download.html), extract, and add the bin/ folder to your system PATH.
macOS:
brew install ffmpegLinux (Debian/Ubuntu):
sudo apt install ffmpegWindows: Download from [aria2.github.io](https://aria2.github.io/) and add to PATH.
macOS:
brew install aria2Linux:
sudo apt install aria2Only needed if you plan to download music videos or video podcasts.
- MP4Box: Download [GPAC](https://gpac.wp.imt.fr/downloads/) and install.
-
mp4decrypt: Download [Bento4](https://www.bento4.com/downloads/), extract, and add to
PATH.
After installing Dotify and its dependencies, run the environment doctor:
dotify env setup
dotify env doctordotify env doctor checks for all required and optional binaries and reports their status. Fix any issues before proceeding.
- Environment-Setup — Configure your Dotify environment
- Authentication — Set up Spotify cookies and Widevine key for Premium quality