Skip to content

Troubleshooting / FAQ Guide¤

As common issues or questions are encountered solutions will be added to this guide.

'spotdl' is not recognized

Python/(site packages) is not added to PATH correctly. You need to install Python from

Or you are using python from microsoft store. If so uninstall it and restart cmd. If this doesn't work reinstall python.

Error message¤

'spotdl' is not recognized as an internal or external command,
operable program or batch file.


Ensure to add to PATH when installing: python install

spotdl: command not found

If you see this error after installing spotdl, that means that the bin (Binaries) folder is not on $PATH



Add export PATH=~/.local/bin:$PATH at the bottom of ~/.bashrc

Then run source ~/.bashrc


Add export PATH=~/.local/bin:$PATH at the bottom of ~/.zshrc Then run source ~/.zshrc


Sometimes not all packages are installed but are required by yt-dlp for example: brotli or websockets

Error Message¤

pkg_resources.DistributionNotFound: The 'websockets' distribution was not found and is required by yt-dlp


pip install brotli websockets yt-dlp -U

HTTP Error 404

Error Message¤

HTTP Error for GET to URL with Params: {} returned 404 due to None


Update spotdl to the latest version which contains workaround.

pip install -U spotdl


Error Message¤

urllib.error.URLError: <urlopen error [SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed (_ssl.c:847)>



Error Message¤

RecursionError: maximum recursion depth exceeded


Update spotdl

pip install spotdl -U


This happens when running spotdl using python -m.

Error Message¤

RuntimeWarning: 'spotdl.__main__' found in sys.modules after import of package 'spotdl',
but prior to execution of 'spotdl.__main__'; this may result in unpredictable behaviour


You can ignore this error or just run spotdl directly

Not found ''

This error is specific for M1 Macs only.

Error Message¤

aise OSError("Cannot load native module '%s': %s" % (name, ", ".join(attempts)))
OSError: Cannot load native module 'Cryptodome.Cipher._raw_ecb': Not found '',
Cannot load '': dlopen(/opt/homebrew/lib/python3.9/site-packages/Cryptodome/Util/../Cipher/, 6): no suitable image found.  Did find:
/opt/homebrew/lib/python3.9/site-packages/Cryptodome/Util/../Cipher/ mach-o, but wrong architecture
/opt/homebrew/lib/python3.9/site-packages/Cryptodome/Cipher/ mach-o, but wrong architecture, Not found ''


Possible solutions: