Fedora Spicetify Manager

Fedora Spicetify Manager is a small modern terminal helper for using Spicetify with Spotify Flatpak on Fedora, RHEL and CentOS based Linux systems.

It was created to make the common Spotify Flatpak + Spicetify setup easier, especially when Spicetify settings are lost after Spotify or Flatpak updates.

The tool provides an interactive terminal menu, direct commands, automatic path configuration, Flatpak permission handling, update helpers, status checks and an autostart mode.

---

Preview

╭────────────────────────────────────────────────────╮
│              Fedora Spicetify Manager              │
│              Spotify Flatpak + Spicetify           │
│                                                    │
│             Projekt GitHub @equestrian98           │
╰────────────────────────────────────────────────────╯

Menü
Mit ↑/↓ auswählen, Enter bestätigen, q beendet.

  > Spicetify reparieren
    Spotify starten
    Spotify beenden
    Spotify neu starten
    Spotify + Spicetify updaten
    Spicetify apply
    Backup / Apply intelligent
    Status anzeigen
    Autostart-Fix testen
    Hilfe
    Beenden

---

Features

• Modern interactive terminal menu
• Arrow key navigation
• Direct CLI commands
• Spotify Flatpak start, stop and restart
• Spicetify repair/fix command
• Automatic Spotify Flatpak path configuration
• Automatic Spicetify prefs_path configuration
• Intelligent backup/apply handling
• Visible Flatpak update output
• GNOME autostart mode without sudo prompts
• Status overview
• Designed for Fedora, RHEL and CentOS based systems

---

Supported systems

Tested mainly on:

• Fedora Workstation
• Spotify Flatpak
• GNOME Terminal
• zsh
• bash

Should also work on:

• RHEL based systems
• CentOS based systems
• other Linux systems using Spotify Flatpak

---

Requirements

You need:

• Linux
• Flatpak
• Spotify installed as Flatpak
• Spicetify CLI
• bash
• curl

---

Install Spotify Flatpak

Install Spotify from Flathub:

flatpak install flathub com.spotify.Client

Start Spotify once so the preferences file is created:

flatpak run com.spotify.Client

Then close Spotify.

---

Install Spicetify

Install Spicetify CLI:

curl -fsSL https://raw.githubusercontent.com/spicetify/cli/main/install.sh | sh

During installation you can also install the Spicetify Marketplace if asked.

After installation, make sure Spicetify is available:

spicetify -v

If the command is not found, open a new terminal or add Spicetify to your PATH:

export PATH="$HOME/.spicetify:$PATH"

---

Quick install

Install Fedora Spicetify Manager with:

curl -fsSL https://raw.githubusercontent.com/equestrian98/fedora-spicetify-manager/main/install.sh | bash

After installation, open a new terminal or run:

source ~/.zshrc

For bash users:

source ~/.bashrc

Then start the manager:

spice

---

Manual installation

Clone the repository:

git clone https://github.com/equestrian98/fedora-spicetify-manager.git
cd fedora-spicetify-manager

Make the installer executable:

chmod +x install.sh

Run the installer:

./install.sh

After installation, open a new terminal or run:

source ~/.zshrc

or:

source ~/.bashrc

Start the manager:

spice

---

Usage

Open the interactive menu:

spice

You can navigate the menu with the arrow keys and confirm with Enter.

Press q to quit the menu.

---

Direct commands

You can also use direct commands without opening the menu:

spice fix
spice start
spice stop
spice restart
spice update
spice apply
spice backup
spice status
spice autostart
spice help

---

Command overview

Command	Description
spice	Opens the interactive terminal menu
spice fix	Repairs and reapplies Spicetify for Spotify Flatpak
spice start	Starts Spotify Flatpak
spice stop	Stops Spotify
spice restart	Restarts Spotify
spice update	Updates Spotify Flatpak and reapplies Spicetify
spice apply	Runs spicetify apply
spice backup	Runs intelligent backup/apply handling
spice status	Shows Spotify, Spicetify and path status
spice autostart	Applies Spicetify without sudo for GNOME autostart
spice help	Shows help information

---

First run

After installing everything, run:

spice fix

This will:

• check if Spotify Flatpak exists
• check if the Spotify prefs file exists
• set the correct Spicetify prefs_path
• set the correct Spotify Flatpak spotify_path
• enable CSS injection
• enable color replacement
• enable the Marketplace custom app
• set the Marketplace theme
• set Flatpak app permissions
• run spicetify apply

You may be asked for your sudo password because Spotify Flatpak app files are stored system-wide under /var/lib/flatpak.

---

Autostart

The installer creates a GNOME autostart file:

~/.config/autostart/spicetify-fix.desktop

It runs:

spice autostart

The autostart mode does not use sudo.

This is important because sudo password prompts should not appear invisibly during login.

---

Default paths

Spotify Flatpak preferences file:

~/.var/app/com.spotify.Client/config/spotify/prefs

Spotify Flatpak application path:

/var/lib/flatpak/app/com.spotify.Client/x86_64/stable/active/files/extra/share/spotify

Spicetify binary path:

~/.spicetify/spicetify

Installed manager command:

~/.local/bin/spice

Autostart file:

~/.config/autostart/spicetify-fix.desktop

---

Why is this needed?

Spotify installed through Flatpak stores its files and preferences in different locations than traditional native package installations.

Spicetify sometimes cannot automatically detect these paths.

Also, Spotify or Flatpak updates can overwrite Spicetify changes.

This tool helps by setting the correct paths and reapplying Spicetify quickly.

---

Troubleshooting

spice: command not found

Make sure ~/.local/bin is in your PATH:

export PATH="$HOME/.local/bin:$HOME/.spicetify:$PATH"

To make it permanent for zsh:

echo 'export PATH="$HOME/.local/bin:$HOME/.spicetify:$PATH"' >> ~/.zshrc
source ~/.zshrc

For bash:

echo 'export PATH="$HOME/.local/bin:$HOME/.spicetify:$PATH"' >> ~/.bashrc
source ~/.bashrc

---

Spotify prefs file not found

Start Spotify once:

flatpak run com.spotify.Client

Then close Spotify and run:

spice fix

---

Spicetify settings are gone after update

Run:

spice fix

or:

spice update

---

Permission denied while applying Spicetify

Run:

spice fix

The fix command sets the required permissions for the Spotify Flatpak application path.

---

Backup already exists

This can happen with:

spicetify backup apply

Fedora Spicetify Manager handles this with:

spice backup

If a backup already exists, it will use spicetify apply instead.

---

Update seems to hang

The update command shows Flatpak output directly.

Use:

spice update

If Flatpak is waiting for something, you should see the output in the terminal.

---

Uninstall

Remove the manager command:

rm -f ~/.local/bin/spice

Remove the autostart file:

rm -f ~/.config/autostart/spicetify-fix.desktop

Optional: remove this PATH line from ~/.zshrc or ~/.bashrc:

export PATH="$HOME/.local/bin:$HOME/.spicetify:$PATH"

---

Repository structure

fedora-spicetify-manager/
├── README.md
├── install.sh
├── spice
├── LICENSE
└── .gitignore

---

Spotify Flatpak display/window title fix on Fedora

Some Fedora users may notice display issues with the Spotify Flatpak version, especially on Wayland.

Typical issues can be:

• broken or weird window title behavior
• broken title bar / header bar display
• UI rendering glitches
• strange window controls
• Spotify looking different or buggy compared to X11

This can happen because Spotify/Electron may not behave correctly on Wayland on some Fedora systems.

A common workaround is to force the Spotify Flatpak app to use X11 instead of Wayland.

Apply the fix

Run:

flatpak override --user \
  --nosocket=wayland \
  --socket=x11 \
  --env=ELECTRON_OZONE_PLATFORM_HINT=x11 \
  com.spotify.Client

Then close Spotify completely and start it again:

flatpak run com.spotify.Client

Check if the fix is active

You can check the current Flatpak override with:

flatpak override --user --show com.spotify.Client

If the fix is active, you should see something like:

[Context]
sockets=!fallback-x11;!wayland;x11;

[Environment]
ELECTRON_OZONE_PLATFORM_HINT=x11

Is this permanent?

Yes.

The command uses:

flatpak override --user

This writes the setting permanently to your user-specific Flatpak overrides.

Spotify will continue to start with:

!wayland
x11
ELECTRON_OZONE_PLATFORM_HINT=x11

even after a reboot.

Reset the fix

If you want to remove this override later, run:

flatpak override --user --reset com.spotify.Client

Then Spotify will use the default Flatpak permissions again.

Notes

This fix only affects Spotify for your current user account.

It does not change system-wide Flatpak settings and does not affect other Flatpak apps.

---

Disclaimer

This project is not affiliated with Spotify, Spicetify, Fedora, Red Hat, CentOS, Flatpak, GNOME or Spotify AB.

This is only a convenience helper script.

Use at your own risk.

---

License

This project is licensed under the Creative Commons Attribution-NonCommercial 4.0 International License.

You may use, share and modify this project for non-commercial purposes.

Commercial use is not permitted.

See the LICENSE file for details.