|
|
The documentation on MTV is still a bit brief, but it will improve with time. IndexInstallationKeys Configuration Files InstallationThis section tells you how to install and configure the MTV app. Please be sure to have already installed your drivers and DirectX, see the Driver Info page for more details.To install the program, make a directory for the installation and extract the zip file into it. The program installs into a fixed directory structure, as follows, so make sure that you keep the directories in the zip file.
A set-up program is included in the file, find and run the tunein.exe program. Make sure you run it in the install directory. You will be presented with the following dialog. 
Select your video and audio sources, your tuner and crossbar devices and your video compressor. Leaving an entry blank causes MTV to choose the first it comes across, which is not necessarily the first in the list. Select OK and you will get the next dialog. 
Use the spin buttons, the frequency entry and the antenna/cable radios to find the channels. When you find a channel it will appear in the TV screen in the dialog. Please be patient, the interface can be a little slow. Then enter them in, setting their names, display names (4 chars for the LCD), frequency and type and add them with the add button. Note that the order you enter them in is important, the first in the list is channel 1 in the program. If you find channel 3 first, just add dummy channels 1 and 2, then use the update button to change them later. Click save when happy with your settings. The basic installation is complete, you are ready to run MTV. Find and run the mtv.exe file in the installations directory. See the Configuration Files section for information on how to set more complicated settings and how to change your config file by hand. Installing and Configuring for XMLTVIf you want XMLV to get your schedules, be sure to download it from http://sourceforge.net/projects/xmltv. Unpack it into the <MTV install dir>/xmltv directory. Run xmltv with the --configure param to set it up. Currently you will have to read the <MTV install dir>xmltv/.xmltv/tv_grab_XX.conf file (where XX is the region grabber you are using) to get the channel IDs and insert them into the config.xml file.KeysBelow is a list of the keys used in the application for both normal keyboards and for the Multitainer's remote control.TV KeysThese keys are active when watching normal TV (* - active during recording also).
Playback KeysThese keys are active when you are playing back a recorded programme.
Menu KeysThese keys are active when the full screen menu is visible.
Popup KeysThese keys are active when you have activated the popup with the OK button when watching TV.
Configuration FilesThis section details the configuration files for MTV. These files now use Xerces for parsing, so all allowed XML encodings should be supported.The config.xml FileThis file holds information on what filters to use in the graph, and what channels live where. The tunein app writes this file, but it is here for completeness. Below is an example for this file:
<?xml version="1.0" encoding="UTF-8"?>
<MTV>
<graph vidsource="Conexant" audsource="" tuner="Conexant" crossbar="Conexant" compressor="DivX"/>
<tuner>
<channel id="1" name="SVT 1" frequency="68" display_name="SVT1" type="antenna" grabber_id="10.dagenstv.se"/>
<channel id="2" name="SVT 2" frequency="68" display_name="SVT2" type="antenna" grabber_id="11.dagenstv.se"/>
<channel id="3" name="Viasat 3" frequency="68" display_name="VIA3" type="antenna" grabber_id="12.dagenstv.se"/>
<channel id="4" name="Kanal 4" frequency="68" display_name="K 4" type="antenna" grabber_id="13.dagenstv.se"/>
<channel id="5" name="Kanal 5" frequency="68" display_name="K 5" type="antenna" grabber_id="14.dagenstv.se"/>
<channel id="6" name="Discovery Remix" frequency="68" display_name="DISC" type="antenna" grabber_id="15.dagenstv.se"/>
<channel id="7" name="Eurosport" frequency="68" display_name="ES" type="antenna" grabber_id="16.dagenstv.se"/>
<channel id="8" name="Viasat Z" frequency="68" display_name="TV Z" type="antenna" grabber_id="17.dagenstv.se"/>
<channel id="9" name="MTV" frequency="68" display_name="MTV" type="antenna" grabber_id="18.dagenstv.se"/>
</tuner>
<schedule_grabber params="tv_grab_sn --days=7" run_path="xmltv/"/>
</MTV>
The graph section describes the filters to use in building the TV graph.
The vidSource, tuner, and crossbar attributes hold the filter names for the TV capture card.
The audSource attribute holds the filter name for the sound card.
The compressor attribute holds the filter name for the video compressor (audio is not currently compressed).
When building the graph, MTV enumerates the filter and picks the first that matches. The matching is case insensitive.
Leaving the name blank will match the first filter found.
The tuner section holds information on the channels. Each channel has an index attribute, indicating its number in the sequence. It is important to note that each value between 1 and the last channel must be filled, otherwise channels after the missing index value will be ignored. Channels have name and display_name attributes, the name is shown on screen, and the display_name on the Multitainer's LCD display. display_name values should not be longer than 4 characters. Finally, the type and frequency attributes specify how to tune into the channel. Types are currently "antenna" and "cable", but I intend to add "av" at some point with control for my satellite box (Echostar AD300IP). The frequency value is the channel frequency. The grabber_id for a channel is used when grabbing the schedule. XMLTV uses these IDs to identify which programme is on which channel, we need to have the right ID in order to transfer the schedule to our internal format correctly. The schedule_grabber section gives the run-time parameters for the grabber (currently XMLTV only). The params for execution are given in the params attribute, and the directory to run XMLTV in is stored in run_path. The first param to XMLTV is the region grabber you want to use and then any other options you want. I use tv_grab_sn for Sweden, and want 7 days schedule to be grabbed, so my params are "tv_grab_sn --days=7". run_path is important because XMLTV needs to find files in its main directory. The conditions.xml FileThis file holds the matching information for automatic marking of programmes for recording. Currently only the name_includes attribute is used for matching, but I intend to expand this soon to include channels and times.<?xml version="1.0" encoding="UTF-8"?> <conditions> <condition name_includes="Futurama*" priority="10"/> <condition name_includes="*Buffy*" priority="9"/> <condition name_includes="*Xena*" priority="8"/> <condition name_includes="*Stargate*" priority="7"/> <condition name_includes="Vänner*" priority="6"/> <condition name_includes="Scrapheap Challenge*" priority="5"/> <condition name_includes="Junkyard Wars*" priority="4"/> <condition name_includes="Simpsons*" priority="3"/> </conditions>Firstly, matching on the names is done case insensitively. The * wildcard letter can be added to allow 0 or more characters to exist between sections. The File above matches all programmes with Buffy anywhere in the name (*Buffy*), but only programmes beginning with Futurama (Futurama* - note the missing * at the front). Once a programme has been matched, it is stored in a list. This list is then run through the conflict resolution algorithm, which looks for the best combination of programs to record. In general, it takes all the programs that clash and looks for the combination giving the highest priority. So, given the file above, and programme times below:
The program will choose to record Buffy and Stargate (giving a result of 9+7=16) instead of Simpsons, Scrapheap Challenge and Stargate SG1 (giving a result of 3+5+7=15). The schedule-x.xml FilesThese files hold the schedule information for channel x, so channel 1 (SVT1 in my set-up) has its schedule information stored in the schedule-1.xml file.
<?xml version="1.0" encoding="UTF-8"?>
<schedule>
<programme channel="1" start_time="2003-05-28 12:10:00" name="Poesigeneralen"
type="programme" description="Film..." end_time="2003-05-28 13:40:00" />
<programme channel="1" start_time="2003-05-28 13:40:00" name="Superman - Stålmannen"
type="programme" description="(Superman the movie)..." end_time="2003-05-28 16:00:00" />
<programme channel="1" start_time="2003-05-28 16:00:00" name="Rapport"
type="programme" description="Text-tv 199." end_time="2003-05-28 16:05:00" />
<programme channel="1" start_time="2003-05-28 16:05:00" name="24 minuter"
type="programme" description="Pratshow. Gäst:..." end_time="2003-05-28 17:00:00" />
<programme channel="1" start_time="2003-05-28 17:00:00" name="Sara Lidman - att leva på skaren"
type="programme" description="Sara Lidman..." end_time="2003-05-28 17:30:00" />
</schedule>
The programme has name and description attributes, which are pretty obvious.
The start_time and end_time attributes hold the start and end times in YYYY-mm-dd HH:MM:SS format and in local time.
The programme type "programme" or "film" isn't really currently used, as I can't find a web TV guide here that gives
you the type (I used it before I moved here).
XMLTV is now used for getting schedules, see above for more info on installing XMLTV.
|
