Command Line Parameters

You can use the command-line to pass individual files, folders, and special options to Resonic.
This page will explain how, and what you can do

Parameter Basics

Options always begin with --, e.g. --option.

Options that can have values must be written in the form --option=value.
If an option value contains spaces the whole parameter must be quoted, i.e. "--option=value with spaces".

Boolean options can be negated using the no- prefix, e.g. --option and --no-option.

Non-options like filenames must never begin with --.
If a filename contains spaces it must be "enclosed in quotes" as well.

The order in which command line parameters are supplied to Resonic is not important.

Playing Files

To pass an audio file to Resonic and start playing it simply supply its full path:

Resonic.exe "full path to file"

To put Resonic into a different playback state and not start playing automatically use the --stopped and --paused options:

Resonic.exe "full path to file" --stopped
Resonic.exe "full path to file" --paused

Playing Folders

To pass a folder to Resonic's browser and start playing it supply its full path:

Resonic.exe "full path to folder"

To merely point the browser to a folder, but not start playing it use the --browse option:

Resonic.exe "full path to folder" --browse

Window Activation

By default Resonic shows and activates its main window when you open a file or folder via Windows Explorer integration (not available in portable version), or via the command line.

To change this behavior globally see Menu » Advanced.

To override this behavior when playing files via the command line you can use these options:
--no-activate
--activate

This ensures that Resonic does not pop into the foreground unexpectedly.

Track Advance

To tell Resonic not to automatically advance to the next file in the list ignoring the global track advance setting for this one file, or to force track advance for this one file, use these options:
--no-advance
--advance

Playback Position

You can start your files at a certain fractional position using the --start-fract=VALUE option. Values here range from 0..1, i.e., 0-100% of the total track length.

To start playing in the middle of a track:
--start-fract=0.5

Fade In Volume

To fade in the track's volume on startup you can use the --start-ramp-duration=VALUE option. Duration value must be specified in milliseconds.

To fade in a track for five seconds:
--start-ramp-duration=5000

Set Loop Selection (Pro)

Available from Resonic Pro 0.9.

There are a couple of options available to create a loop selection for the track:

--loop-start=VALUE
sets the left locator of the loop selection (always required end or length).

--loop-end=VALUE
sets the right locator of the loop selection.

--loop-length=VALUE
sets the loop duration (overrides the --loop-end option).

Values range from 0..1, i.e., 0-100% of the total track length.
If you append an s letter to a value it is interpreted as a seconds value instead.

To create a loop that starts at 50% of the total length and lasts for ten seconds:
Resonic.exe "full path to file" --loop-start=0.5 --loop-length=10s
To create a loop that starts at 10% and ends at 90% of the total length:
--loop-start=0.1 --loop-end=0.9
To create a loop that starts at 5 1/4 seconds in and ends at 12 1/2 seconds in:
--loop-start=5.25s --loop-end=12.5s
To create a loop for the whole track:
--loop-start=0.0 --loop-end=1.0
--loop-all
Note that this also works at runtime without specifying a filename, in which case Resonic Pro will modify the existing loop selection, for example:
Resonic.exe --loop-start=0.4 --loop-end=0.6

Remote Control Commands

Available from Resonic 0.9.

Resonic can partially be remote-controlled via the command-line.
For this matter a series of commands are available, which are also shared by the hotkey features.

For example, some basic transport functions:
--cmd=transportStop
--cmd=transportPlay
--cmd=transportPause
--cmd=transportPauseToggle

Multiple --cmd options can be specified at the command-line, which are then executed sequentially.

Because command names are not finalized yet (Beta) we're only listing a small assortment here. If you're interested in remote controlling Resonic from your application get in touch with us.

Missing Something?

You feel like we're missing some important command line features here?

Let us know and we'll see what we can do!