Windows

Windows 10, Windows 11

  • Installer (recommended)
  • Winget
  • Scoop
  • Portable / offline install

Windows instructions

Linux

Most modern distributions (AppImage, deb, rpm, AUR)

  • AppImage (any distribution)
  • Arch Linux (AUR)
  • Debian / Ubuntu
  • Fedora / openSUSE

Linux instructions

Before you install

The app is unsigned on Windows and un-notarised on macOS, because code-signing certificates cost money that an MIT-licensed hobby project does not have. Both systems will therefore warn you the first time you run it. The Windows and macOS pages explain exactly what the warning says and how to get past it.

Every release publishes checksums. If you want to be certain the file you downloaded is the file that was built, compare them — that is a stronger guarantee than a signature anyway.

Nothing here requires an account, a subscription or a payment. If you find the app useful, star the repository or contribute a fix.

Frequently asked questions

Is it safe to install?

The code is public and every release is built from it in the open. Download only from the official GitHub releases page, and verify the checksum published with each release if you want certainty. Windows SmartScreen and macOS Gatekeeper both warn about the builds because they are not commercially signed or notarised — that is a cost issue, not a sign of malware.

Which operating systems are supported?

Windows 10 and 11 (x64, ia32, arm64), macOS on Apple Silicon and Intel, and Linux as AppImage, deb, rpm and an AUR package.

How do I update to a new version?

Windows installer builds update themselves. Homebrew, Scoop, Winget and the AUR package update with your normal package-manager upgrade. AppImage and portable builds are replaced by downloading the new file.

Why does macOS say the app is damaged?

Gatekeeper quarantines apps that are not notarised by Apple. Run /usr/bin/xattr -cr /Applications/YouTube\ Music.app in Terminal once and the app opens normally.