MOC - console audio player

mocp [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 menu and press enter to start playing file, program will be playing automaticaly rest of the files in the directory.

With no options and no file arguments the program begins in current directory or in MusicDir if 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 recursively.

If an option can be also set in the configuration file, the command line overrides it.

-D --debug

Run in debug mode. Client and server logs 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.

-S --server

Run only the server and exit.

-F --foreground

Can be used only with -S. Run the server in foreground and log everyting 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.

-m --music-dir

Start in MusicDir (set in configuration file). This can be also set in configuration file as StartInMusicDir.

-a --append

Append files given after options to the playlist. If there are any clients running with SyncPlaylist option set, add to their playlist or add directly to the server playlist if not.

-c --clear

Clear the playlist. If there are any clientsrunning with SyncPlaylist option set, clear their playlist or clear the server playlist if not.

-p --play

Start playing from the first item on the playlist (clients' playlist if there are any and SyncPlaylist is set or the server playlist if not). If there are no clients running, it only works in conjunction with -a.

-f --next

Request playing the next song from the server's playlist.

-r --previous

Request playing the previous song from the server's playlist.

-s --stop

Request stop playing from the server.

-x --exit

Bring down the server.

-P --pause

Request pause from the server.

-U --unpause

Request unpause from the server.

-G --toggle-pause

Toggle between play/pause.

-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 in /usr/share/doc/moc/examples/.

-M --moc-dir DIR

Use the specified MOC directory instead of the default. This also causes to use the config file from that directory. This can be also specified in the config file using the MOCDir option.

-y --sync

This copy of the interface will be synchronizing the playlist with other clients. This option is calles SyncPlaylist in the configuration file.

-n --nosync

This copy of the interface will not be synchronizing its playlist with other clients (see above).

-A --ascii

Use ASCII characters to draw lines (helps on some terminals).

-i --info

Print the information about the currently played file.

-e --recursively

If you specify one directory at command line argument, make a playlist from files from this directory (recursively). Without this option MOC will just anter it after startup.

-h --help

Print list of options with short description and exit.

-V --version

Print program version and exit.

~/.moc

MOC directory for configuration file, socket, pid file, and other data.

~/.moc/config

Configuration file of MOC. Format is very simple, to see how to use it, look into example configuration file (config.example) distributed with the program.

~/.moc/themes

/usr/share/moc/themes

Default directories for theme files.

Command line options that affects 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.

http://moc.daper.net

Damian Pietras <daper@daper.net>

Debian related notes: Elimar Riesebieter <riesebie@lxtec.de>