Config file
From Mms-wiki
Contents |
[edit] The MMS configuration files
[edit] config
Basicly there are three config files for MMS. The most important one is
/etc/mms/config
or
~/.mms/config
Depending on if you did a "make install" or "make install-user"
- Here the very basic functions of MMS are determined. In this file you have to decide the kind of input and output you want to use. Configuration is a must, although MMS will most likely start without you having adjusted the values in it, but also most likely not to your needs.
For version 1.1.0 it is
/etc/mms/Config
In version 1.1.0 select the preferred input method in /etc/mms/Config. For example
# Input device # # choose between: keyboard, lirc and evdev # # input = lirc input = keyboard
[edit] lirc
- If you want to use lirc, this config file is responsible for the key-mappings on your remote control. You definitely have to configure this. Take your time!
/etc/mms/input-lirc
or for version 1.1.0 there are many lirc configuration files at the directory
/etc/mms/input/lirc/
To get started in 1.1.0 edit the /etc/mms/input/lirc/default
[edit] evdev
- If you want to use evdev (gamepad, joystick), this config file is responsible for the key-mappings on your remote control. You definitely have to configure this. Take your time!
/etc/mms/input-evdev
[edit] keyboard
- The configuration of the keyboard is possible, but not necessary, because the default values are good to go with. Edit this file, if you don't like the default settings. If you want to know how the keyboard is mapped, press Space Bar for the extra-menu, there you can see how the keyboard is mapped.
/etc/mms/input-keyboard
For version 1.1.0 the keyboard configuration files are located at
/etc/mms/input/keyboard/
[edit] /etc/mms/config OR /etc/mms/Config in 1.1.0, big difference in unix :-)
A detailed description of the config file can be found here:
This little section is just a quick start, and is far from beeing complete.
Generally, You don't need to care about the output device entry in the config file. MMS generates a valid entry in the config for you, depending on the switch you used for the output. (At the moment this is only true for sdl and dxr3)
- for an output via X11 use this configure line, plus your own switches.
./configure
MMS default to sdl for you automatically.
- for DXR3 output do this:
./configure --enable-dxr3
After you have done so, perform the usual compilation
make && make install
Here is a overview of available output devices.
[edit] Output Device
- The output device tells MMS which method of display to use and will depend on your specific hardware for the best results. dxr3 and dvb are for specialised decoder cards while SDL and OpenGL will work with a wide variety of accelerated video cards.
# Output device # # choose between "dxr3", "fbdev", "dvb", "vgagl", "sdl" and "opengl" outdev = sdl
- sdl is working with all sdl-capable outputs like X11, Framebuffer (vesa or specific), DirectFramebuffer (dfb)
- dxr3 is for em8300 based mpeg-decoder cards called DXR3 or Hollywood+
- fbdev is deprecated ... use sdl instead for output on framebuffer console
- dvb is for usage with FullFeatured TV cards (with hardware mpeg-decoder) like Technotrends or Hauppauge DVB cards (oftenly used in combination with VDR)
- vgagl is for VGA-GL output :)
- opengl is for opengl compliant video cards. It supports basic animations like fade-outs and zooming effects if you enter or leave a menu respectively.
Note: You decide what output device mms is able to use when compiling with compile options (f.e. --enable-dxr3)
[edit] Input Device
- Do you want to use a remote control (lirc) or keyboard? When using USB-Devices (remotes), joystick, touchscreen or any other evdev capable device for Input, you'll going to use evdev
# Input device # # choose between "keyboard", "evdev" and "lirc" input = keyboard
- Note: Multiple entries are possible!
[edit] Audio Content Location
- Here's the beef. Tell MMS where your music collection is
# Directories # # you can add several folders by simple having multiple entries # audio_dir = /stuff/music/
Note: Multiple entries are possible!
[edit] Video Content Location
- Let us round up the configuration by telling MMS where your video content is
# Directories # # you can add several folders by simple having multiple entries # mov_dir = /stuff/movies/
Note: Multiple entries are possible!
[edit] Picture Content Location
- Last but not least, tell MMS where to look for your pictures on your harddisk, and which folders you want to exclude from being shown. This is usefull, if other applications left their smut there ;-) (MMS doesn't pollute your media-content directories, never!)
######### PICTURES ##########
# Directories # # you can add several folders by simple having multiple entries # picture_dir = /data/Fotos/
# Pictures dirs to exclude # # Exclude dirs with the following names from coming up in pictures # You can specify as many as needed # # Eg. #exclude_picture_dir = .xvpic exclude_picture_dir = .xvpic exclude_picture_dir = .xvpics exclude_picture_dir = tn
- above is an example of multiple entries
[edit] /etc/mms/input-lirc
This is for version 1.0.8.x Configuring this file could be tricky. But it don't have to. Just read this little section. If you wan't to use lirc aka "remote control for linux", you have to set up lirc first[1]]. You will come up with this file:
/etc/lirc/lircd.conf
The keys in lircd.conf have now to be mapped onto MMS-functions in the
/etc/mms/input-lirc
And now it's getting important:
- first map all keys that have these prefixes. Here no keys can be mapped twice!
general
and
audio_general
- TIP: print out lircd.conf and strike out the keys you have already mapped.
The keys, that are not mapped yet, can be mapped now in every of these blocks:
choose_playlist graphical pictures pictures_fullscreen graphical_movie graphical_audio audio_add playlist
This means, that the keys which are left, can occur in every of these blocks (playlist, pictures...etc). Or in other words: All keys that are not mapped in the general and audio_general block can be multiple mapped in each of these blocks mentioned above.
There are two exceptions(!):
- search: has its own mapping. Be sure not to use anyone of 0-9 since they are used for entering letters. The other keys can be chosen regardless of any mapping in other modules.
- graphical: The mapping for 'info' in 'graphical' must not occur in
graphical_movie graphical_audio audio_add playlist
The best way to explain this, is to look at the graphic at the end of this section.
A sample of a /etc/lirc/lircd.conf and a /etc/mms/config can be found in the example section.
- You can also try this tool (input-lirc-helper) to create your input-lirc.
[edit] Input-lirc Description table
If you are not certain about the key you want to map, and you like to know what this key is doing, then look it up in this table.
[edit] MMS module dependencies
- Or a graphic can say more than a thousand words. You can verify on your own whether your keymapping conflicts or not. Take a key you want to map. E.g: reget in the audio_graphical module, so just follow the tree upwards. Every module you cross on your way up must not already contain your definition. This means, if you've chosen e.g. the key "1" on your remote control for this function, it must not already be defined in the modules graphical, audio_general nor general.
[edit] /etc/mms/input-keyboard OR in version 1.1.0 /etc/mms/input/keyboard/*
Configuration possible, but not needed. Look up this/these file(s), if you want to know how the keys are mapped, in order to use MMS. But you really don't have to. Press space bar to get an extra-menu, and you can look up the keys also. Edit this file if you don't like the default settings. Look up a function in this table, if you are uncertain about its meaning.
