Documentation:Preferences

Preferences overview
This is the preferences section. The appropriate dialog can be started by the menu bar of main frontend or the corresponding key sequence. The preferences dialog has three buttons at bottom. It should be clear what happens if click on "Apply" or "Cancel". The button default resets everything to the default values. But only for the active section. So when you are in the analog section and press on default only this setion will be affected. If you want to reset all values at a time you have to use the special button in the advanced part.

For most options the tooltips should provide enough to understand what they do.

General section


The general section is for some basic settings. First of all you have to set your language. Currently TV-Viewer is only available in english and german.

If you want the newsreader to check for news about the project you should activate the corresponding option. You may also choose the interval in days for checks.

To retrieve the TV program you can use an external application. There exist some exactly for this purpose like TV-Browser or nxtvepg. TV-Browser for example can even be used to schedule recordings for TV-Viewer. But you could also use just a web browser with an appropriate web link like

/usr/bin/firefox http://www.tvguide.com/

Analog section
This chapter covers the analog settings, which is very important to get your device to work with TV-Viewer.

On the first you tab you have to select your video device as well as the video standard, frequency table and the standard video input. Choose carefully here, this settings are crucial.

On the second tab you can manipulate the video and audio stream provided by your device. It is highly recommend to leave the video stream bitrate and hardware audio level as they are. Falls values can result in no audio or video. A useful setting is "Temporal filter". Especially if your picture is blurred, choosing a lower value may correct this.

DVB
Currently there are no options here. DVB support is planned for version 0.9.0.

Video
TV-Viewer uses MPlayer as backend to render the video and display it in the video window. Here you can configure MPlayer. Basic infos are provided by the tooltips. If you want to know more then you have to read through the MPlayer documentation or ask in their IRC channel (irc.freenode.net #mplayer)

Audio
Like in the video section this options are valid for the MPlayer backend. If you have questions here you should read the MPlayer documentation. If you have video but no audio you should try different audio output drivers and activate the option "Do not process MPlayer config files" in the advanced section.

Radio
TV-Viewer will support the radio tuner of your device with version 0.8.2

Interface
The first tab of the interface section let's you choose between different themes, you may enable or disable tooltips and so on. This tab should be self explanatory.

The second tab let's you configure some window properties and system tray behavior. With the option "Attach video window to main window" the video window won't get a separate entry in the taskbar and it will be logically linked to the main window.

TV-Viewer can have a system tray icon. Normally the main window will be docked and the video window will stay on your desktop. This behavior can be changed by the option "Dock video window". Additionally there is an option, if you close the main window it will be docked to the system tray. Closing the video window will always exit TV-Viewer.

The next tab deals with the on screen display. The OSD (on screen display) will show different informations like station name, volume level and many more in the video window. You can activate the OSD for windowed or full-screen mode and choose a font, size, style, color and the place where it should appear. The "station list mouse" is a special widget that contains a station list, from which you may choose a different station, and will pop up when the mouse cursor is at a defined location. There is also a station list which can be invoked by your remote control and be used to choose a different channel. This station list is only available in full-screen mode.

Record
This section covers settings for recordings and timeshift. The tooltips should provide enough informations for this options. On the second tab is an option called "Space to be left free". Here you may provide a value in Megabytes that should be left free on the chosen partition. This prevents timeshift from eating up all your free hard disk space. This option seems to cause problems on some machines and timeshift won't start. In this case set the value to "0", this will deactivate this feature.

Advanced
The first tab in the advanced section provides some more MPlayer specific settings as well as a special button to reset everything to default values. The option "Do not process MPlayer config files" may help if there are conflicting settings between MPlayer config files and TV-Viewer. This may result in no audio or video, and can be solved by activating this option. Changing aspect ratio handling is not recommended.

The second tab provides the possibility to supply TV-Viewers MPlayer backend with additional options and values. Informations about these options can be found in the MPlayer documentation.

On the last you can activate / or deactivate the logging of debug, warn and error messages. This files can be observed with the log file viewers.