# WebGrab+Plus Quick start guide

## What is WebGrab+Plus

WebGrab+Plus, frequently simply refered to as WG++, is a generic webgrab tool that can grab tv listings from websites and create a xmltv file for it. This xmltv file can be fed to a PVR/EPG system to visualize the tv listing. Because WebGrab+Plus itself is generic, it will need to know how to grab a specific website. This info is packed into SiteIni files. For every supported tvguide-website, such a file will exist. See the EPG channels page for all available SiteIni's. Most tvguide-website's have multiple tv channels. To know what channels are available for a specific SiteIni (website), you can look into the accompanying .channels.xml file. This file contains a list of channels that can be used. All those files can be found in the siteini.pack folder.

A list of all features can be found on our website

## Installation

The program will run on the most platforms (windows, linux, osx, rasp pi) . To install it on any specific platform follow these installation instructions

Currently WebGrab+Plus is only a command line tool. An additional GUI (Graphic User Interface), the 'ConfigMaker', is available thanks to user shax. Download it from here or here

## License

The program will run without a license with limited performance and only with un-encrypted siteini's. To use its full capabilities a donator status is needed which requires a small donation of 5€ /year (2024). To get that, register on the website and donate using the Donate/support us button. See also How can I donate to get a donator_license ? and other related FAQ's.

On top of the standard donator status, the capabilities can be extended with a custom license and/or custom SiteIni. See I want more channels or more siteini's or more than 2 computers to run WG++

## How to use

1. Find the config file (WebGrab++.config.xml) and open it with a simple text editor.
2. If you have a donator status (see above, License), complete the <license> line with username, registered email and license password.
3. Locate the dummy <channel> line at the end of the file
4. Now look inside the siteini.pack folder and find the channels you want to grab (inside the .channels.xml files)
5. Replace the dummy <channel> line with the channel(s) you want to grab
6. Run WebGrab+Plus
7. You should get a xmltv file called guide.xml file with the tv listings of your channels
8. For more information about the configuration file, see on our website
9. To feed the generate xmltv file into you EPG/PVR system you can follow examples on our site

## Update the SiteIni.Pack

To update the SiteIni.Pack folder to get the newest revisions and additions : -- For windows users .. run SiteIni.Pack.Update.exe, located in the WebGrab+Plus installation folder e.g. "C:\Program Files (x86)\WebGrab+Plus\bin\SiteIni.Pack.Update.exe" -- For Linux and OSX .. run SiteIni.Pack.Update.sh, located in the home subfolder .WG++\bin or .WG++\bin.net

## Usefull links:

Homepage
Online documentation
Online forum
Online FAQ