spotifast

crmneMIT活跃维护

用 Rust 写的轻量级 Spotify 客户端,把音乐库、本地播放和 Spotify Connect 整合进一个原生桌面应用,支持 Linux、macOS 和 Windows。

Spotify, native and fast. One lightweight Rust app for your whole library, local playback, and Spotify Connect on Linux, macOS, and Windows.

v0.17.1发布于 2026-11-03 17:35 UTC10,147star +262 / 7 天597fork同步于 2026-11-10 23:31 UTC

怎么上手

由 README 提炼,执行前请确认
brew install --cask crmne/tap/spotifast
硬件要求按 README 说明

README 未说明具体硬件要求;支持 Linux、macOS 和 Windows,MilkDrop 不包含在 Windows on ARM 版本中

下载:源码 zip·GitHub Releases(安装包)本站不镜像安装包

项目说明

由 README 自动翻译提炼

用 Rust 写的原生 Spotify 客户端,不依赖浏览器引擎,在桌面端快速管理曲库、本地播放和 Spotify Connect

用 Rust 写的轻量级 Spotify 客户端,把音乐库、本地播放和 Spotify Connect 整合进一个原生桌面应用,支持 Linux、macOS 和 Windows。

核心能力

  • 用 egui 和 fastframe 构建原生界面,不依赖浏览器引擎
  • 通过 Spotify Soloist 或内置 librespot 播放音乐
  • 支持浏览曲库、搜索、编辑歌单和播放本地文件
  • 支持 Spotify Connect 控制其他设备,包括 Google Cast 和 Sonos
  • 内置 Winamp 迷你播放器和 MilkDrop 可视化

容易踩的坑

播放需要 Spotify Premium,免费账户只能浏览和搜索;首次使用需在 Spotify 开发者后台注册应用并填入 Client ID;曲库访问和本地播放需要分别授权

内容由模型根据 README 生成,可能不完整或不准确,以官方文档为准。看原文 README

最近发版

5 个版本v0.17.1
  1. v0.17.1Spotifast v0.17.1最新正式版2026-11-03 · 2026-11-03 17:35 UTC

    Spotifast 0.17.1 opens the mini player in Spotifast Wide on a new install, and takes away a haze that Hyprland drew round skins. If you missed 0.17, it brought Windows Media Player skins that really run, two skins of our own and MilkDrop inside them: see the 0.17.0 notes and the film.

    Download Spotifast: Mac · Windows · Windows ARM · Linux · Linux ARM · Flatpak · AppImage · AppImage ARM

    https://github.com/user-attachments/assets/78bbfddd-decf-4ee5-bfe9-1a7cd2a8fe48

    Changed

    • New installs open the mini player in Spotifast Wide, our own skin. A skin you already chose, the classic one included, stays. By @crmne.

    Fixed

    • No more grey haze round skins on Hyprland. Its blur showed through the see-through part of a skin's window. By @crmne.

    Full changelog: https://github.com/crmne/spotifast/compare/v0.17.0...v0.17.1

  2. v0.17.0Spotifast v0.17.02026-11-03 · 2026-11-03 08:10 UTC
    查看更新说明

    Spotifast 0.17 makes Windows Media Player skins real, and brings two of our own, Spotifast Tall and Spotifast Wide, with MilkDrop in their glass. Skins now run their own scripts, in a sandbox, so their drawers, intro animations, playlists, equalizers and extra windows work the way they did in Windows Media Player. Spotify Soloist has a new setup and clearer Settings, and when it stops, Spotifast now stays usable and brings it back by itself.

    Download Spotifast: Mac · Windows · Windows ARM · Linux · Linux ARM · Flatpak · AppImage · AppImage ARM

    https://github.com/user-attachments/assets/78bbfddd-decf-4ee5-bfe9-1a7cd2a8fe48

    The full-quality film is attached below as spotifast-0.17-skins.mp4.

    Spotifast's own skins with MilkDrop running inside: the Winamp skin with its equalizer, playlist and MilkDrop panel, Spotifast Tall and Spotifast Wide, beside Headspace, Cerulean and Activate, three classic Windows Media Player skins

    New

    • Windows Media Player skins of our own. Spotifast Tall is a small white ceramic ribbon round a smoked-glass core, made to live at the side of your screen. A thread of green light traces it as it opens and burns under its arch while the music plays. The square switches between the album art and MilkDrop, which then fills the glass, and the glass turns to an equalizer or your queue. Spotifast Wide is the same object laid on its side. Pick either in Settings. By @crmne.
    • Windows Media Player skins run as they were made. Their scripts run in a sandbox with no access to your files, the network or other programs. Every view works: drawers, shutters, hidden panels, separate windows, and windows shaped like the skin. Playlist panels show your queue, equalizer panels change Spotifast's equalizer, and visualization areas show the same bars or sound wave as Winamp skins. By @crmne and @davorb.
    • See your skins before you wear them. Settings now shows a picture of every skin, Winamp or Windows Media Player, instead of a row of names. Pictures are drawn in the background and kept, and hundreds of skins scroll smoothly. By @crmne.
    • MilkDrop inside Windows Media Player skins. A skin's visualization area now shows MilkDrop, moving and scaling with the skin, and its next and previous buttons change the preset. It draws in its own process, so the player never waits for it, and goes back to the bars if it can't run. By @crmne.
    • MilkDrop in your Winamp skin's frame. Opened from a classic skin's mini player, MilkDrop is a panel of the player, under the equalizer and the playlist, in the skin's own window frame as it was in Winamp 5, with a title bar, close button and resizing. It moves with the player on every desktop, Wayland included. By @crmne.
    • MilkDrop behind your lyrics. A skin's MilkDrop window or visualization area can now go full screen, into the lyrics view, with MilkDrop behind the words instead of the cover's art. In the main window, V or a click on the empty space does the sa
  3. v0.16.0Spotifast v0.16.02026-11-01 · 2026-11-01 19:54 UTC
    查看更新说明

    Spotifast 0.16 brings Windows Media Player skins, alongside the Winamp ones. Artist pages gain monthly listeners and upcoming releases, Settings shows what your storage holds, and other devices' changes appear as Spotify pushes them. Soloist is also sturdier: it reconnects after a dropped connection, stops when you quit, and a leftover copy no longer blocks the next start.

    Download Spotifast: Mac · Windows · Windows ARM · Linux · Linux ARM · Flatpak · AppImage · AppImage ARM

    New

    • Windows Media Player skins. Spotifast can now wear a Windows Media Player skin as well as a Winamp one. By @davorb. (#1030)
    • See an artist's monthly listeners on their page. By @Espaye. (#1148)
    • Upcoming releases on artist pages, with a countdown to the day they arrive. By @imafreakandyalldontknowit67. (#1129)
    • Sort an album's songs by plays. By @DoWhileGeek. (#1111)
    • See your storage sizes and clear cached audio in Settings. By @dyd4dsh7. (#1113)
    • Copy a song's details from a new submenu in the song menu. By @spinfal. (#1133)
    • Links in a playlist's description are clickable. By @Espaye. (#1150)
    • Other devices' changes appear as Spotify pushes them, without waiting for the next check. By @Espaye. (#902)
    • Clearer top bar for screen readers and keyboards, with focus rings on its controls. By @EnricoNSilva. (#1114)

    Fixed

    • Soloist reconnects after its connection drops, instead of giving up. By @caeksec. (#1160)
    • A Soloist left running no longer blocks the next start. Spotifast stops it first. By @xpepper. (#1158)
    • Cmd+Q stops Soloist on Mac, so music no longer keeps playing after you quit. By @crmne; thanks @xpepper. (#1157)
    • Soloist's volume follows the slider while you drag, in the player bar and in skins. By @YelovSK and @crmne. (#1162, #1136)
    • Windows Soloist visualizers keep their level as the volume falls, and keep working after pause and resume. By @YelovSK and @gyarisuta. (#1165, #1156, #1153)
    • When Soloist stops unexpectedly, what it printed is kept in soloist-output.log, with your key removed, so the cause can be found. By @crmne.
    • Soloist's EQ and visualizers work in the Flatpak. By @crmne; thanks @Leo-G20. (#1167)
    • **Linux playback no longer dies when rtkit grants rea
  4. v0.15.0Spotifast v0.15.02026-10-31 · 2026-10-31 14:07 UTC
    查看更新说明

    Spotifast 0.15 adds Spotify Soloist, Spotify's own player for listening outside the Spotify app, with lossless support. Setup guides you through downloading it from Spotify, adding your personal Soloist key and pairing once. Spotifast keeps it updated, and the built-in player remains available. Soloist may avoid the "Spotify refused the audio key" problem with the built-in player.

    Download Spotifast: Mac · Windows · Windows ARM · Linux · Linux ARM · Flatpak · AppImage · AppImage ARM

    Windows installs now use the .msi only. If you are on 0.12.x or earlier, download and run it once to keep receiving updates. Portable ZIPs remain available.

    New

    • Listen through Spotify Soloist. New listeners and people updating are guided through setup, with a built-in-player option at every step. Soloist appears as This computer and renews its expiring builds automatically while inactive. Spotify Premium and your own Soloist key are required. Spotify currently supplies Soloist for Linux, Apple Silicon Macs and x64 Windows. Setup and platform details. By @crmne; thanks @krolebord and @mrcego. (#1050, #283)
    • EQ and visualizers with Soloist on Linux and Mac. Linux uses PipeWire; macOS 14.2 or newer uses a private audio route after you allow System Audio Recording. Only Spotifast's player is captured, and no audio is saved. Spectrum, oscilloscope and MilkDrop follow the EQ and keep moving when you mute inside Spotifast. On Mac, Soloist stays at 100% and Spotifast controls the output; phone volume changes adjust that output, then the phone's indicator returns to 100%. By @crmne.
    • Soloist visualizers on Windows 11. Spectrum, oscilloscope and MilkDrop follow Soloist's audio. Windows still plays directly through Soloist: audible EQ is unavailable, and lowering volume lowers the visualizers too. By @crmne.
    • Spotify features stay available with Soloist. Settings → Account → Spotify access lets you authorize Made for you, listening activity and Spotify lyrics while keeping Soloist as your player. By @crmne.
    • See an album's full release date on hover, or its year when that is all Spotify supplies. By @BerkeBat. (#1008)
    • Signed Windows downloads. The executable and installer are signed as PlentyLabs UG (haftungsbeschränkt) & Co. KG. Windows may still show SmartScreen while the publisher builds reputation. By @crmne. (#1062)

    Soloist does not expose a delivered-format indicator or audio-quality preferences. Local files and full queue editing still use the built-in player. Older Macs and Windows versions without process capture retain ordinary Soloist playback where Spotify supports it. See Soloist's current limits.

    Fixed

    • Lyrics recover from LRCLIB overloads. Temporary errors are retried, search provides another lookup, and cached lyrics stay available during outages. Failed requests are no l
  5. v0.14.2Spotifast v0.14.22026-10-26 · 2026-10-26 09:36 UTC
    查看更新说明

    Spotifast 0.14.2 fixes signing in for the first time. Until now, Spotifast signed in through ncspot's Spotify app, and its developer has closed that app to other apps, so a first sign-in failed with "redirect_uri: Not matching configuration". Now you make your own free Spotify app, and the sign-in screen guides you through it. This release also plays local files at any sample rate, with their own covers and lyrics, asks Spotify for fewer audio keys, and fixes a crash in playlists with hidden songs.

    Download Spotifast: Mac · Windows · Windows ARM · Linux · Linux ARM · Flatpak · AppImage · AppImage ARM

    On Windows, pick the .msi. The setup program (-setup.exe) is still attached so that installs from 0.12.0 and earlier can update through it.

    Changed

    • Sign in with your own free Spotify app, guided on the sign-in screen. The screen shows each step: open Spotify's developer dashboard, create an app with the redirect URI it shows (with a Copy button) and Web API ticked, then paste the app's Client ID. Spotifast checks the Client ID with Spotify before the browser opens. Spotify requires Premium on the account that creates the app. If you are already signed in, nothing changes: Spotifast keeps working, and Settings offers the switch to your own app. Getting started has the steps. By @crmne; thanks @MrHunor and @Fabsss0505. (#1057, #1059)

    New

    • Local files play at any sample rate, including 48 kHz, hi-res and mono files, instead of only 44.1 kHz stereo. By @crmne; thanks @PeeblyWeeb. (#3)
    • Queue a playlist's local files. Add to queue, Play next, a selection and a drop now queue them while this computer plays. By @crmne; thanks @paulwinches. (#1002)
    • Local files show their own cover and lyrics, from the picture in the file and a .lrc file beside it or the lyrics in its tags. By @crmne; thanks @MaximoLongo. (#1001)
    • A page for when something goes wrong. When something goes wrong explains "Spotify refused the audio key" and "Spotify is being slow" in plain words, with what helps. By @crmne.
    • The Winamp D button steps through 1x too, so a skin can show pixel for pixel. By @crmne.

    Fixed

    • Fewer "Spotify refused the audio key" errors. Spotifast now asks Spotify for one audio key at a time, waits after a refusal before asking again, and fetches ahead only the next song's key. By @crmne; thanks @mrcego. (#283)
    • A refused audio key is explained in a banner that says what happened, that a phone or another device still plays, and opens the device picker, instead of a red error. By @crmne; thanks @mrcego. (#283)
    • When Spotify slows the shared app, a banner says so and offers to set up your own app, at most once a day. By @crmne.
    • Repeat One turns into Repeat All when you change songs, as in Spotify's apps. Restarting the song keeps it. By @crmne; thanks @jorisw. (#1022)
    • Scrolling to the end of a playlist with hidden songs no longer crashes Spotifast, and the right row plays. By @MaxRong; thanks @Alexandre-Froes. (#1046, #1041)
    • **The rem

用户点评

登录用户的真实使用记录,可按版本和硬件筛选
共 0 条

    还没有人点评。第一个说出真实体验的人最有价值。

    README 原文

    未翻译

    Spotifast is a Spotify client written in Rust with egui and fastframe, the framework behind a family of native desktop apps. It plays music through Spotify Soloist or the built-in librespot player, and has no browser engine.

    The interface includes complete translations for all supported languages.

    Playback needs Spotify Premium. Free accounts can browse and search, but cannot play music through Spotifast.

    Spotifast Home with the playlist library, recommendations, queue, and player visible

    https://github.com/user-attachments/assets/a5f669ce-b3b7-4f8e-9933-976a78876c7e

    Features · Install · First playback · Mini player · MilkDrop · Help

    Since 0.15, setup leads with Spotify's Soloist player, with guided key setup, one-time pairing and automatic renewal of expiring builds. New listeners and people updating see this choice once after sign-in on supported platforms. Use the built-in player keeps librespot, with Spotifast's EQ, visualizers, local files and full queue editing. The choice is remembered. On Linux with PipeWire, Soloist also supports Spotifast’s EQ and visualizers through a private audio route. Native audio support adds EQ and visualizers on macOS 14.2 or newer, and visualizers on Windows 11, including MilkDrop. Windows Soloist playback does not support audible EQ. The Mac route keeps Soloist at full volume after redirecting its output, then applies Spotifast’s volume after the visualizers, including mute. Phone volume changes adjust that output level; Spotify’s indicator returns to 100%. Windows visuals keep their level as Soloist’s volume falls and stop only when it is muted. When enabled, Soloist appears as This computer; settings show the controls that apply to it. Turning it off restores the built-in player's preferences. While Soloist starts and its account is verified, the Spotify loading screen shows Verifying Soloist… and waits to accept playback commands. Setup takes three steps, and ends with choosing the named device in Spotify, with the built-in player available as a quiet alternative below the card. If Soloist stops later, a banner over the app says so while Spotifast restarts it, and offers Try again if that does not work. Settings → Spotify Soloist → Spotify access connects the separate Spotify session for Made for you, listening activity and Spotify lyrics without changing players.

    Your music, on your desktop

    FeatureWhat you can do
    Library and searchBrowse playlists, Liked Songs, albums, artists, and podcasts. Discover upcoming albums on artist pages and open their countdown to pre-save. Search the catalogue and edit playlists you own. Copy a song's link, title, or artists from its menu.
    Local filesPlay the local files your playlists list from a folder you choose in Settings, at any sample rate. Names show spaces and accents correctly, including in cached playlists.
    LyricsSpotify lyrics when the playback session is signed in, with LRCLIB as fallback. Temporary LRCLIB overloads retry and try search; older cached lyrics remain available during outages.
    Spotify ConnectPlay on this computer or control playback on your other devices, including Google Cast speakers and groups. Cast devices appear as they are discovered; frequently and recently chosen outputs rise to the top. Remote volume keeps your chosen level while Spotify updates.
    QueueAdd songs to the queue, or choose Play next to put a song or selection first when playing on this computer.
    ThemesChoose light, dark, system appearance, or custom colours, with one theme for light mode and one for dark mode that switch with the system. On Omarchy, follow your desktop theme.
    Desktop controlsUse keyboard shortcuts and media keys. Keep music playing from the tray when supported by your desktop and settings, and start Spotifast with your computer, with its window or in the tray.
    Winamp mini playerUse classic skins with an equalizer, playlist, and animated sound displays.
    MilkDropWatch music-reactive visuals in a separate window or full screen. See platform availability below.

    Install

    PlatformInstallation
    macOSbrew install --cask crmne/tap/spotifast, or download the Mac app.
    Arch Linuxyay -S spotifast-bin
    WindowsThe installer or a portable ZIP, for x64 and ARM, from the Download page.
    Debian, UbuntuThe DEB package, then sudo apt install ./spotifast_*.deb
    FedoraThe RPM package, then sudo dnf install ./spotifast-*.rpm
    Other LinuxFind Flatpak, AppImage, Nix, and other options on the Download page.
    From sourceFollow Build from source for dependencies and commands.

    Start listening

    1. Register Spotifast with Spotify, as the sign-in screen shows: in the Spotify developer dashboard, click Create app, Spotify's name for this registration, with the redirect URI http://127.0.0.1:8989/login and Web API ticked. It takes about two minutes and gives you a Client ID. Spotify requires Premium on the account that registers, so a Free account can't do this step itself. Getting started has the steps.
    2. Paste the Client ID into Spotifast and choose Sign in with Spotify. Approve access in your browser, then return to the app to see your library.
    3. To listen on this computer, open the device menu in the bottom player bar and choose Set up playback here, also available in Settings.
    4. Complete the separate playback approval in your browser. Your computer appears as a Spotify Connect device named Spotifast.

    Library access and local playback have separate approvals. Spotifast remembers both using your computer's protected storage. See Getting started for the full walkthrough and How it connects for the details.

    The Winamp mini player

    A classic look for your music, with Winamp 2 .wsz and Windows Media Player .wmz skins, an equalizer, a playlist, and animated sound displays. Switch with Ctrl+M (Cmd+Shift+M on macOS), the shrink button, or Settings. The spectrum analyser and oscilloscope also work in the collapsed title bar.

    Explore the mini player, including skins, window sizes, controls, and the return to the main player.

    Music in motion

    MilkDrop reacts to music playing on this computer, with more than 10,000 presets downloaded on first use. Open it from the visualiser button, Settings, or the mini player's V menu.

    MilkDrop visualiser displaying coloured concentric patterns in Spotifast

    Included on Linux, macOS, and Windows Intel/AMD builds. It is not included in the Windows on ARM download. Read the MilkDrop guide for presets, controls, and fullscreen mode.

    Guides and help

    The complete guide lives at spotifast.rocks.

    You want to…Read
    Sign in, set up playback, or configure themes, fonts, and proxiesGetting started
    Learn shortcuts, command-line controls, and updatesEveryday use
    Check storage sizes, clear cached audio and find stored filesSettings and files
    Understand scrolling performance and reduce loading delaysMake it even faster
    Fix "Spotify refused the audio key" or "Spotify is being slow"When something goes wrong
    Understand what is stored and sentPrivacy · How it connects
    Check Spotify and librespot limitationsWhat Spotify allows
    Is it safe for my account?Account safety
    Report a bug or propose a featureRead Contributing, then use the issue forms.

    Contributing

    Read CONTRIBUTING.md before opening an issue or pull request. To look at the interface without a Spotify account, run:

    cargo run --features demo -- --demo
    

    Translations live in assets/i18n/; see Translating Spotifast. Release packaging is described in PACKAGING.md.

    More native apps

    Want WhatsApp just as fast and native? ZapFast is Spotifast's sibling. Both are built on fastframe.

    Spotify Connect updates

    With local playback enabled, Spotify pushes changes from other devices over Spotifast's existing Connect session. Playback changes trigger a refresh. Volume-only changes appear directly for the active playback device without an extra request; an unconfirmed volume change made in Spotifast takes precedence. Push-triggered refreshes are at least a second apart and wait for a pending playback read to finish. Changes received during that read are folded into one follow-up. Connect pushes are ignored when this computer is the active device both before and after; position-only updates cause no requests. Regular polling remains the fallback.

    Sonos playback

    Sonos speakers use the Spotify Connect session for playback control. Enable local playback first, then select the speaker in the device picker.

    Acknowledgements

    Spotifast uses librespot, egui, fastframe, the Inter typeface (OFL), and Lucide icons (ISC).

    Spotifast is an independent project and is not affiliated with Spotify. Spotify is a trademark of Spotify AB.

    Licensed under the MIT License.

    Star history