OPENMPT123(1) User Commands OPENMPT123(1)

openmpt123 - command line module music player based on libopenmpt

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

openmpt123 v0.7.11, libopenmpt 0.7.11+r21953 (OpenMPT 1.31.11.00 https://source.openmpt.org/svn/openmpt/tags/libopenmpt-0.7.11@21953 (2024-10-26T13:09:27.804941Z) clean) Copyright © 2013-2024 OpenMPT Project Developers and Contributors https://lib.openmpt.org/

openmpt123 plays module music files.

Show help
Show keyboard hotkeys in ui mode
Suppress non-error screen output
Show more screen output
Show version information and exit
Show version number and nothing else
Show long version information and exit
Show elaborate contributors list
Show license
Probe each file whether it is a supported file format
Display information about each file
Interactively play each file
Play each file
Render each file to individual PCM data files
openmpt123 banner style [0=hide,1=show,2=verbose] [default: 1]
Skip checking whether stdin/stderr are a terminal, and always allow UI [default: 0]
Assume terminal is n characters wide [default: 72]
Assume terminal is n characters high [default: 23]
--[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]
Set output update interval to n ms [default: -1]
Set samplerate to n Hz [default: 48000]
use n [1,2,4] output channels [default: 2]
--[no-]float
Output 32bit floating point instead of 16bit integer [default: 1]
Set output gain to n dB [default: 0]
Set stereo separation to n % [default: 100]
Set interpolation filter taps to n [1,2,4,8] [default: 8]
Set volume ramping strength n [0..5] [default: -1]
Set tempo factor f [default: 1]
Set pitch factor f [default: 1]
Dither type to use (if applicable for selected output format): [0=off,1=auto,2=0.5bit,3=1bit] [default: 1]
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]
Select subsong n (-1 means play all subsongs consecutively) [default: -1]
Repeat song n times (-1 means forever) [default: 0]
Seek to n seconds on start [default: 0]
Play until position is n seconds (0 means until the end) [default: 0]
Set libopenmpt ctl c to value v
Set output driver [default: default],
Set output device [default: default], use --device help to show available devices
Set output buffer size to n ms [default: -1]
Set output period size to n ms [default: -1]
Write raw audio data to stdout [default: 0]
Use output format t when writing to a individual PCM files (only applies to --render mode) [default: auto]
Write PCM output to file f instead of streaming to audio device (only applies to --ui and --batch modes) [default: ]
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

Copyright © 2013-2024 OpenMPT Project Developers and Contributors https://lib.openmpt.org/

October 2024 openmpt123 v0.7.11