Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
OPENMPT123(1)			 User Commands			 OPENMPT123(1)

NAME
       openmpt123 - command line module	music player based on libopenmpt

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

DESCRIPTION
       openmpt123   v0.7.13,   libopenmpt  0.7.13+r22826  (OpenMPT  1.31.14.00
       https://source.openmpt.org/svn/openmpt/tags/libopenmpt-0.7.13@22826
       (2025-01-06T13:49:43.586768Z) clean) Copyright  (C)  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: 72]

       --terminal-height n
	      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]

       --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) [de-
	      fault: -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)  [de-
	      fault: 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

COPYRIGHT
       Copyright  (C)  2013-2025  OpenMPT  Project Developers and Contributors
       <https://lib.openmpt.org/>

openmpt123 v0.7.13		 January 2025			 OPENMPT123(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=openmpt123&sektion=1&manpath=FreeBSD+Ports+14.3.quarterly>

home | help