|
Up | Home | |
This is the top-level tag of all boxstar config files.
Profile tags may appear anywhere within a document. The tag's content is a profile name, corresponding to a file in a profiles directory. Each profile is only loaded once (repeated referenes will be silently ignored) and profiles may refer to other profiles. BoxStar comes with the profiles directfb, dfbmga, ntsc and pal.
Env tags may also appear anywhere within a document and must contain a name attribute. They cause system environment name to be set to value value, which defaults to 1 if the attribute is ommitted. This tag is useful for configuring SDL drivers and external players.
The value of this tag specifies the delay in seconds to wait for more digits when a number is being entered. If no digit is pressed in the meantime the number is assumed to be complete. Default 2.5 secs.
Options pertaining to the display.
The width and height of the display respectively, determining the window size or screen mode. The default is 640x480.
The colour depth (number of bits per pixel) to use for the display. The default value is 0, which means use the most appropriate setting for the system.
Set to 1 to make BoxStar take over the whole screen, 0 to use a window (driver permitting). This option is passed on to video players.
Sets the number of pixels to leave blank around each edge of the screen. The value inside the tags sets the value for all four edges at once. Each edge may also have its own value by using the following attributes.
A section for configuring how BoxStar uses the SDL library.
Set to 1 to make BoxStar ignore input events from SDL, 0 for normal behaviour.
Affects which keys auto-repeat can be enabled for. Valid values are:
The default is "all".
The content of these two tags are respectively the delay and interval settings for keyboard auto-repeat in ms. If used, they must both be specified.
Usually BoxStar will retain its SDL surface (ie leaving the window open in a windowed environment). This is inappropriate for some drivers, so setting this option to 1 causes SDL to be temporarily shut down while running external applications such as video players.
Add this tag at the top-level to enable the "devinput" driver. This makes BoxStar respond to Linux input device events, an interface used by some remote controls, especially ones attached to DVB cards. Use either the dev or match attribute but not both. You may specify this tag more than once to use multiple devices.
Use the specified device pseudo-file eg /dev/input/event0.
The value of this attribute is a regular expression. BoxStar scans the names of available input devices and uses the first device to match the expression. You may check the names yourself by reading /proc/bus/input/devices.
The kernel drivers are quite poor at debouncing keypress events for some devices. You can make them a little easier to use with this tag. It takes one attribute:
The delay before a key starts auto-repeating, specified in seconds; may be a floating point value.
This is the same as SDL's repeat option except that the default is "cursor".
Even with the debounce option some devices are very tricky to use. Add this tag to disable auto-repeat for them.
The media section configures a set of entries in the top-level menu for browsing and choosing files such as videos to play.
Defines a DVD drive. When this is opened from the menu BoxStar mounts the disc if necessary and scans its contents, taking appropriate action for DVD video, (X)(S)VCD or data discs. The attributes are mandatory.
The title to use for the drive in the menu.
The system device name eg /dev/dvd.
The mount point for discs eg /media/cdrom0.
Identical to a dvd entry but doesn't handle DVD video discs.
When browsing for files, only files matching a regular expression in one of these tags are shown. This is useful to make sure only files whose extension indicates they're a media file eg .mpg or .avi are shown. More than one match tag may be used, or none to show all files. They only affect files, not directories.
Each filemenu tag adds an entry to the top-level menu. When the entry is seelected it opens a submenu to browse for media files in the specified directory. The attributes are mandatory.
The title to be shown in the top-level menu and as the submenu's title.
The directory to start browsing from. You may embed variables and/or use a leading ~ to represent the home directory.
Usually hidden files and directories (whose names start with a period) are not shown. Set this attribute to 1 to show hidden files and directories.
Configure how BoxStar calls MPlayer.
Most widescreen TVs have an option or set of options to deal with 4:3 which work better than scaling the picture with the PC hardware or software. Giving this option makes MPlayer assume the TV is 4:3 when playing 4:3 videos and widescreen when playing widescreen videos. You can specify your monitor's aspect ratio as the content of this tag or leave out the content to use the default 16:9.
With this enabled (set the value to 1) BoxStar controls MPlayer via its slave mode. This is useful if you have a remote control and don't want to set up LIRC for MPlayer.
Set to 1 to disable LIRC in MPlayer only when in slave mode. If you want LIRC to always be disabled, do so with .mplayer/config or pass -nolirc in <video_opts>.
A config file with a slavemap section is provided as config/boxstar/mplayerslavemap. You can override it with your own slavemap section; it would be a good idea to use the supplied file as a starting point and example showing all the available action names. If you provide your own it will override all the entries in the provided one.
Maps a BoxStar input action to MPlayer commands. Currently only commands for playing video files are available.
The BoxStar input action name. See the provided map or boxstar/keycodes.py for all available names.
Whether to allow auto-repeat on this key (1 or 0).
The command to send to MPlayer when being used to play a video file. See MPlayer's slave.txt file, which should also be available as tech/slave.txt or tech/slave.txt.gz within your MPlayer package's documentation or its source tree.
A set of options (space-separated) to pass to MPlayer to make it analyse a video file instead of playing it. You should not need to change this from the default value of "-ao null -vo null -identify -frames 0 -nolirc".
Add extra options to MPlayer's command line when playing videos.
Add a basic option eg -fs. More than one option may be specified in each tag, separated by spaces.
Set this attribute to 0 if for some reason you need to pass an option containing spaces as a single argument.
Some of MPlayer's options are compound eg to pass parameters to a specific driver or to build a filter chain. The <suboption> tag allows these sorts of options to be built up from separate tags, whereas the basic <option> tag would force you to specify every attribute to the option in one go. For example, to add a crop filter without having to know whether any other video filters have been activated (actually this is a poor example because the order of filters is important):
<suboption name="-vf">crop:640:480</suboption>If you wanted to configure the dfbmga driver to use PAL independently of other dfbmga parameters:
<suboption name="-vo dfbmga" sep1=":" sep2=":">tvnorm=pal</suboption>
Add this tag at the top-level to enable boxstar's interface to VDR.
This feature allows BoxStar to control VDR by passing translated key or remote control presses to VDR via its remote plugin or its SVDRP interface (using the HITK command) while running xine or similar for watching VDR's output. To exit VDR mode use the "Power" button.
Using SVDRP is not recommended because it can only support one client at a time so you won't be able to use boxstar at the same time as vdradmin for instance. On the other hand the remote plugin stops responding every so often and you have to keep exiting to boxstar and reentering VDR mode.
If this tag is present its contents are treated as a command to run to watch VDR's output. It will simply be killed when you press the Power button. If the tag is empty the default value is "xine vdr:/tmp/vdr-xine/stream#demux:mpeg_pes".
Use this tag if you want boxstar to control VDR via the remote plugin. It takes these attributes.
The hostname. May also be expressed as a dotted numerical address. Defaults to "localhost".
The port expressed as a number. Defaults to 3333.
Some keys on a remote control may have more than one action assigned to them eg Left/Right = Volume Down/Up. If this child tag option is set to 1 all the actions are sent to VDR. If 0 (default) only the first action is sent.
Use this tag if you want boxstar to control VDR via the SVDRP server. It takes these attributes.
The hostname. May also be expressed as a dotted numerical address. Defaults to "localhost".
The port expressed as a number. Defaults to 2001.
VDR usually closes SVDRP connections after 300 seconds. The value can be changed in VDR or set to 0 to disable the timeout. You should either configure boxstar's timeout to a lower value to close the connection itself before VDR does or configure both to 0. The default here is 200.
The SVDRP option can have the following child nodes.
A SVDRP command to send immediately after connecting. No command is sent by default.
A SVDRP command to send immediately before disconnecting. No command is sent by default.
Some keys on a remote control may have more than one action assigned to them eg Left/Right = Volume Down/Up. If this option is set to 1 all the actions are sent to VDR. If 0 (default) only the first action is sent.
|
Up | Home | |