Installing RustMusic
RustMusic is free and installs in a few minutes. Pick your system below: the warnings you may see on first launch are explained, and they are expected.
Up to date for version 0.4.3
Documentation
System requirements
| System | Minimum version | File to download |
|---|---|---|
| Windows | Windows 10 or 11, 64-bit | .exe installer |
| macOS | macOS 10.15 Catalina | Universal .dmg (Apple Silicon and Intel) |
| Linux | Recent 64-bit distribution | .deb, .rpm or AppImage |
All files are on the Downloads page. A compatibility build exists for older Linux distributions such as Ubuntu 22.04 or Debian 12.
Windows
- 1
Download the installer
Get the RustMusic_…_x64-setup.exe file from the Downloads page. You can also use winget: “winget install rustmusic” installs RustMusic, and “winget upgrade” keeps it up to date.
- 2
Run it
Windows may show “Windows protected your PC”. Click “More info”, then “Run anyway”.
- 3
Follow the wizard
Installation takes a few seconds. If the WebView2 component is missing, the installer downloads it; it is already present on up-to-date Windows 10 and 11.
Why this warning? The installer isn’t signed with a commercial certificate, which costs several hundred euros a year for a volunteer project. The code is open source and every update is cryptographically signed.
macOS
- 1
Download the .dmg
The RustMusic_…_universal.dmg file works on Apple Silicon and Intel Macs.
- 2
Install the app
Open the .dmg and drag RustMusic into the Applications folder.
- 3
Allow the first launch
macOS blocks apps that aren’t notarized. Open RustMusic once, dismiss the alert, then go to System Settings → Privacy & Security and click “Open Anyway”. On macOS 14 and earlier, right-clicking the app and choosing “Open” is enough.
If macOS says “RustMusic is damaged and can’t be opened”, the quarantine attribute is blocking the app. Remove it in Terminal:
xattr -cr /Applications/RustMusic.appLinux
Pick the package for your distribution, then install it from the folder it was downloaded to:
| Distribution | Package | Command |
|---|---|---|
| Debian, Ubuntu, Mint | .deb | sudo apt install ./RustMusic_<version>_amd64.deb |
| Fedora | .rpm | sudo dnf install ./RustMusic-<version>-1.x86_64.rpm |
| openSUSE | .rpm | sudo zypper install ./RustMusic-<version>-1.x86_64.rpm |
| Any | AppImage | chmod +x RustMusic_<version>_amd64.AppImage |
The AppImage then starts with a double-click. It needs FUSE 2: if nothing happens, install libfuse2 (sudo apt install libfuse2, or libfuse2t64 on Ubuntu 24.04).
“GLIBC_2.39 not found” error on launch? Your distribution is older than the one RustMusic is built on. Use the glibc 2.35 compatibility build, listed under each version on the Downloads page.
Updates
RustMusic checks for a new version a few seconds after launch. When one is available, an “Update available” banner offers “Install now” or “Later”. The app downloads it, installs it and restarts on its own.
You can also check manually in Settings → About → “Check for updates”. Updates are signed: RustMusic rejects any file whose signature doesn’t match.
Uninstalling
- Windows: Settings → Apps → RustMusic → Uninstall.
- macOS: drag RustMusic from the Applications folder to the Trash.
- Linux: remove the package with your package manager, or simply delete the AppImage file.
Your music files are never touched. To also remove the library, settings and downloaded covers, delete the data folder:
| System | Data folder |
|---|---|
| Windows | %APPDATA%\com.larevuegeek.rustmusic |
| macOS | ~/Library/Application Support/com.larevuegeek.rustmusic |
| Linux | ~/.local/share/com.larevuegeek.rustmusic |
Further reading
Question not answered?
Open an issue on GitHub: every report helps improve RustMusic and this documentation.