Linux Certif

Toute la documentation sur la certification Linux LPI

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 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 recursively.

OPTIONS

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

-D --debug

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.

-S --server

Run only the server and exit.

-F --foreground

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.

-m --music-dir

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

-a --append

Append files, directories (recursively) and playlists given after options to the playlist. Don't start the interface.

-c --clear

Clear the playlist.

-p --play

Start playing from the first item on the playlist.

-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 the server stop playing.

-x --exit

Bring down the server.

-P --pause

Request the server pause playing.

-U --unpause

Request the server unpause playing.

-G --toggle-pause

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

-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.

-y --sync

This copy of the interface will be synchronizing the playlist with other clients. This option is called 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. (This helps on some terminals.)

-i --info

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:

State

%state

File

%file

Title

%title

Artist

%artist

SongTitle

%song

Album

%album

TotalTime

%tt

TimeLeft

%tl

TotalSec

%ts

CurrentTime

%ct

CurrentSec

%cs

Bitrate

%b

Rate

%r

It is also possible to use variables from the FormatString configuration option.

-e --recursively

Alias for -a for backward compatibility.

-h --help

Print a list of options with short descriptions and exit.

-V --version

Print the program version and exit.

-v --volume

Adjust the mixer volume. You can set (-v 50) or adjust (-v +10, -v -10).

-t --toggle

-o --on

-u --off

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%

FILES

~/.moc

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

~/.moc/config

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.

~/.moc/themes

/usr/share/moc/themes

Default directories for theme files.

BUGS

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.

HOMEPAGE

http://moc.daper.net

AUTHOR

Damian Pietras <daper@daper.net>

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