Seth Woolley's Man Viewer

mocp(8) - MOC - console audio player - man 8 mocp

([section] manual, -k keyword, -K [section] search, -f whatis)
man plain no title

MOC(8)                         music on console(4,n)                         MOC(8)



NAME
       MOC - console(4,n) audio player


SYNOPSIS
       mocp [OPTIONS] [FILE ...]


DESRIPTION
       MOC  is  a  console(4,n) audio player with simple ncurses interface. It sup-
       ports OGG, wave, and MP3 formats. Just run mocp, go to  some  directory
       using menu(3x,n,n tk_menuSetFocus) and press enter to start playing file(1,n), program will be play-
       ing automaticaly rest of the files in(1,8) the directory.

       With no options and no file(1,n) arguments the  program  begins  in(1,8)  current
       directory  or in(1,8) MusicDir if(3,n) 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(7,n,1 builtins) in(1,8) the  configuration  file(1,n),  the  command
       line overrides it.


       -D --debug
              Run  in(1,8)  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(3,n) 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(1,8) 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(1,8) configuration file.


       -m --music-dir
              Start in(1,8) MusicDir (set(7,n,1 builtins) in(1,8) configuration file(1,n)). This can be  also
              set(7,n,1 builtins) in(1,8) configuration file(1,n) as StartInMusicDir.


       -a --append
              Append  files  given after options to the playlist. If there are
              any clients running with SyncPlaylist option set(7,n,1 builtins), add  to  their
              playlist or add directly to the server playlist if(3,n) not.


       -c --clear
              Clear  the  playlist. If there are any clientsrunning with Sync-
              Playlist option set(7,n,1 builtins), clear(1,3x,3x clrtobot) their playlist or  clear(1,3x,3x clrtobot)  the  server
              playlist if(3,n) not.


       -p --play
              Play  the first item on the playlist (clients' playlist if(3,n) there
              are any and SyncPlaylist is set(7,n,1 builtins) or the server playlist if(3,n)  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(1,n) will be
              searched in(1,8) /usr/share/moc/themes/ (depends on installation pre-
              fix), ~/.moc/themes/ and in(1,8) the current directory.


       -C --config FILE
              Use the specified config(1,5) file(1,n) instead of the default.


       -M --moc-dir DIR
              Use  the  specified  MOC  directory instead of the default. This
              also causes to use the config(1,5) file(1,n) from that directory. This can
              be also specified in(1,8) the config(1,5) file(1,n) 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(1,8)  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(1,3,5) and exit.


FILES
       ~/.moc  MOC directory for configuration file(1,n),  socket(2,7,n),  pid  file(1,n),  and
              other data.


       ~/.moc/config(1,5)

              Configuration  file(1,n) of MOC. Format is very simple, to see how to
              use it, look(1,8,3 Search::Dict) into example  configuration  file(1,n)  (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(3,n) the server is already running  at  the  time(1,2,n)  of
       executing mocp. The user is not warned about this.


HOMEPAGE
       http://moc.daper.net


AUTHOR
       Damian Pietras <daper@daper.net>



Version 2.2.2                  11 February 2005                         MOC(8)

References for this manual (incoming links)