Section: music on console (1)Updated: 25 December 2005Local indexUp
MOC - console audio player
[OPTIONS] [FILE ...]
MOC is a console audio player with simple ncurses interface. It supports
OGG, wave and MP3 formats. Just run mocp, go to some directory using
the menu and press enter to start playing the file. The program will
automatically play the rest of the files in the directory.
With no options and no file arguments the program begins in current
directory or in MusicDir if the StartInMusicDir option is set. If you
give a directory on the command line, MOC will try to go there. With
files or multiple directories, everything will be added to the playlist
If an option can be also set in the configuration file, the command line
Run in debug mode. The client and server log much information to debug
files. Don't use this, the server log is large. This is only available
if MOC was compiled without --disable-debug.
Run only the server and exit.
Implies -S. Run the server in foreground and log everything to stdout.
-R --sound-driver NAME
Use the specified sound driver. This can be OSS, ALSA or null (for
debugging). Some of the drivers could not be compiled in. This option
is called SoundDriver in configuration file.
Start in MusicDir (set in configuration file). This can be also set in
configuration file as StartInMusicDir.
Append files, directories (recursively) and playlists given after options
to the playlist. Don't start the interface.
Clear the playlist.
Start playing from the first item on the playlist.
Request playing the next song from the server's playlist.
Request playing the previous song from the server's playlist.
Request the server stop playing.
Bring down the server.
Request the server pause playing.
Request the server unpause playing.
Toggle between play/pause.
-k --seek N
Seek forward (positive) or backward (negative) by N seconds in the file
currently being played.
-T --theme theme
Use a theme file. If the path is not absolute, the file will be searched
in /usr/share/moc/themes/ (depends on installation prefix), ~/.moc/themes/
and in the current directory.
-C --config FILE
Use the specified config file instead of the default. An example can be found
-M --moc-dir DIR
Use the specified MOC directory instead of the default. This also causes
the config file from that directory to be used. This can be also specified
in the config file using the MOCDir option.
This copy of the interface will be synchronizing the playlist with other
clients. This option is called SyncPlaylist in the configuration file.
This copy of the interface will not be synchronizing its playlist with other
clients (see above).
Use ASCII characters to draw lines. (This helps on some terminals.)
Print the information about the file currently being played.
-Q --format FORMAT_STRING
Print information about the file currently being played using a format
string. Replace string sequences with the actual information:
It is also possible to use variables from the FormatString configuration option.
Alias for -a for backward compatibility.
Print a list of options with short descriptions and exit.
Print the program version and exit.
Adjust the mixer volume. You can set (-v 50) or adjust (-v +10, -v -10).
Followed by a list of identifiers, these will control MOC's playlist
options. Valid identifiers: shuffle, repeat and autonext. They can be
shortened to s, r and n respectively.
Example: -t shuffle,r,n would toggle shuffle repeat and autonext all at once.
-j --jump N
Jump to some position in the current file. N is number of seconds
followed by 's' or percent of total file time followed by '%'.
Examples: -j 10s, -j 50%
MOC directory for configuration file, socket, pid file and other data.
Configuration file for MOC. The format is very simple; to see how to use
it look at the example configuration file (config.example) distributed
with the program.
Default directories for theme files.
Command line options that affect the server bahaviour (like
--sound-driver) are ignored if the server is already running at the time
of executing mocp. The user is not warned about this.