name: โ Bug report
description: Report errors or unexpected behavior
labels: โ bug
body:
- type: checkboxes
attributes:
label: ๐ง Before submitting
description: Please read the README, FAQ, TROUBLESHOOTING and check all previous ISSUES because your bug may have already been discussed or reported.
options:
- label: I have read the README
required: true
- label: I have read the FAQ and Troubleshooting guide
required: true
- label: I have checked previous issues, open and closed
required: true
- label: I understand that a valid stock test means testing the exact same Spotify version immediately after a full cleanup/reinstall and before applying SpotX-Bash; testing an older/different version or remembering that Spotify worked previously does not count
required: true
- type: markdown
attributes:
value: |
### Clean stock testing
For bugs where Spotify behaves differently after applying SpotX-Bash, a valid comparison must use the **exact same Spotify version** before and after patching.
Run the automated cleanup from the [Troubleshooting guide](https://github.com/SpotX-Official/SpotX-Bash/wiki/Troubleshooting), reinstall Spotify, test the issue while Spotify is completely stock, then apply SpotX-Bash and test the same issue again.
- type: textarea
id: cleanup_output
attributes:
label: ๐งน Cleanup script Input/Output
description: |
Paste the cleanup command and its complete Terminal output from start to finish. This confirms that Spotify, app data and cache data were removed before the fresh stock test.
If SpotX-Bash fails **before it can patch Spotify** (for example, client/path detection or an installer error), enter `N/A` and explain why a stock-vs-patched test is not applicable.
You may replace your username/home-directory portion of paths with `$HOME`. Do not remove Spotify paths, errors or other information relevant to the issue.
placeholder: |
curl -sSL https://gist.github.com/jetfir3/f620e44fc246c1bed45ed040bbfa2d68/raw/uninstallify.sh | bash
...complete output...
render: shell
validations:
required: true
- type: textarea
id: stock_spotx_test
attributes:
label: ๐งช Fresh stock vs SpotX-Bash test
description: |
Report what happened on the freshly reinstalled, unpatched Spotify client and what happened after applying SpotX-Bash to that **same Spotify version**.
"It worked on stock before," testing a different Spotify version, or testing before the cleanup/reinstall does not establish a stock baseline.
If SpotX-Bash fails before it can patch Spotify, enter `N/A` where appropriate and explain the failure.
value: |
- Fresh stock Spotify version:
- Result on fresh stock:
- Spotify version after applying SpotX-Bash:
- Result after applying SpotX-Bash:
validations:
required: true
- type: markdown
attributes:
value: "###"
- type: input
id: lang_spoti
attributes:
label: Country of your account
description: You can view your country on your account page, under Profile.
placeholder: "e.g. Ukraine"
validations:
required: true
- type: markdown
attributes:
value: "###"
- type: dropdown
id: plan
attributes:
label: What is your Spotify Plan?
description: You can view your plan on your account page, under Manage plan.
options:
- Free
- Premium
validations:
required: true
- type: markdown
attributes:
value: "###"
- type: dropdown
id: spicetify
attributes:
label: Was Spicetify applied during testing?
description: If you use Spicetify, run spicetify restore before establishing the fresh stock baseline.
options:
- "No"
- "No, I ran spicetify restore before testing"
- "Yes"
validations:
required: true
- type: markdown
attributes:
value: "###"
- type: textarea
attributes:
label: โน Computer information
description: |
- Spotify version: e.g. Spotify for macOS (Apple Silicon) 1.2.98.301
- OS: e.g. macOS 15.7 or Ubuntu 24.04 LTS
- Installation type: e.g. official macOS app, DEB, Flatpak, Snap, Nix or spotify-launcher
- CPU architecture: e.g. Apple Silicon or x86_64
- Shell: e.g. bash
- macOS: View the top bar in the Terminal window -- it should display bash, zsh, etc
- Linux: Enter the following command in your terminal window: `echo $0` -- it should display bash, zsh, etc
placeholder: |
- Spotify version:
- OS:
- Installation type:
- CPU architecture:
- Shell:
value: |
- Spotify version:
- OS:
- Installation type:
- CPU architecture:
- Shell:
render: markdown
validations:
required: true
- type: textarea
attributes:
label: ๐ Description
description: List steps to reproduce the error and details on what happens and what you expected to happen.
value: |
1.
2.
3.
...
validations:
required: true
- type: textarea
id: spotx_output
attributes:
label: ๐ฅ๏ธ SpotX-Bash Terminal Input/Output
description: Paste the exact SpotX-Bash command you entered and the complete Terminal output from start to finish. Do not summarize or omit warnings/errors.
render: shell
validations:
required: true
- type: textarea
attributes:
label: ๐ธ Screenshots
description: Optional. Add screenshots or a screen recording if they help demonstrate the issue; they are not required when the behavior can be clearly described in the stock-vs-SpotX test above.
validations:
required: false