Link Search Menu Expand Document

Installing score

ossia score is available for Windows, macOS, Linux including embedded ARM systems, and FreeBSD. This page covers how to download and install score on your system.

System Requirements

Minimum specifications:

  • 64-bit operating system
  • 800 MHz CPU
  • 512 MB RAM
  • GPU supporting OpenGL 3.2, Vulkan, Direct3D 11, or Metal

For video processing and complex scenarios, a more powerful system is recommended.

Official x86_64 Windows and Linux downloads require an AVX2-capable CPU. For older CPUs, use a suitable distribution build rather than assuming the official binary will run.

Choose between the stable downloads and continuous builds. Check the requirements of the particular asset you download.


Windows

Direct Download

Download the installer directly:

Download ossia score for Windows.

Requirements:

Native Windows ARM64 installers are available in the Continuous development assets (aarch64.exe). Use add-ons and external plug-ins matching your installation’s architecture.

Alternative Installation Methods

WinGet:

winget install ossia.score

MSYS2:

pacman -S mingw-w64-x86_64-ossia-score

macOS

Direct Download

Download ossia score for macOS.

Choose the appropriate version for your Mac:

  • Apple Silicon (M1 and later): choose the AppleSilicon disk image.
  • Intel: choose the Intel disk image.

Current downloads require macOS Ventura 13 or later; see the system requirements. Older score releases have different requirements.

Installation Steps

  1. Download the .dmg file for your Mac
  2. Open the downloaded file
  3. Drag score to your Applications folder

Homebrew

brew install --cask ossia-score

On macOS, some VST plug-ins and virtual cameras may require additional permissions. See Troubleshooting for details.


Linux (x86_64)

Download ossia score for Linux.

AppImages work on most Linux distributions without installation:

  1. Download the AppImage.
  2. Make it executable: either through your desktop environment (right-click -> properties -> permissions -> “Allow executing file as program” on KDE Plasma for instance), or through command-line.

    chmod +x ossia.score-*.AppImage
    
  3. Run it:
    ./ossia.score-*.AppImage
    

Download from GitHub Releases

Flatpak

score is available on Flathub:

flatpak install flathub io.ossia.score

Then run with:

flatpak run io.ossia.score

Arch Linux (AUR)

yay -S ossia-score

Or using another AUR helper of your choice.

Nix

score is available in nixpkgs:

nix-shell -p ossia-score

FreeBSD

Available through the ports system.

Audio on Linux: For best performance, use the JACK or PipeWire audio backend. See Troubleshooting if you experience audio issues.


Raspberry Pi, Linux AArch64 and Embedded Systems

Download ossia score for Raspberry Pi.

score supports ARM-based systems including Raspberry Pi:

  • Download the AArch64 AppImage from the download page
  • Flatpak is also available for ARM systems
  • If you use Asahi Linux, this release is also what you want to use.

For headless or embedded deployments, see the Embedded documentation.

In a web browser

The browser edition runs without installing a desktop application. It has different browser, persistence, networking and hardware-access constraints; read Using score in the browser before choosing it for a project.


Building from Source

For developers who want to build score from source:

  • The separately uploaded ossia.score-…-src.tar.xz assets on the releases page include the source distribution. GitHub’s automatic “Source code” archives do not include submodules; use the uploaded asset or a recursive Git clone.
  • See the Building from source documentation for detailed instructions

Verifying Your Installation

After installation, launch score. You should see the main window with:

  • The Device explorer panel on the left
  • The scenario editor in the center
  • The Object inspector on the right

If score doesn’t start or you encounter issues, check the Troubleshooting page.

Next Steps

Now that score is installed, continue with the Quick Start guide: