a mac-first fork of fastpotify: native, lightweight spotify client built with rust, egui, and librespot. zero chromium, instant startup, minimal memory footprint, and dialed in for macos.
playing needs spotify premium. spotify only lets premium accounts play music through another app, here or on any other device. with a free account snoop browses your library fine but cannot play it, and says so once at sign-in.
- unified transparent titlebar: fullsize content view with native traffic light controls cleanly integrated into the sidebar header
- now playing everywhere: media keys, control centre, the lock screen, and the airpods pinch all drive snoop, cover art included
- dracula by default: ships the open-source dracula palette, with upstream's
spotifygreen a click away. drop a.tomlin the themes folder for your own, including dracula pro if you own it - macos shortcuts: native
⌘keybindings everywhere, including⌘[/⌘]for page history navigation - zero electron bloat: starts in under a second and stays tiny in memory while playing gapless 320 kbps audio
- nix flake + direnv: reproducible dev environment out of the box
measured on macos (apple silicon) during active playback:
| metric | snoop | official spotify client | difference |
|---|---|---|---|
| resident memory (rss) | ~255 mb | ~1,515 mb (~1.5 gb) | ~6x less |
| physical footprint | ~320 mb | ~811 mb | ~2.5x less |
| processes | 1 native binary | 7 (cef main + helpers) | 7x fewer |
| threads | ~35 | ~153 | ~4.4x fewer |
regular spotify runs multiple chromium helper processes for rendering, audio, network, and crash handling. snoop runs ui and audio in a single lightweight rust process with zero webview overhead.
- plays music locally: acts as a native spotify connect receiver, gapless playback up to 320 kbps with optional normalization and audio cache
- controls your devices: switch playback between speakers, phones, and computers directly from the device picker
- lan speaker discovery: finds local librespot / spotifyd instances over mdns and connects them to your account
- full library & search: playlists, liked songs, albums, artists, podcasts, and unified search. sidebar rows pin to the top and drag into your own order
- queue management: queue side panel or dedicated full page, reorder and add from any row menu
- lyrics panel: synchronized and unsynchronized lyrics following playback
- album art tinting: surfaces dynamically take a subtle tint from the active album cover
- dual web api sessions: personal and shared spotify apps run side by side for maximum quota
- drag and drop: reorder sidebar playlists and drag songs onto playlists
- window persistence: remembers size, position, zoom, and sidebar state across restarts
with nix and direnv:
direnv allow
cargo runor build with cargo directly:
cargo run --releasemilkdrop is on by default and pulls in libprojectm, which cmake builds from source during cargo build, so you need cmake, a c++ compiler, and libclang. the nix devshell has all three. to build without it, add --no-default-features.
to build a real Snoop.app (macos routes media keys, control centre, and the lock screen only to bundled apps, so cargo run does not get them):
cargo build --release
packaging/macos/bundle.sh target/release/snoop Snoop.app 0.6.0the bundle is ad-hoc signed by default. set CODESIGN_IDENTITY to a developer id to sign it for distribution.
titles in a script inter does not cover (chinese, japanese, korean, arabic,
hebrew, thai, the indic scripts and a dozen more) are drawn with a face
borrowed from the system, nothing is bundled. macos ships faces for the
common ones. on linux install the matching noto families, for example
noto-fonts and noto-fonts-cjk, or those titles stay empty boxes.
to run with sample demo data (no spotify login needed):
cargo run --features demo -- --demo --demo-page playlist:pl1 --demo-show queueon linux, snoop is an mpris player, so playerctl --player=snoop play-pause already works.
macos and windows have no such bus, so the same verbs are subcommands. they talk to the instance already running and print nothing on success:
snoop play-pause snoop volume 40
snoop play snoop volume-up [percent]
snoop pause snoop volume-down [percent]
snoop next snoop mute
snoop previous snoop shuffle [on|off]
snoop seek 15 snoop repeat [off|context|track]
snoop seek -- -15 snoop like
snoop seek-to 90 snoop play-uri spotify:playlist:37i9…
snoop show snoop transfer <device-id>
snoop now-playing [--raw] snoop devices [--raw]
shuffle and repeat toggle when called bare and set the state outright when given an argument. like saves the playing track to your library, or removes it.
now-playing prints one readable line; --raw prints the fields tab-separated (state, title, artists, album, position_ms, duration_ms, volume, shuffle, repeat, art_url, saved, device) for scripts. devices lists spotify connect devices, the active one marked with *; --raw prints json. a verb exits non-zero when snoop is not running.
that is enough for a launcher such as raycast or alfred to drive playback through its own script commands. the stream deck plugin speaks the same channel.
two schemes ship: dracula (the open-source one, default) and spotify (upstream's green). anything else is a file:
~/Library/Application Support/com.dappermint.snoop/themes/<name>.toml
the format is the flat half of an alacritty colour config, one key = "#rrggbb" per line, with # comments outside quotes and [section] headers skipped. the key names are snoop's own (listed below), not alacritty's. every key you leave out keeps its built-in value, so a one-line file is a valid theme:
dark = true
accent = "#9580ff" # comments work outside the quotes
window = "#22212c"keys: dark, window, panel, surface, surface_hover, surface_active, outline, text, secondary, dim, accent, accent_hover, on_accent, danger, warning, overlay, shadow. colours take #rrggbb, #rrggbbaa, 0xrrggbb, or bare hex. new files appear in settings after a restart; a broken one falls back to the default and says why in the log.
this is how to run dracula pro if you own a licence, without the repository shipping a paid palette.
configuration lives in ~/Library/Application Support/com.dappermint.snoop/settings.json on macos: connect device name, bitrate, normalization, theme, sidebar state, and audio cache size. caches live under ~/Library/Caches/com.dappermint.snoop and can be wiped anytime without losing your session.
forked from crmne/fastpotify. stands on librespot, egui, dracula (mit), inter, and lucide icons.
read CONTRIBUTING.md before opening an issue or pull request.
snoop is an independent project and is not affiliated with Spotify AB.
licensed under MIT.