Command line API

You can launch ossia score from the command line or shell scripts with various useful options.

Command-line reference

Getting the list of options

$ ossia-score --help

Loading a score on startup:

$ ossia-score filename

# For example: 
$ ossia-score /home/oscar/my-score.score

Playing a score on startup

$ ossia-score --autoplay filename

# For example: 
$ ossia-score --autoplay /home/oscar/my-score.score

Playing a score on startup after some delay

This is useful if for instance the score has audio plug-ins that take some time to load, such as orchestral plug-ins with large sound banks.

$ ossia-score --autoplay filename --wait delay_in_seconds

# For example: 
$ ossia-score --autoplay /home/oscar/my-score.score --wait 5

Loading score without showing the GUI

$ ossia-score --no-gui

(note: this is not very useful without specifying a file to load).

Loading score without showing the “do you want to restore” pop-up dialog

This is useful if you are quitting score for instance by killing the process, as score will register that as a crash, which will cause the pop-up to show up next time.

$ ossia-score --no-restore

Loading score in software rendering mode

ossia score uses as of v3 OpenGL for rendering the main timeline. On some old machines or machines with bad GL drivers, this can cause issues. We then recommend using that switch to launch it.

$ ossia-score --no-opengl

On Linux:

$ /usr/bin/ossia-score --no-gui --no-restore --wait 5 --autoplay "/path/to/your/score.score"

On macOS:

$ /Applications/Score.app/Contents/MacOS/score --no-gui --no-restore --wait 5 --autoplay "/path/to/your/score.score"

On Windows:

> "c:\Program Files\ossia score\score.exe" --no-gui --no-restore --wait 5 --autoplay "c:\path\to\your\score.score"