NAME

openmpt123 - command line module music player based on libopenmpt

SYNOPSIS

openmpt123 [options] [--] file1 [file2] ...

DESCRIPTION

openmpt123 v0.8.1, libopenmpt 0.8.1+r23497 (OpenMPT 1.32.01.04-r23497 https://source.openmpt.org/svn/openmpt/tags/libopenmpt-0.8.1@23497 (2025-06-14T13:04:39.042416Z) clean) Copyright © 2013-2025 OpenMPT Project Developers and Contributors <https://lib.openmpt.org/>

openmpt123 plays module music files.

OPTIONS

-h, --help: Show help
--help-keyboard: Show keyboard hotkeys in ui mode
-q, --quiet: Suppress non-error screen output
-v, --verbose: Show more screen output
--version: Show version information and exit
--short-version: Show version number and nothing else
--long-version: Show long version information and exit
--credits: Show elaborate contributors list
--license: Show license
--probe: Probe each file whether it is a supported file format
--info: Display information about each file
--ui: Interactively play each file
--batch: Play each file
--render: Render each file to individual PCM data files
--banner n: openmpt123 banner style [0=hide,1=show,2=verbose] [default: 1]
--assume-terminal: Skip checking whether stdin/stderr are a terminal, and always allow UI [default: 0]
--terminal-width n: Assume terminal is n characters wide [default: -1]
--terminal-height n: Assume terminal is n characters high [default: -1]
--[no-]progress: Show playback progress [default: 1]
--[no-]meters: Show peak meters [default: 1]
--[no-]channel-meters: Show channel peak meters (EXPERIMENTAL) [default: 0]
--[no-]pattern: Show pattern (EXPERIMENTAL) [default: 0]
--[no-]details: Show song details [default: 1]
--[no-]message: Show song message [default: 0]
--update n: Set output update interval to n ms [default: -1]
--samplerate n: Set samplerate to n Hz [default: 48000]
--channels n: use n [1,2,4] output channels [default: 2]
--[no-]float: Output 32bit floating point instead of 16bit integer [default: 1]
--gain n: Set output gain to n dB [default: 0]
--stereo n: Set stereo separation to n % [default: 100]
--filter n: Set interpolation filter taps to n [1,2,4,8] [default: 8]
--ramping n: Set volume ramping strength n [0..5] [default: -1]
--tempo f: Set tempo factor f [default: 1]
--pitch f: Set pitch factor f [default: 1]
--dither n: Dither type to use (if applicable for selected output format): [0=off,1=auto,2=0.5bit,3=1bit] [default: 1]
--playlist file: Load playlist from file
--[no-]randomize: Randomize playlist [default: 0]
--[no-]shuffle: Shuffle through playlist [default: 0]
--[no-]restart: Restart playlist when finished [default: 0]
--subsong n: Select subsong n (-1 means play all subsongs consecutively) [default: -1]
--repeat n: Repeat song n times (-1 means forever) [default: 0]
--seek n: Seek to n seconds on start [default: 0]
--end-time n: Play until position is n seconds (0 means until the end) [default: 0]
--ctl c=v: Set libopenmpt ctl c to value v
--driver n: Set output driver [default: default],
--device n: Set output device [default: default], use --device help to show available devices
--buffer n: Set output buffer size to n ms [default: -1]
--period n: Set output period size to n ms [default: -1]
--stdout: Write raw audio data to stdout [default: 0]
--output-type t: Use output format t when writing to a individual PCM files (only applies to --render mode) [default: auto]
-o, --output f: Write PCM output to file f instead of streaming to audio device (only applies to --ui and --batch modes) [default: ]
--force: Force overwriting of output file [default: 0]
--: Interpret further arguments as filenames

Keyboard hotkeys (use 'openmpt123 --ui'):

[q]: quit
[ ]: pause / unpause
[N]: skip 10 files backward
[n]: prev file
[m]: next file
[M]: skip 10 files forward
[h]: seek 10 seconds backward
[j]: seek 1 seconds backward
[k]: seek 1 seconds forward
[l]: seek 10 seconds forward
[u]|[i]: +/- tempo
[o]|[p]: +/- pitch
[3]|[4]: +/- gain
[5]|[6]: +/- stereo separation
[7]|[8]: +/- filter taps
[9]|[0]: +/- volume ramping

NAME

SYNOPSIS

DESCRIPTION

OPTIONS

COPYRIGHT