General requirements
From Mms-wiki
Contents |
[edit] Requirements
Before installing mmsv2 be sure that you have the following software packages installed.
Please note to compile mms you also need the development version of many of these libraries (this applies especially to Debian).
What is specified below is only for the core of mmsv2. For each of input, output and modules enabled refer to the requirements section of each one to determine what is required.
imlib2 GNU gcc GNU autoconf
[edit] Configuration
Various parameters may be set in the config file.
At top of the config file you'll find a version number
version = 18
Every time the config file is updated by the developers the number increases. MMS checks this version when it starts to make sure a correct version of the config file is present!
Tip: If mms doesn't start because of an invalid version number, lauch MMS in the command line mode. MMS reports you the version is needed to start correctly.
Here's a description of these 'General' configurations:
[edit] CD/DVD Path
So that MMS is able to use your CD/DVD you'll have to set the correct path for your CD-Rom. The default value is in most cases already correct.
# CD/DVD path # # The values on the first line must correspond to the values in # /etc/fstab for your dvd/cd drive # # The second line is just the device repeated and then the name of the # device as it will appear in the gui # cdrom = /dev/dvd, /mnt/cdrom/ cdrom_name = /dev/dvd, dvd device
[edit] Jump
Using Page Up/Down is quite helpful while navigating through long playlists or folder views. As MMS is able to use different resolutions on differnet devices the number of diplayed items may change. So with this parameter you're able to define Page Up/Down as you want it ...
# page_up and page_down jump range jump = 10
[edit] Idle Time
MMS checks for inputs. If there is no input for some time it assumes to be 'idle' and performs several background tasks, such as background thumbnail generation and/or id3-tag extraction. Note: it need to be enabled in the config. One of the most interesting feature is surely the audio-screensaver mode which kicks in after MMS assumes beeing idle
# idle_time is used to set after how long time mms should go into idle # mode. Idle mode currently supports screensaver for automatic # updating of epg and an audio screensaver that will kick in if audio # is playing. # # Valid values are integers and the time is measured in minutes. 0 # denotes disabled. idle_time = 0
[edit] Shutdown Script
In the unlikely event that you ever need to close MMS this option can be used to perform run scripts or commands.
Note: A gracefull kill (without the -9 switch) is also a valid option to shutdown MMS. Important informations will also be saved, such the vulome setting, the playlist position and you last playlist.
# Shutdown_script # # Command to run when mms is shutting down. # # Examples: # "shutdown -h now" will shut the computer down when quiting mms # shutdown_script =
[edit] Busy Indicator
Since version 1.0.8 MMS has a little indicator in the upper right corner showing if MMS is busy. Since version 1.0.8.1 there is no green indicator anymore, hence if you see nothing, it means MMS is ready for input commands.
Note: If you see a red busy sign, all commands are invoked on the Remote Control or Keyboard are cached. So use this with caution, else you end up in a menu or function, you've actually not intended to perform.
# Busy indicator # # Display status indicator in the right corner? # busy_indicator = true
[edit] Convert
Cause of being designed for UTF-8 encoding and multiple languages you've got two options to decide if converting should be done 'online' [FIXME:Whats does this exacly mean?]
# Convert # # Convert filenams in locale format to utf-8? # This option is needed if filenames on is encoded in a different # format than utf-8 # convert = false convert_locale = ISO-8859-1 # Specify the locale for mp3 tags. This can be used if the locale is # different than the filenames (eg. Russian) # convert_mp3_locale = ISO-8859-1
[edit] Tmp Files
Rescaled and converted pictures have their place in:
# Temporary scaled image location # Directory where scaled images are placed. # temp_image_loc = /tmp/mms
Note: If you want MMS to keep the files, you should change this to
temp_image_loc = /var/cache/whatever_you_want
or
temp_image_loc = /var/local/cache/whatever_you_want
But be sure the directories exist :)
[edit] Debug Level
This option is used to change the amount of debugging information returned in the console when running.
# The debug level # # Controls how much debug will be displayed # 0 = minimal info # 1 = info and warnings # 2 = info, warnings and critical errors # 3 = all info, warnings and errors # debug_level = 2
[edit] LCD
If you've got a LCD display to call your own, MMS is able to use it. It just requires you to have LCDd running.
# LCD - output audio information (Artist, title etc.) to a lcd display # lcd = no # Size of the lcd display # # Setting these incorrectly might cause memory leakage # lcd_rows = 4 lcd_pixels = 20
[edit] Eject
These are just paths and options passed to 'eject' (has to be installed) for ... right ... ejecting CDs/DVDs
# eject # eject_closeopts = -t eject_openopts = # eject binary path # eject_path = /usr/bin/eject
