Installation basics
From Mms-wiki
Contents |
[edit] Description
author: Roman Müllenschläder
This is the rudimentary installation tutorial :-)
The tutorial is written for version 1.0.8 and is intended to be distribution independent!
[edit] Installation
[edit] Installation 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] MMS Installation
[edit] Preparations
First, create a folder, where the sources will be downloaded, for example:
cd /usr/local/src/ mkdir mms cd mms
You'll find information on how to get MMS in [FIXME download]
Install the required libraries and programs depending on your needs (see below). Extract the MMSV2 tarball
tar xvjf mmsv2-1.0.8.tar.bz2
run
./configure
with your preferences. To get a complete overview of how you can configure mmsv2 use the command
./configure --help
You'll find more detailed explanations in [FIXME compile-options]
After configuring run
make
in the mms directory.
make install
(you need to be root) will install mms and put configuration files into
/etc/mms/
and data files in
/usr/share/mms/
It will not overwrite existing mms configuration files or data files.
So if you're upgrading from an earlier version it's a good idea to check what has been changed in the configuration files
diff -Nur /path/to/old/file /path/to/new/file | less
and to just delete the
/usr/share/mms
directory so that you are sure to get the latest version of the data files.
You can install configuration files to
~/.mms
by running
make install-user
When the documentation henceforth mentions files in the path /etc/mms you should instead use ~/ if you are configuring mmsv2 as a local user.
After installing the software you should change mmsv2 to your needs by modifying the files (at least config and input-keyboard or input-lirc depending on your input device) in /etc/mms/ or ~/.mms to your needs.
You'll find further instructions on how to modify these files in [FIXME 4.Configuration]
[edit] Compile Options
[edit] Installation directories
- --prefix=DIR
- use this prefix for installing mms [/usr/local]
- --config=DIR
- use this configuration directory [/etc/mms]
[edit] Options
- --disable-audio
- Disable all music support
- --disable-audio-hd
- Disable music playback from harddrive
- --disable-radio
- Disable internet radio playback
- --enable-bttv-radio
- Enable radio tuner hardware playback (/dev/radio)
note: radio support must be enabled
- --disable-fancy-audio
- Disable fancy audio features like id3 tags, audio covers etc.
- --disable-xidle
- Disable Xidle for fancy audio
- --enable-gst-audio
- Use Gstreamer as audio player instead of Xine
- --enable-alsaplayer
- Use Alsaplayer as audio player instead of Xine
- --disable-movie
- Disable all movie support (mplayer)
- --disable-movie-hd
- Disable movie playback from harddrive (mplayer)
- --disable-fancy-movie
- Disable fancy movie features like downloading movie information from imdb.
- --disable-picture
- Disable all picture support
- --disable-picture-hd
- Disable picture viewing from harddrive
- --disable-epg
- Disable Electronic Program Guide
- --enable-picture-epg
- Enable pictures of channels instead of names for Electronic Program Guide
- --enable-game
- Enable game emulator support
- --disable-game-hd
- Disable game emulation from harddrive
- --disable-fancy-game
- Disable fancy game features such as covers
- --enable-tv
- Enable simple TV entry in startmenu
- --enable-lirc
- Enable lirc input
- --enable-evdev
- Enable evdev input
- --disable-sdl
- Disable sdl output
- --enable-dxr3
- Enable dxr3 output
- --enable-dvb
- Enable dvb output
- --enable-vgagl
- Enable vga gl output
- --enable-mpeg
- Enable writing the output to a mpeg file on disc
- --enable-fbdev
- Enable framebuffer output (deprecated, use SDL)
- --disable-cd
- Disable audio/movie/pictures features from cd/dvd
- --enable-eject-tray
- Enables open/close button within the startmenu
- --disable-nls
- Disable gettext
- --enable-benchmark
- Enable benchmarking, which can be used to search for bottlenecks
- --enable-debug
- Compile mms with debugging symbols (for gdb)and debugging messages
[edit] Further requirements
For further requirements see chapter 4.
