Skip to content

Commit

Permalink
Update troubleshooting.md
Browse files Browse the repository at this point in the history
  • Loading branch information
xnetcat committed Nov 19, 2022
1 parent c0f8e30 commit 8f7cb2a
Showing 1 changed file with 74 additions and 74 deletions.
148 changes: 74 additions & 74 deletions docs/troubleshooting.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,131 +2,131 @@

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

## 'spotdl' is not recognized
??? "'spotdl' is not recognized"

Python/(site packages) is not added to PATH correctly. You need to install Python from
<https://www.python.org/downloads/>
Python/(site packages) is not added to PATH correctly. You need to install Python from
<https://www.python.org/downloads/>

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

### Error message
### Error message

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

### Solution
### Solution

Ensure to add to PATH when installing: ![python install](https://i.imgur.com/jWq5EnV.png)
Ensure to add to PATH when installing: ![python install](https://i.imgur.com/jWq5EnV.png)

## spotdl: command not found
??? "spotdl: command not found"

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

### Solution
### Solution

#### `.bashrc`
#### `.bashrc`

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

Then run `source ~/.bashrc`
Then run `source ~/.bashrc`

#### `.zshrc`
#### `.zshrc`

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

## pkg_resources.DistributionNotFound
??? "pkg_resources.DistributionNotFound"

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

### Error Message
### Error Message

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

### Solution
### Solution

`pip install brotli websockets yt-dlp -U`
`pip install brotli websockets yt-dlp -U`

## HTTP Error 404
??? "HTTP Error 404"

<https://github.com/plamere/spotipy/issues/795#issuecomment-1100321148>
<https://github.com/plamere/spotipy/issues/795#issuecomment-1100321148>

### Error Message
### Error Message

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

### Solution
### Solution

Update spotdl to the latest version which contains workaround.
Update spotdl to the latest version which contains workaround.

`pip install -U spotdl`
`pip install -U spotdl`

## ssl.SSLError: \[SSL: CERTIFICATE_VERIFY_FAILED\]
??? "ssl.SSLError: \[SSL: CERTIFICATE_VERIFY_FAILED\]"

<https://stackoverflow.com/questions/27835619/urllib-and-ssl-certificate-verify-failed-error>
<https://stackoverflow.com/questions/27835619/urllib-and-ssl-certificate-verify-failed-error>

### Error Message
### Error Message

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

### Solution
### Solution

<https://stackoverflow.com/questions/27835619/urllib-and-ssl-certificate-verify-failed-error>
<https://stackoverflow.com/questions/27835619/urllib-and-ssl-certificate-verify-failed-error>

## RecursionError
??? "RecursionError"

<https://github.com/spotDL/spotify-downloader/issues/1493>
<https://github.com/spotDL/spotify-downloader/issues/1493>

### Error Message
### Error Message

`RecursionError: maximum recursion depth exceeded`
`RecursionError: maximum recursion depth exceeded`

### Solution
### Solution

Update spotdl
Update spotdl

`pip install spotdl -U`
`pip install spotdl -U`

## RuntimeWarning
??? "RuntimeWarning"

This happens when running spotdl using `python -m`.
This happens when running spotdl using `python -m`.

### Error Message
### 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
warn(RuntimeWarning(msg))
```
```
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
warn(RuntimeWarning(msg))
```

### Solution
### Solution

You can ignore this error or just run spotdl directly
You can ignore this error or just run spotdl directly

## Not found '\_raw_ecb.so'
??? "Not found '\_raw_ecb.so'"

This error is specific for M1 Macs only.
This error is specific for M1 Macs only.

https://discord.com/channels/771628785447337985/871006150357823498
https://discord.com/channels/771628785447337985/939475659238043738
https://discord.com/channels/771628785447337985/871006150357823498
https://discord.com/channels/771628785447337985/939475659238043738

### Error Message
### Error Message

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

### Solution
### Solution

Possible solutions:
Possible solutions:

<https://discord.com/channels/771628785447337985/871006150357823498>
<https://discord.com/channels/771628785447337985/939475659238043738>
<https://discord.com/channels/771628785447337985/871006150357823498>
<https://discord.com/channels/771628785447337985/939475659238043738>

0 comments on commit 8f7cb2a

Please sign in to comment.