-
Notifications
You must be signed in to change notification settings - Fork 26
Settings
I'll try to add a bit more info about the settings here. The code in brackets is either the internal setting name or the action that is performed.
Pop up the file commands.txt that shows the default keyboard button shortcuts.
You can get a good overview of the features of TVGF here.
A Readme file with help on setting up External Players or launching Python Scripts in response to an AutoPlayWith timer.
Currently only working in the White Snow addon. It shows an overlay of the invisible buttons in the epg and osd for navigation.
This is the most important page in the Settings.
XMLTV file source. File is for local content on your device or home network. Url is an internet server.
XMLTV file location.
XMLTV file url.
Save yourself a ton of time and bandwidth. This will look for the compressed xmltv file in the same location with a .gz suffix. If your server does automatic compression you probably can turn this off.
Another great time and bandwidth saver. If you have control of your xmltv server make an .md5 file of the source xmltv file on every update. The new xmltv file will only be downloaded when it changes.
Turn this off after one restart or your channel mappings will keep getting reset!
This will clean out most of the xmltv related tables in the source.db internal file on the next start. It is useful when you change xmltv files and have some left-over channels with no program data. There are more reset functions in the Reset Database tab. If you really get stuck delete everything manually in the addon_data\script.tvguide.fullscreen folder.
How often the guide will try to download a new xmltv file on start. "Every start" can be useful for trouble shooting. Turn it on once to force an xmltv reload. The preferred and least intrusive way to update the xmltv data is in "Startup \ Background Update Service".
The only way to identify some Movies is if they have a 4 digit year in the date field. Use this if that is how your xmltv data is formatted. Others have the year in the title eg "Star Wars (1977)".
More server data but optional.
Try to use the user and password below to grab the xmltv file and other ini files in this page.
User name for authentication.
Password for authentication.
If you set up all your channel to stream mappings on one device and want to sync the rest of your devices with that device this could be useful.
addons.ini is the main magic file that let's you map an xmltv channel to an addon stream. This setting will import addons.ini from an external location. You can merge it or let it overwrite your local addons.ini file.
addons.ini source location: local or internet server.
addons.ini local file location. On your device or local network.
addons.ini server url.
Overwrite your addons.ini file or just merge the new file from the server.
This will let you add several m3u playlists to the addons.ini file.
Add and remove m3u playlists from the subscription list.
Force refreshing all the Folders that you have added to addons.ini in "TVGF \ Menu \ Stream Setup \ Browse \ \ \ Add Folder"
Categories in this section are Channel Categories that can filter your channels by a user defined category. eg Sports or Kids.
Load Channel Categories from an external file.
categories.ini source type: local network or internet.
Local device or network categories.ini file.
Internet url for categories.ini file.
Restart TVGF with the last Channel Category still selected.
Channel Mappings map the xmltv channel name to an addon stream or url. You can force the mappings in this section.
Import a channel to stream mapping.ini file on start.
mappings.ini local or internet location.
mappings.ini local network file.
mappings.ini internet url.
Use an .m3u file for the channel mapping file mapping.m3u
Internet or local network mapping.m3u location.
Local network mapping.m3u file location.
Internet mapping.m3u url.
If you are lucky your xmltv file will contain urls for channel logos. If not you will have to make or find a folder with logos that correspond to the channel names in the xmltv file.
Show the channel logos if they can be found. If not just show a text string with the channel name in the main epg.
Use a local network or internet path for the logo folder.
Local logo folder.
Internet logo folder url.
If you have used the "TVGF \ Channels \ Logo" functions to map up logos to channel names turn this on to prevent losing the customization on the next xmltv update.
Use the channel logos from the xmltv file if they exist.
Use logos from addons streams if they exist.
Look up channel logos from the TheLogoDB.com always, if missing or never. Channel name matching is hit and miss.
Delete TheLogoDB.com logo cache in "userdata\addon_data\script.tvguide.fullscreen\logos".
Crop and Resize the logos in the logo folder to fit the current epg channels per page size. This works fine in Jarvis but was having some problems resizing images with the PIL python library in Krypton. If the logos don't resize properly use Jarvis.
The code to play HLS streams in Krypton was taken out for some annoying reason. That is why I still use Jarvis for channel surfing. HLS streams can take 10 seconds to start in Krypton whereas they start instantly in Jarvis. This setting may speed up pure HLS urls to only a couple of seconds. See this thread for more info https://trac.kodi.tv/ticket/17422
Addon to use for catchup handling. It needs to be a derivative of Meta4Kodi for the url to work such as metalliq. If you have set the players correctly you should be able to play any tv show episode or movie in an addon that can find the program based on its title, year, season and episode number.
This is one of three methods to launch a catchup service. The others are iSearch for Super Favourites type searches and Catchup Addon in Lab1 which can use freeform urls.
This is an experimental feature that doesn't work too well due to limitations in the receiving addons. If you have "catchup" as the url for a channel stream this will play the channel via Meta4Kodi or derivative from the start of the current program. A pseudo channel called Meta should appear as channel 1 in the epg.
The logic is not strong enough to deal with gaps between programs due to adverts or taking too long to automatically find a program and play it via Meta.
Use a numeric code to go straight to a channel. In the Default skin the channel number is shown in the top left as you type it.
The channel number can be the index of the channel in the xmltv file found in "TVGF \ Menu \ Channels" or use the channel id in the xmltv file. If you want to match a set-top boxes numbering scheme use xmltv id. You'll have to edit the Webgrab config file to set the xmltv id properly.
If you want the number keys to go directly to the channel use this. Normally the number keys are used for channel listings, program searches and timer lists.
If you turn this off you can map up a key to "Shift" to start the numeric input process.
Choose whether to scroll to the selected channel or play it.
Fixed number of digits to look for before playing the channel.
If you don't generate your own xmltv file you can use this to set the numeric xmltv ids. The file ends up in "userdata\addon_data\script.tvguide.fullscreen\channel_id_shortcut.ini"
If you have a dearth of buttons on your remote or a touch device this is a good option to choose to get to the Menu.
I think this option will pop up the Choose Stream dialog if you press enter on an already playing channel. (CHECK)
Try to play the Alternative Streams if the first one fails after a timeout.
If you have a Primary and Alterative Streams set for a channel you usually get a dialog to choose which one to play. This will just play the Primary but try the Alternative Streams if it fails to play.
Also try turning off Surface Codec in "Kodi \ System \ Player \ Videos \ Processing".
If you turn this off the streams will play with the normal Kodi video osd menus with Play controls and all the other Video and Audio menus. If you use the TVGF Osd you can get to the Kodi Osd with the Fullscreen button which is TAB on desktop devices.
This will try to play streams using xbmc.executebuiltin('XBMC.RunPlugin(%s)' % url). Some addons need this method. You can also set individual addon Folders or Urls to use this method in "TVGF \ Browse \\ Add Folder"
Timeouts for the "Try Other Alternative Streams if Play Fails" options above.
How long to always show the OSD after you start playing a channel.
How long to give an addon to play a channel before going on to the next one or giving up.
Keep playing a stream when you exit out TVGF. Good if you want to look for something else to watch while the current channel keeps playing.
Usually playback will start in a Fullscreen window with Osd. Use this for testing channels by having them start in the epg window, either in the background or the small PIP window.
When a channel is playing the Back button will flip between the epg and the fullscreen osd video. Use this for Back to exit TVGF from the epg when playing a channel.