Note: this wiki is no longer maintained. If you have any questions related to this wiki, please post them on the CrunchBang forums.

Translations of this page?:

AUDIO MOC (Music On Console) Installation & Configuration Guide

MOC (music on console) is a console audio player for LINUX/UNIX designed to be powerful and easy to use.

You just need to select a file from some directory using the menu similar to Midnight Commander, and MOC will start playing all files in this directory beginning from the chosen file. There is no need to create play lists like in other players.


First of all we will install the app with of course:

apt-get install moc

Then we will also install if needed the ffmpeg plugin:

apt-get install moc-ffmpeg-plugin

To configure MOC properly or to your likings we will need a MOC config, first start MOC with the command:



Now you can pull the config into your home folder with:
cd ~/.moc && cp /usr/share/doc/moc/examples/config.example.gz ./ && gunzip config.example.gz && mv config.example config

Now you can begin to edit the config file with your preferred text editor.

First of all, if you want that MOC starts with your music directory you have to go to this section:

#MusicDir               = "/home/joe/music"

and change it with your music path, for example if the music is on an external drive:

MusicDir               = "/media/External Drive/Música"

Now change this line to look like this:

StartInMusicDir         = yes

Now when you start MOC it will open straight into your music directory of choice, with the keystroke m you can always go directly back to your music directory.

With q you can close MOC, open it again and it should be set up with your music directory. With Q you can also shutting down the whole service, as MOC runs also as a server.


With T you can select some default themes, I prefer to use another one. That is also easy, just create a /themes folder in your /.moc directory, choose a text editor and create a file.

# Thank you Gutterslob & pvsage from #! forums!
# Example color theme for MOC.
# You can use a theme by copying it to ~/.moc/themes directory and using
# Theme config option or -T command line option.
# Fill free to make your own themes and send me them. It will be included in
# official MOC releases or on the MOC web site.
# The format of this file is:
# Lines beginning with # are comments.
# Blank lines are ignored.
# Every other line is expected to be in format:
# or
# Where names are case insensitive.
# ELEMENT is an element of MOC interface. This can be:
# background         - default background for regions when nothing is displayed
# frame              - frames for windows
# window_title       - the title of the window (eg name of the current
#                      directory)
# directory          - a directory in the menu
# selected_directory - a directory that is selected using arrows
# playlist           - playlist file
# selected_playlist  - see selected directory
# file               - an ordinary file in the menu (mp3, ogg, ...)
# selected_file      - see selected directory
# marked_file        - a file that is currently being played
# marked_selected_file - a file that is currently being played and is also
#                      selected using arrows
# info               - information shown at the right side of files
# selected_info      - see selected directory
# marked_info        - a file (its time) that is currently being played
# marked_selected_info - a file (its time) that is currently being played
#                      and is also selected using arrows
# status             - the status line with a message
# title              - the title of the file that is currently being played
# state              - the state: play, stop, or paused (>, [], ||)
# current_time       - current time of playing
# time_left          - the time left to the end of playing the current file
# total_time         - the length of the currently played file
# time_total_frames  - the brackets outside the total time of a file ([10:13])
# sound_parameters   - the frequency and bitrate numbers
# legend             - "KHz" and "Kbps"
# disabled           - disabled element ([STEREO])
# enabled            - enabled element
# empty_mixer_bar    - "empty" part of the volume bar
# filled_mixer_bar   - "filled" part of the volume bar
# empty_time_bar     - "empty" part of the time bar
# filled_time_bar    - "filled" part of the time bar
# entry              - place wher user can type a search query or a file name
# entry_title        - the title of an entry
# error              - error message
# message            - information message
# plist_time         - total time of displayed items
# FOREGOUND_COLOR and BACKGROUND_COLOR can have one of the following values:
# black, red, green, yellow, blue, magenta, cyan, white, default (can be
# transparent), grey (not standard, but works)
# Optional ATTRIBUTE parameters can be (from ncurses manual):
# normal      - default (no highlight)
# standout    - best highlighting mode of the terminal
# underline   - underlining
# reverse     - reverse video
# blink       - blinking
# dim         - half bright
# bold        - extra bright or bold
# protect     - protected mode
# You can specify a list of attributes separated by commas: attr1,attr2,attr3.
# Don't use spaces anywhere in such a list.
# With colordef you can change the definition of a color. It works only if
# your terminal supports it, if not those lines will be silently ignored.
# COLOR must be a valid color name and the RED GREEN and BLUE are numbers
# from 0 to 1000. Example:
# colordef red = 1000 0 0
# HINT: you have only 8 colors, but combined with attributes bold and/or
# reversed you actually get more colors.
# If you don't specify some elements, the default values will be used.
# Replaces the default configuration:

background        = default    default
frame            = default    default
window_title        = default    default
directory        = blue    default    
selected_directory    = blue    default    reverse
playlist        = default    default
selected_playlist    = default    default    reverse
file            = default    default
selected_file        = default    default    reverse
marked_file        = blue    default   bold
marked_selected_file    = blue    default    reverse
info            = default    default
selected_info        = default    default
marked_info        = blue    default    bold
marked_selected_info    = blue    default   bold 
status            = default    default
title            = blue    default     bold    
state            = default    default   
current_time        = default    default
time_left        = default    default    
total_time        = default    default   
time_total_frames    = default    default
sound_parameters    = default    default
legend            = default    default
disabled        = default    default
enabled            = blue  default  bold
empty_mixer_bar        = default    default
filled_mixer_bar    = default    default    reverse
empty_time_bar        = default    default
filled_time_bar        = default    default    reverse
entry            = default    default
entry_title        = default    default
error            = default    default    bold
message            = default    default    bold
plist_time        = default    default

I named it blue_theme. Now it will show up in the themes selection of MOC and you can use it. You need to change again this line:

# Theme                 = example_theme

with your theme of choice

Theme                 = blue_theme

and with the next start of MOC it will use your theme. You can also change the line for Xterm there.

LastFM Plugin

MOC does not have LastFM built in by default. Just install lastfmsubmitd with:

apt-get install lastfmsubmitd

and follow the instructions, you will be asked to set up your account. To make it work with MOC, we have again to edit the config. You have to go to this line and make it look like here:

OnSongChange = "/usr/lib/lastfmsubmitd/lastfmsubmit --artist %a --title %t --length %d --album %b"

Restart MOC and now it will scrobble your tracks, not as nice, as it will scrobble them immediately and not after 50 % of the played time e.g. but it works.

Equalizer settings

The last thing is to add an EQ.

Create a folder and name it e.g. eqsets. Now grab some presets from here, they are from Winamp: Put them in your EQ folder, with E you can enable/disable the EQ, with k you can switch through the different EQ presets. You can even make your own.

If you want more on MOC, just press h and it will give you all the keystrokes or look at the documentation on their site for more things.

Have fun with MOC.

Links & References

This installation and configuration guide is written by ivanovnegro and can be found on the forums.
#! Community themes for moc

howto/moc.txt · Last modified: 2012/05/31 20:13 by machinebacon
Except where otherwise noted, content on this wiki is licensed under the following license:CC Attribution-Share Alike 3.0 Unported

Powered by DokuWiki. Hosted by Linode.
Copyright © 2010 CrunchBang Linux.
Proudly powered by Debian GNU/Linux.
Debian is a registered trademark of Software in the Public Interest, Inc.