xmms - Man Page

an audio player for X.


xmms [-h] [--help] [-n <session>] [--session=<session>] [-r] [--rew] [-p] [--play] [-u] [--pause] [-s] [--stop] [-t] [--play-pause] [-f] [--fwd] [-e] [--enqueue] [-S] [--toggle-shuffle] [-R] [--toggle-repeat] [-A] [--toggle-advance] [-m] [--show-main-window] [-q] [--quit] [-i <session id>] [--sm-client-id=<session id>]  [-v] [--version] [filename]...


XMMS is the X Multimedia System.  It is used to play audio and other kinds of media files.  By default XMMS can play MPEG audio, Ogg Vorbis, RIFF wav, most module formats and a few other formats.  XMMS can be extended through plugins to play a number of other audio and video formats.


XMMS accepts the following options:

-h,  --help

Show summary of options.

-n,  --session

Select XMMS session (Default: 0).

-r,  --rew

Skip backwards in playlist.

-p,  --play

Start playing current playlist.

-u,  --pause

Pause current song.

-s,  --stop

Stop current song.

-t,  --play-pause

Pause if playing, play otherwise.

-f,  --fwd

Skip forward in playlist.

-e,  --enqueue

Don't clear the playlist.

-Q,  --queue

Add file(s) to playlist and queue

-S,  --toggle-shuffle[=SWITCH]

Toggle the 'shuffle' flag.

Optional argument SWITCH may be either 'on' or 'off'

-R,  --toggle-repeat[=SWITCH]

Toggle the 'repeat' flag.

Optional argument SWITCH may be either 'on' or 'off'

-A,  --toggle-advance[=SWITCH]

Toggle the 'no playlist advance' flag.

Optional argument SWITCH may be either 'on' or 'off'

-m,  --show-main-window

Show the main window.

-i,  --sm-client-id

Set session manager identification.

-v,  --version

Print version number and exit.

-q,  --quit

Close remote session.


XMMS supports WinAmp style skins.  Skins may be stored in either archived (.zip, .wsz, .tgz, .tar.gz,  or .tar.bz2) or unarchived format.  XMMS looks for skinfiles in /usr/share/xmms/Skins, ~/.xmms/Skins, and locations specified by the SKINSDIR variable.


Global keybindings for XMMS:

zPrevious song
bNext song
lPlay file
jJump to file
rToggle Repeat
sToggle Shuffle
Shift + lPlay directory
Control + lPlay location
Control + pPreferences dialog
Control + vVisualization plugin dialog
Control + rTime remaining
Control + aAlways on top
Control + wWinshade mode
Control + dDoublesize mode
Control + eEasy move
Control + jJump to time
Control + zStart of list
Control + nNo Playlist Advance
Control + 3File info dialog
Control + Alt + wToggle Equalizer winshade mode
Shift + Control + wPlaylist winshade mode
Alt + wHide/show mainwindow
Alt + eHide/show playlistwindow
Alt + gHide/show Equalizer
Alt + sSkin selecting window

Main window specific:

Arrow key upVolume up 2%
Arrow key downVolume down 2%
Arrow key rightSkip 5 seconds forward in song
Arrow key leftSkip 5 seconds back in song

Playlist window specific:

Arrow key upUp one step in playlist
Arrow key downDown one step in playlist
DeleteRemove selected songs from playlist
Control + DeleteKeeps the selected tracks and removes the rest
QQueue/Dequeue the tracks selected
Shift + QClear the queue list
Alt + QQueue manager
Page UpMove one page up
Page DownMove one page down
HomeFirst page in playlist
EndLast page in playlist
EnterPlay selected song
InsertAdd file dialog
Shift + InsertAdd directory dialog
Alt + InsertAdd url dialog

Equalizer shade mode specific:

Arrow key upVolume up 2%
Arrow key downVolume down 2%
Arrow key rightBalance 4% to right
Arrow key leftBalance 4% to left



Users xmms configuration.


Default playlist usually loaded on startup.


Users set of xmms-specific GTK config settings. Options such as widget color and fonts sizes can be set here.


Users set of keybindings.

~/.xmms/Skins, /usr/share/xmms/Skins

Default locations where XMMS should look for skinfiles.


Location of user installed plugins.



Colon separated list of paths where XMMS should look for skinfiles.


Tar command supporting GNU tar style decompression.  Used for unpacking gzip and bzip2 compressed skins.  Default is tar.


Command for decompressing zip files (skins).  Default is unzip.

Other Info

The webpage for XMMS is at http://www.xmms.org.  Here you can find info about XMMS, download the latest version, plugins, and skins.

See Also


Referenced By

wmxmms(1), xosd_display(3).

17 March 2004 Version 1.2.11 XMMS Manual Pages