# This is a configuration file for the MOC player. It should be named # 'config' and placed in the ~/.moc directory. As this file can specify # commands which invoke other applications, MOC will refuse to start if it # is not owned by either root or the current user, or if it is writable by # anyone other than its owner. All options are given with their default # values, and therefore commented. # Comments begin with '#'. # You can use quotes and escape ('\') in parameters. # # You can have variable values substituted by enclosing the variable name # as "${...}". (This only applies to the portion of the option following # the ' ='.) Variables are substituted first from the environment then, # if not found, from the configuration options. (Note that the value of # a configuration option substituted is that which it has at the time the # substitution variable is encountered.) If there is a naming conflict # between an environment and configuration variable, you may be able to # resolve it by using lowercase as the environment variable matches are # case-sensitive whereas the configuration variables are not. # # You can also use the form "${...:-...}" where the value in the second # position will be substituted if the variable name given in the first # position is unset or null. # # So, for example: # # MusicDir = /music/${USER:-public} # Fastdir1 = ${MusicDir}/mp3/rock # Fastdir2 = ${MusicDir}/mp3/electronic # Fastdir3 = ${MusicDir}/mp3/rap # Fastdir4 = ${MusicDir}/mp3/etc # # Variable names are limited to those accepted by the BASH shell; that # is, those comprising the upper- and lowercase ASCII characters, digits # and the underscore. # # If you need to use the "${" sequence for any other purpose, write "$${" # and it will be replaced by "${" and not treated as a substitution. # # Some options take lists of strings as their values. The strings are # separated by colons. Additional strings can be appended to the list # using "+ =" in place of a plain "=" to assign the value. For an example, # see the XTerms option. # # You can override any configuration option when you run MOC using the # '-O' command line option: # # mocp -O AutoNext =no -O messagelingertime=1 -O XTerms+=xxt:xwt # # This command line option can be repeated as many times as needed and # the configuration option name is not case sensitive. (Note that MOC # does not perform variable substitution on the value of such overridden # configuration options.) Most option values are set before the # configuration file is processed (which allows the new values to be # picked up by substitutions), however list-valued options are overridden # afterwards (which gives the choice of whether the configured values are # replaced or added to). # Remember that the client and server are separate processes and the # server will retain the configuration values formed from the environment # within which it was originally started. # Show file titles (title, author, album) instead of file names? #ReadTags = yes # In which directory do you store your music files? If you specify it # you will be able to jump straight to this directory with the '-m' # parameter or the 'm' command. This can also point to a playlist. # # Example: MusicDir = "/home/joe/music" # MusicDir = ${HOME}/mnt/greeno-ntfs/media # Start in the music directory by default? If set to 'no', start # in the current directory by default. A single directory on # the command line takes precedence. StartInMusicDir = yes # Default FormatString: # # %n - Track number # %a - Artist # %A - Album # %t - Title # %(X:TRUE:FALSE) - Ternary expression: if X exists, do TRUE, # otherwise FALSE. The escape character must # be doubled (i.e., '\\'). (See zshmisc # documentation for more information.) # #FormatString = "%(n:%n :)%(a:%a - :)%(t:%t:)%(A: \(%A\):)" # Theme file to use. This can be absolute path or relative to # /usr/share/moc/themes/ (depends on installation prefix) or # ~/.moc/themes/ . # # Example: Theme = laras_theme # Theme = moca+_theme # Use mmap() to read files. mmap() is much slower on NFS. UseMMap = yes # FastDirs, these allow you to jump directly to a directory, the key # bindings are in the keymap file. # # Examples: Fastdir1 = /mp3/rock # Fastdir2 = /mp3/electronic # Fastdir3 = /mp3/rap # Fastdir4 = /mp3/etc # #Fastdir1 = #Fastdir2 = #Fastdir3 = #Fastdir4 = #Fastdir5 = #Fastdir6 = #Fastdir7 = #Fastdir8 = #Fastdir9 = #Fastdir10 = # Display full paths instead of just file names in the playlist. #PlaylistFullPaths = yes # Run the OnSongChange command when a new song starts playing. # Specify the full path (i.e. no leading '~') of an executable to run. # Arguments will be passed, and you can use the following escapes: # # %a artist # %r album # %f filename # %t title # %n track # %d file duration in XX:YY form # %D file duration, number of seconds # # No pipes/redirects can be used directly, but writing a shell script # can do the job. # # Example: OnSongChange = "/home/jack/.moc/myscript %a %r" # #OnSongChange = # Run the OnStop command (full path, no arguments) when MOC changes state # to stopped (i.e., when user stopped playing or changes a song). #OnStop = "/home/jack/.moc/myscript_on_stop"