Scroll to navigation

music123(1) General Commands Manual music123(1)


music123 - plays various sound files (usually including MP3, Ogg and Wav).


music123 [-DhiLlqrvZz] [-d ARG] [-@ ARG] [--] files ...


music123 is a shell around various command line programs to play music files. It will descend directories trees with -r, and randomize file lists with -z. The programs used and the options given them are listed in /etc/music123rc or ~/.music123rc.


Equivalent to -d0. May make music123 harder to kill.
Customize the time music123 delays between songs. -d takes one argument, expressed in seconds, which may have a fractional part.
Show command help and exit immediately.
Ignore case of file path extensions. For example, .ogg and .OGG are considered equivalent.
Loop at the end of the playlist.
List files and exit immediately.
Quiet mode. No messages are displayed.
Recurse into directories, instead of ignoring them.
Redirect standard input, allowing q or Q keys to stop after current file. The player will not see its standard output anymore.
Display version information and exit immediately.
Randomize the song list once before starting to play. music123 will shuffle the list once and for all, then play the songs without repetition (and repeat the selected order over and over with -l).
Pick up a song after the other randomly and endlessly, possibly playing a given song twice in a row, or never playing a given song. This disables -l and -z options.
Play the files listed in the mandatory argument of -@. Other files can be added on the command line, and this option can be given several times. Note that music123 doesn't yet play URLs.
End option list. Following arguments are interpreted as file names, even if they start with a dash.


Play three songs:

music123 test1.ogg test2.mp3 test3.wav

Play a couple of directories and other songs at random:

music123 -rz Rock/ test1.ogg Pop/ test4.wav

Play a playlist then a strange file name with a delay between the songs:

music123 -d 6.0 -@playlist -− -strange.ogg


Describes which programs music123 uses, which files types it supports, and which options it passes those programs.

Per-user config file to override the system wide settings.


David Starner <>, Xavier Grave <>, Nicolas Boulenguez <>
July 24, 2002