Specifying any argument results in displaying a short note about using this program.
is a small startup center for your multimedia box based on old computer hardware (or newer, if you can afford it).
can be started by selecting it in your desktop menu when looking into the Multimedia
section or by launching it from a terminal or even from a script like a custom ".Xsession" file.
It is configured through only one configuration file which can be found in "/usr/share/mediacenter/" on most systems. If you compiled this package on your own, the configuration may also reside in "/usr/local/share/mediacenter/".
When starting the application, it first looks for a user configuration file in the subdirectory ".mediacenter/" of his/her home directory. It is best practice to copy the example configuration file to this location after creating the directory on your own. Now you can make custom changes to the configuration without altering the example configuration file.
The structure of the configuration file is documented well inside the file itself and in the next section.
Configuration is done through a plain-text XML file.
It starts with a line indicating the program name. This makes it possible to specify configurations for further programs or dameons which might be implemented in future.
In this first line, you can but don't necessarily need to specify the following options:
showExit: Display a button for leaving the program in a very comfortable manner which makes the application look less nice ;-)
fullscreen: Start application in fullscreen mode. This is recommended for stations which only run this program or do not want the user to run any other program.
deactivateScreensaver: Disable the screensaver while this program is running.
verbose: Print additional information to stdout. When launching mediaCenter from menu, this information may be found in the user's home directory in file ".xsession-errors".
width: Width of the application window. Note that this option is superceded by the
height: Height of the application window. Note that this option is superceded by the
Options of type boolean
require their values to be "false" or "true" respectively.
s are just plaintext and read "as is".
values are read in decimal notation only and are not allowed to include any character apart from digits, i.e. 0, 1, ... , 9.
Up to 16 "launcherButton" elements may follow. Each one contains the following options:
name: Program name to display on the button. You can mark any letter as accelerator key by preceding it with an underscore (_).
defaultButton: Preselect this button when starting the program. This means that pressing RETURN or SPACE will launch the command associated with this button.
Now, each "launcherButton" element includes two child elements.
The first one is the command line to be executed; thus, its name is "commandLine". It may contain additional parameters, they are passed to the program; e.g.
would be used to have beep-media-player immediately start playing.
The second element specifies the icon. It is necessary to include the full path to the icon file. Additional options in the "icon" node are:
width: Width to scale the icon to.
height: Height to scale the icon to.
Make sure, that each "launcherButton" element is closed properly.
<mediaCenter showExit="true" showAccelerators="true"
fullscreen="true" width="560" height="640"
<launcherButton name="_Television" defaultButton="true">
<icon width="128" height="128">/usr/share/
Fabian Nowak <firstname.lastname@example.org>
This documentation has been written by Fabian Nowak on 2005-03-11.