starred/spotix
1
0
Fork 0
mirror of https://github.com/skyline69/spotix.git synced 2026-04-26 07:55:56 +03:00
Code Issues Projects Releases 1 Packages Wiki Activity
A fast, native Spotify client written in Rust - a fork of psst focused on a lightweight, Electron‑free desktop experience.
81 commits 2 branches 1 tag 7.1 MiB
Find a file
Exact
Ö. Efe D. f156614ce5 docs: add agent files
2026-03-16 19:21:17 +01:00
.github ci: run release builds only on release branch 2026-03-15 16:34:44 +01:00
.homebrew initial commit 2025-12-18 16:33:54 +01:00
.pkg feat: rename binary to 'spotix' + auto-install desktop integration 2026-03-15 22:55:11 +01:00
assets feature: add icons and improve readme 2025-12-21 19:40:26 +01:00
librespot-playback-patch fix: patch librespot-playback to self-heal corrupted cached audio 2026-03-15 20:38:30 +01:00
rspotify-model-patch fix: patch rspotify-model to handle missing available_markets 2026-03-15 19:11:56 +01:00
spotix-core perf: instant pause/resume UI response for librespot engine 2026-03-15 20:29:03 +01:00
spotix-gui feat: rename binary to 'spotix' + auto-install desktop integration 2026-03-15 22:55:11 +01:00
vendor/wrapped-vec Add theme TOML support, fix Windows handle use, patch wrapped-vec warning 2025-12-18 17:11:18 +01:00
.gitignore feature: add librespot playback and oauth webapi support 2026-03-15 16:22:30 +01:00
AGENTS.md docs: add agent files 2026-03-16 19:21:17 +01:00
Cargo.lock fix: pin vergen-lib to fix cargo install build failure 2026-03-15 23:02:54 +01:00
Cargo.toml chore: remove unused spotix-cli project 2026-03-15 22:39:59 +01:00
CLAUDE.md docs: add agent files 2026-03-16 19:21:17 +01:00
Cross.toml initial commit 2025-12-18 16:33:54 +01:00
LICENSE.md initial commit 2025-12-18 16:33:54 +01:00
README.md fix: pin vergen-lib to fix cargo install build failure 2026-03-15 23:02:54 +01:00

README.md

Spotix logo

Spotix

Fast, native Spotify client written in Rust — low overhead, clean UI, lightweight runtime (no Electron).

Latest Release • Issues

image image

Fork notice

Additional features over upstream psst

  • Theme support with TOML themes (including custom colors and lyric highlighting)
  • Spotify-style default dark theme with bundled Spotify Mix fonts
  • Configurable cache size limit and cache usage display in preferences
  • Playlist pagination toggle and real-time library search (playlists, albums, tracks, podcasts, albums)
  • Saved playback state restoration (resume last track/position) and improved lyrics view (highlight, focus, auto-scroll)
  • More fluid seek bar, bottom-bar cover click opens album, and platform release binaries
  • More up-to-date dependencies and ongoing maintenance on the fork
  • Automatic retry for transient network timeouts and throttling
  • Built-in 10-band equalizer with presets and custom tuning
  • Multi-select playlist mode with select all and bulk remove actions

Status

  • Early development; expect missing features and rough edges
  • Requires a Spotify Premium account

Download

GitHub Actions build and publish releases when changes land on main. Grab the latest installers from the Releases page.

Platform Download Link
Linux (x86_64) Download
Linux (aarch64) Download
Debian Package (amd64) Download
Debian Package (arm64) Download
macOS Download
Windows Download

Build

  • Rust stable (1.65.0 or newer)

Linux dependencies

  • Debian/Ubuntu: sudo apt-get install libssl-dev libgtk-3-dev libcairo2-dev libasound2-dev
  • RHEL/Fedora: sudo dnf install openssl-devel gtk3-devel cairo-devel alsa-lib-devel

OpenBSD (WIP)

doas pkg_add gtk+3 cairo llvm
export LIBCLANG_PATH=/usr/local/lib

If you hit rustc memory errors while building gtk:

ulimit -d $(( 2 * `ulimit -d` ))

Install from source

cargo install --locked --path spotix-gui
# This installs the `spotix` binary to ~/.cargo/bin/.
# On Linux, the app auto-installs its .desktop file and icons on first run,
# so it will appear in your application launcher.
# --locked ensures the pinned dependency versions are used.

Build from source

cargo build
# Add --release for release builds.

Run from source

cargo run --bin spotix
# Add --release for release builds.

Build app bundle (macOS)

cargo install cargo-bundle
cargo bundle --release

Cool Features compared to psst

Equalizer with all the Spotify presets

image image

Crossfade

image

Autoplay using Spotify's algorithm

image

Full Caching support for maximum performance!

image

And some more

  • Up to date dependencies
  • Clean codebase
  • and much more...

Built-in Themes

Gruvbox Dark

image

Dracula

image

Kanagawa

image

Any many more!

image

Theming

  • Place TOML theme files in ~/.config/Spotix/themes/.
  • Spotix ships with multiple preset themes that auto-install into that folder on first run.
  • Each theme file must include a name field (e.g. name = "catppuccin") and color keys. Example:
name = "catppuccin"
base = "dark"

[colors]
grey_000 = "#cdd6f4"
grey_100 = "#bac2de"
grey_200 = "#a6adc8"
grey_300 = "#585b70"
grey_400 = "#45475a"
grey_500 = "#313244"
grey_600 = "#181825"
grey_700 = "#1e1e2e"
blue_100 = "#a6e3a1"
blue_200 = "#89b4fa"
red = "#f38ba8"
link_hot = "#ffffff14"
link_active = "#ffffff0f"
link_cold = "#00000000"
lyric_highlight = "#cba6f7"
lyric_past = "#6c7086"
lyric_hover = "#cdd6f4"
playback_toggle_bg_active = "#a6e3a1"
playback_toggle_bg_inactive = "#313244"
playback_toggle_fg_active = "#1e1e2e"
icon_color = "#8e95b4"
icon_color_muted = "#6c7086"
media_control_icon = "#cdd6f4"
media_control_icon_muted = "#a6adc8"
media_control_border = "#585b70"
status_text_color = "#bac2de"
  • Select themes in Settings → General. Custom themes are listed by their name.

Project layout

  • /spotix-core core library (session, decoding, playback)
  • /spotix-gui GUI app (Druid) — binary name: spotix

Privacy

Spotix connects only to official Spotify servers. Credentials are not stored; a reusable token is used instead. Cached data is stored locally and can be deleted at any time.

Credits