Command Line

You can use the command-line to pass individual files, folders, options, and commands to Resonic.

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.

You can override this behavior when playing files via the command line using these parameters:

--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

Th change the global auto-advance behavior for files and folders see Menu » Advanced.

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.

Example: 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.

Example: 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:

To set the left locator of the loop selection (always required end or length):

--loop-start=VALUE

To set the right locator of the loop selection:

--loop-end=VALUE

To set the loop duration (overrides --loop-end):

--loop-length=VALUE

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.

Example: 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

Example: Create a loop that starts at 10% and ends at 90% of the total length

--loop-start=0.1 --loop-end=0.9

Example: 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

Example: 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.

Example: Create a loop selection

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.

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!

Go to documentation