Inhalt
Quick start
Launch the MOC terminal UI
$> mocpLaunch the MOC terminal UI in a specific directory
$> mocp [path/to/directory]Start the MOC server in the background, without launching the MOC terminal UI
$> mocp [[-S|--server]]Add a specific song to the play queue while MOC is in the background
$> mocp [[-q|--enqueue]] [path/to/audio_file]Add songs recursively to the play queue while MOC is in the background
$> mocp [[-a|--append]] [path/to/directory]Clear the play queue while MOC is in the background
$> mocp [[-c|--clear]]Play or stop the currently queued song while MOC is in the background
$> mocp --[play|stop]Stop the MOC server while it’s in the background
$> mocp [[-x|--exit]]man mocp
NAME
MOC − console audio player
SYNOPSIS
mocp [OPTIONS] [FILE ...]
DESRIPTION
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.
OPTIONS
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
Play the first item on the playlist (clients’ playlist if there are any and SyncPlaylist is set or the server playlist if not).
-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.
-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).
-h --help
Print list of options with short description and exit.
-V --version
Print program version and exit.
FILES
~/.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.
BUGS
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.
HOMEPAGE
http://moc.daper.net
AUTHOR
Damian Pietras <daper [AT] daper.net>
Debian related notes: Elimar Riesebieter <riesebie [AT] lxtec.de>mocp -h
$> mocp -h
Music On Console (version 2.6-alpha3)
Verwendung: mocp [OPTIONS] [FILE|DIR ...]
General options:
-D, --debug Turn on logging to a file
-M, --moc-dir=DIR Use the specified MOC directory instead of the default
-m, --music-dir Start in MusicDir
-C, --config=FILE Use the specified config file instead of the default (conflicts with '--no-config')
--no-config Use program defaults rather than any config file (conflicts with '--config')
-O, --set-option='NAME=VALUE' Override the configuration option NAME with VALUE
-F, --foreground Run the server in foreground (logging to stdout)
-S, --server Only run the server
-R, --sound-driver=DRIVERS Use the first valid sound driver
-A, --ascii Use ASCII characters to draw lines
-T, --theme=FILE Use the selected theme file (read from ~/.moc/themes if the path is not absolute)
-y, --sync Synchronize the playlist with other clients
-n, --nosync Don't synchronize the playlist with other clients
Server commands:
-P, --pause Pause
-U, --unpause Unpause
-G, --toggle-pause Toggle between playing and paused
-s, --stop Stop playing
-f, --next Play the next song
-r, --previous Play the previous song
-k, --seek=N Seek by N seconds (can be negative)
-j, --jump=N{%,s} Jump to some position in the current track
-v, --volume=[+,-]LEVEL Adjust the PCM volume
-x, --exit Shutdown the server
-a, --append Append the files/directories/playlists passed in the command line to playlist
-e, --recursively Alias for --append
-q, --enqueue Add the files given on command line to the queue
-c, --clear Clear the playlist
-p, --play Start playing from the first item on the playlist
-l, --playit Play files given on command line without modifying the playlist
-t, --toggle=CONTROL Toggle a control (shuffle, autonext, repeat)
-o, --on=CONTROL Turn on a control (shuffle, autonext, repeat)
-u, --off=CONTROL Turn off a control (shuffle, autonext, repeat)
-i, --info Print information about the file currently playing
-Q, --format=FORMAT Print formatted information about the file currently playing
Miscellaneous options:
-V, --version Print version information
--echo-args Print POPT-interpreted arguments
--usage Print brief usage
-h, --help Print extended usage
Environment variables:
MOCP_OPTS Additional command line options
MOCP_POPTRC List of POPT configuration files