Files
spotifast/docs/_guide/download.md
Carmine Paolino 16a9dde2ca Drop the old name from packages, release scripts and docs
Packages no longer install a fastpotify command or declare that they
replace, provide or conflict with the old packages. Releases no longer
carry the 0.9.1 bridge files, the release script only checks and sums
Spotifast downloads, and the Flatpak, Homebrew, macOS and Windows
recipes lose their old-identity branches and clean-ups. Packaging CI
tests the v0.11.2 release instead of installing the 0.8.0 package first.
The Rename page and the notes pointing to it are gone.

Updates begun by 0.10.2 or earlier on Windows relaunch fastpotify.exe,
which the installer no longer provides; such an install updates, but
needs starting by hand once.
2026-10-03 14:18:23 +02:00

5.5 KiB

title, description, nav_order
title description nav_order
Download Download the app for macOS, Windows, or Linux, with install instructions for each. 1

{% assign v = site.spotifast_version %} {% assign base = "https://github.com/crmne/spotifast/releases/download/v" | append: v %}

The current version is v{{ v }}. You can use the [download checksums]({{ base }}/checksums.txt) to check that a file has not been damaged or changed. Older versions are on the releases page.

macOS

One download for both Apple Silicon and Intel:

  • [Download for Mac]({{ base }}/spotifast-v{{ v }}-macos-universal.dmg)

Open the downloaded file and drag Spotifast to Applications.

If you use Homebrew, you can install it with:

brew install --cask crmne/tap/spotifast

First open on macOS

Open Spotifast from Applications. If your Mac asks whether you want to open an app downloaded from the internet, choose Open.

Starting with 0.8.0, the Mac download passes Apple's security checks. You do not need to change security settings or run commands in Terminal to open it.

Quit the old app before opening Spotifast. Your saved settings and sign-ins carry over. If an older version reports that its update helper exited before it was ready, install the DMG above manually once. The helper changes take effect for updates started from 0.9.1 onward.

Windows

Download and run the installer. It adds Spotifast to the Start menu and does not need an administrator password. Choose the first download for most PCs, or the ARM version if your PC uses an ARM processor:

  • [Windows installer (most PCs)]({{ base }}/spotifast-v{{ v }}-x86_64-pc-windows-msvc-setup.exe)
  • [Windows installer (ARM PCs)]({{ base }}/spotifast-v{{ v }}-aarch64-pc-windows-msvc-setup.exe)

To run Spotifast without an installer, download a ZIP file, extract it, and open spotifast.exe.

  • [Windows ZIP (most PCs)]({{ base }}/spotifast-v{{ v }}-x86_64-pc-windows-msvc.zip)
  • [Windows ZIP (ARM PCs)]({{ base }}/spotifast-v{{ v }}-aarch64-pc-windows-msvc.zip)

Either way, SmartScreen may warn about an unknown publisher on first run; choose More info, then Run anyway.

Spotifast needs OpenGL 2.0 or newer, which every current Windows graphics driver provides. In a virtual machine or remote session that only has the Microsoft Basic Display Adapter, it may not start; install the machine's graphics driver, or enable GPU acceleration for the virtual machine.

To choose which app opens Spotify links, use Settings → Apps → Default apps in Windows.

Linux

Arch Linux

Spotifast is in the AUR, Arch's community package collection. Installing it also adds it to your app launcher:

yay -S spotifast-bin      # the released build, ready made
yay -S spotifast          # the release, built from source
yay -S spotifast-git      # built from the latest commit

Flatpak

Download the [Spotifast Flatpak]({{ base }}/spotifast-v{{ v }}-x86_64.flatpak?flatpak-id=rocks.spotifast.Spotifast). It requires Flatpak and the Freedesktop 24.08 runtime, a set of shared components used by Flatpak apps:

flatpak install --user ~/Downloads/spotifast-v{{ v }}-x86_64.flatpak
flatpak run rocks.spotifast.Spotifast

The application ID is rocks.spotifast.Spotifast.

To update this Flatpak installation, download and install the new release. Flathub support is planned.

Packages from other stores are maintained by their publishers. Report problems specific to those packages to their maintainers.

AppImage

  • [AppImage (Intel and AMD, 64-bit)]({{ base }}/spotifast-{{ v }}-x86_64.AppImage)
  • [AppImage (ARM, 64-bit)]({{ base }}/spotifast-{{ v }}-aarch64.AppImage)

One file, no installation: make it executable and run it.

chmod +x ~/Downloads/spotifast-{{ v }}-x86_64.AppImage
~/Downloads/spotifast-{{ v }}-x86_64.AppImage

The AppImage bundles no libraries: like the DEB and RPM, it needs glibc 2.39 or newer and your desktop's own libraries. Running it needs FUSE; without FUSE, start it with --appimage-extract-and-run. It does not update itself: download the new file when Spotifast says a release is out.

Other distributions

  • [Linux archive (Intel and AMD, 64-bit)]({{ base }}/spotifast-v{{ v }}-x86_64-unknown-linux-gnu.tar.gz)
  • [Linux archive (ARM, 64-bit)]({{ base }}/spotifast-v{{ v }}-aarch64-unknown-linux-gnu.tar.gz)

Unpack, put spotifast on your PATH, and copy the desktop entry and icon from the bundled packaging/ directory if you want it in your launcher and handling spotify: links. The binary needs ALSA, PulseAudio or PipeWire, and Wayland or X11.

Or build from source: see the build instructions.

Nix

Add the repository flake to your inputs:

inputs.spotifast.url = "github:crmne/spotifast";

On NixOS, install the default package:

environment.systemPackages = [
  inputs.spotifast.packages."${pkgs.stdenv.hostPlatform.system}".default
];

nix-darwin

On macOS, use the same spotifast package to install Spotifast as a Mac app:

environment.systemPackages = [
  inputs.spotifast.packages."${pkgs.stdenv.hostPlatform.system}".spotifast
];
environment.pathsToLink = [ "/Applications" ];

The bundle appears in /Applications/Nix Apps. With Home Manager, home.packages is enough; its darwin support links app bundles into ~/Applications:

home.packages = [
  inputs.spotifast.packages."${pkgs.stdenv.hostPlatform.system}".spotifast
];