Setup parameters

Setup parameters affect various aspects of playback and appearance of Meson Player. Such parameters can be loaded from settings.ini files or passed via command line. You can pass these parameters only if the application isn't running yet (except autoload-playlists, index, load-only, playback-mode, subdirs and volume position).

Below is the full list of setup parameters in alphabetical order.

auto-numlock

Set Num Lock on startup. Only for Windows.

Valid values: true, false

Default: true

auto-resume

Resume playback if no input files supplied and the app was closed via user logout while playing a music.

Valid values: true, false

Default: true

autoload-playlists

When loading directories, also load files in found playlists.

Valid values: true, false

Default: false

balloons

Show balloon-style notifications on every event (track/volume change).

Valid values: true, false

Default: true

buffer-length

The playback buffer length in milliseconds. Increasing the length, decreases the chance of the sound possibly breaking-up on slower computers.

Valid values: 10..5000, but not lower than update-period

Default: 500

close-on-stop

Close the file on stop?

Valid values:

• true - If user stops a playback, the file will be closed, so that it can be deleted, for example;
• false - The current track will remain open even after the player is stopped.

Default: true

device

Use a specific device for a sound output.

Valid values:

• -1 - default device;
• 0 - no sound;
• 1 - first real output device;
• 2 - second real output device (and so on)

Default: -1

frequency

Output sample rate in Hz. Only for Linux.

Valid values: 192000, 96000, 48000, 44100, 22050, 16000, 11025, 8000

Default: 44100

index

Sets a file number to play. The first filename has the index of zero.

This parameter can only be specified via command line and only makes sense when some filenames were also specified.

If there are filenames in command line as well, then this parameter will choose what file to play. If there were no filenames, then this parameter will change the current track to a track with the specified index in a current playlist.

Valid values: any positive integer

log

Error logs will be saved in <user home dir>/.mesonplayer/logs/.

Valid values: true, false

Default: false

load-only

Whether to play or not to play the music after the music file is loaded.

This parameter can only be specified via command line and only makes sense when some filenames were also specified.

Valid values: true, false

If not specified: Auto-play music. The exact music file can be specified via index parameter.

min-folder-length

When current folder's name length is less than this, then prepend parent directory name to it (for tooltip).

Valid values: any positive integer

Default: 5

mods-cmd

Hotkey modifiers for command keys (play, next, vol up, ...).

Valid values: unspecified, OFF or any combination of CTRL, SHIFT or ALT separated by + sign.

These values should not be identical to mods-load or mods-save parameters.

Default: <none>

mods-mm

Hotkey modifiers for multimedia keys (play/pause, next, ...).

Valid values: unspecified, OFF or any combination of CTRL, SHIFT or ALT separated by + sign.

These values should not be identical to mods-mm2 parameter.

Default: <none>

mods-mm2

Hotkey modifiers for multimedia keys for jumping to a next/previous folder.

Valid values: unspecified, OFF or any combination of CTRL, SHIFT or ALT separated by + sign.

These values should not be identical to mods-mm parameter.

Default: CTRL

mods-load

Hotkey modifiers for loading playlists.

Valid values: unspecified, OFF or any combination of CTRL, SHIFT or ALT separated by + sign.

These values should not be identical to mods-cmd or mods-save parameters.

Default: CTRL

mods-save

Hotkey modifiers for saving playlists.

Valid values: unspecified, OFF or any combination of CTRL, SHIFT or ALT separated by + sign.

These values should not be identical to mods-cmd or mods-load parameters.

Default: ALT

mpris

Propagate Meson Player via MPRIS interface. Can be used to allow other applications (e.g. KDE Connect) to control Meson Player via D-Bus. Linux only.

Valid values: true, false

Default: true

mvol-step

Change a master volume by specified step.

Valid values: any value in range [0;100]

Default: 5

playback-mode

Set playback mode.

This parameter can only be specified via command line.

Valid values:

• track_once - Play one track one time then stop;
• all_once - Sequentially play all tracks from the current playlist then stop;
• track_loop - Repeat one track in a loop;
• all_loop - Sequentially play all tracks from the current playlist then proceed to the first track and repeat the process;
• random - Play tracks from the current playlist in a random order without stop

If not specified: do not change playback mode.

playlists-type

Save playlists in this format.

Valid values: M3U, ASX, XSPF, PLS, WPL

Default: M3U

Playlists are saved in UTF-8, even M3U.

popup-duration

Duration of notification popup in seconds.

Valid values: any positive value

Default: 5

position

Sets a file position in seconds. If there are filenames in command line as well, then the first file that's going to be played will start from te specified position. If there were no filenames, then this parameter will change the position of currently playing file.

This parameter can only be specified via command line when the application is already running.

Valid values: any positive floating point value (e.g. 12.5)

proxy

Use this proxy for network requests. SOCKS5 and HTTP proxies are supported.

The format of this value is following: <scheme>://[<user>[:<pass>]@]<host>:<port>, where

• <scheme> - socks5 or http;
• <user>, <pass> - user credentials (not required);
• <host>, <port> - host and port of the proxy.

You may also set this value to system in which case the system settings will be used (not supported on 64-bit Windows).

Default: system

sample-interpolation

Set sample interpolation mode. Only applies to the following music formats: mo3, it, xm, s3m, mtm, mod, umx, mdz, s3z, xmz, itz.

Valid values:

• sinc - Use sinc interpolated sample mixing. This increases the sound quality, but also requires more processing;
• none - Use non-interpolated sample mixing. This generally reduces the sound quality, but can be good for chip-tunes;
• linear - Linear interpolation.

Default: sinc

sample-ramping

Set sample ramping mode. Only applies to the following music formats: mo3, it, xm, s3m, mtm, mod, umx, mdz, s3z, xmz, itz.

Valid values:

• normal - smoothen volume/pan changes to avoid "clicks";
• sensitive - Same as normal, but will only ramp the start of a sample if it thinks that it would "click" otherwise. This keeps percussive sounds sharp, whereas normal ramping can slightly deaden their impact;
• none - no ramping is applied.

Default: sensitive

sample-type

Set the type of samples.

Valid values:

• float32 - Use 32-bit floating-point sample data;
• 8bits - Use 8-bit resolution;
• none - Use 16-bit resolution.

Default: float32

If you set sample-type=8bits, then you must set use-8bits=true.

short-captions

Show only track title in the tray hint.

Valid values: true, false

Default: false

subdirs

Load music files recursively when a folder is specified via command line.

Valid values: true, false

Default: true

surround-mode

Set surround mode. Only applies to the following music formats: mo3, it, xm, s3m, mtm, mod, umx, mdz, s3z, xmz, itz.

Discarded if use-mono is set to true.

Valid values:

Default: none

system-playlists

Enables system playlists.

Valid values: true, false

Default: true

tracker-emulation

Set tracker emulation mode. Only applies to the following music formats: mo3, it, xm, s3m, mtm, mod, umx, mdz, s3z, xmz, itz.

Valid values:

• none - play .MOD file as usual;
• fastTracker2 - play .MOD file as FastTracker 2 would;
• proTracker1 - play .MOD file as ProTracker 1 would.

Default: none

tray-icon

Display a tray icon.

Note, that even if the tray icon is not displayed, you're still able to close the application gracefully. For that you should set system-playlists parameter to true. Then you can close the app using 0011 command.

Valid values: true, false

Default: true

type-timeout

When typing a playlist ID you have only a limited time interval to enter a next digit. This parameter sets this interval in milliseconds.

Valid values: any positive integer value

Default: 1000

unlimited-playlists

When this option is set to false, then a playlist will be loaded/saved instanly when you type the first digit of its ID.

Note that disabling this option will limit the number of playlists to 9.

Valid values: true, false

Default: true

update-period

The amount of time (in milliseconds) between updates of the playback buffers. Shorter update periods allow smaller buffers to be set with the buffer-length, but as the rate of updates increases, so the overhead of setting up the updates becomes a greater part of the CPU usage.

Valid values: 5..100, but not greater than buffer-length.

Default: 100

use-8bits

Use 8-bit resolution, else 16-bit.

Valid values: true, false

Default: false

If you set use-8bits=true, then you must set sample-type=8bits.

use-default-device

Automatically switch the default output to a new default device whenever it changes. Only works on Windows.

Valid values: true, false

Default: true

use-mono

Use mono output.

Valid values: true, false

Default: false

use-software

Use software for sound processing, else use hardware.

Valid values: true, false

Default: false

volume

Sets a sound volume.

This parameter can only be specified via command line.

Valid values: any integer within a range [0;100]

If not specified: Do not change the sound volume.

volume-step

Change volume by specified steps.

Valid values: any integer value in range [0;100]

Default: 5