Troubleshooting & FAQ

Encountering an issue? Check here for solutions to common problems.

Error: 401 Unauthorized or 403 Forbidden

• Problem: Your Spotify session has expired.
• Solution: Your cookies.txt file is out of date. Re-export your cookies from your browser and replace the old file.

Error: FFmpeg not found

• Problem: Dotify cannot find the ffmpeg executable.
• Solution: Ensure you have installed FFmpeg and that its location is included in your system's PATH environment variable. See the Installation guide for details.

AAC Song or Video Downloads Fail / Are Garbled

• Problem: This is almost always an issue with your .wvd file.
• Solution:
  1. Ensure the file is named device.wvd and is in the correct directory, or you are pointing to it with --wvd-path.
  2. Your .wvd file might be invalid or from an unsupported source (like an emulator). Try re-extracting it from a physical Android device using KeyDive.

FAQ: Can Spotify ban my account for this?

• Answer: Using third-party tools to download content is against Spotify's Terms of Service. While not guaranteed, there is always a risk that your account could be suspended. Use Dotify at your own risk.

FAQ: Why is the download speed slow?

• Answer: By default, Dotify uses a downloader that processes one chunk at a time. For faster speeds on songs and podcasts, try installing aria2c and using the --download-mode aria2c flag.

Still having trouble? Please open an issue on GitHub with a detailed description of the problem and the logs from the console.