moc

moc [options]

-A | --append
    Append files to the playlist.

-c | --chdir directory
    Change the current directory.

-d | --debug
    Run in debug mode.

-D | --no-daemon
    Do not run as a daemon.

-e | --exit
    Exit the MOC server.

-f | --file file
    Specify a playlist file.

-h | --help
    Display help information.

-m | --music-dir directory
    Set the music directory.

-n | --next
    Play the next song.

-o | --on-the-fly
    Add files to the playlist and start playing immediately.

-p | --play
    Start playing.

-P | --pause
    Pause/unpause playback.

-q | --quit
    Quit the MOC server.

-r | --repeat
    Toggle repeat mode.

-S | --shuffle
    Toggle shuffle mode.

-s | --server
    Start the MOC server.

-t | --theme theme
    Specify a theme.

-u | --unshuffle
    Disable shuffle mode.

-v | --version
    Display version information.

-x | --exec command
    Execute a command.

The MOC (Music On Console) is a console audio player for Linux/UNIX. It supports various audio formats, including MP3, Ogg Vorbis, FLAC, and others. It's known for its simple user interface based on ncurses, making it lightweight and efficient for use on terminals or systems with limited resources. MOC operates on a server-client architecture, separating the interface from the playback engine. This allows for a persistent playback, meaning music continues playing even if the user closes the interface. The player is highly configurable and offers features like playlist management, directory browsing, and seeking within tracks. MOC is designed for simplicity and is ideal for users who prefer terminal-based applications or want a resource-friendly music player.

MOC reads its configuration from ~/.moc/config. This file allows customization of themes, audio output, keybindings, and more. The default configuration provides a good starting point, but users can modify it to suit their preferences. Comments are supported in the config file using the '#' character.

MOC offers various keybindings for controlling playback, navigation, and other functions. These keybindings can be customized in the configuration file. Default keybindings include keys for Play, Pause, Next, Previous, Seek, Volume control, and more.

mpg123(1), ogg123(1), alsa(7)