Skip to content

Channel Guide (EPG)

zynine edited this page Apr 8, 2017 · 6 revisions

There are 3 options for setting up Channel Guide:

Version 0.9.x and above, automatically discovered tuners uses hdhomerun mode if XMLTV Mode setting is not set to disabled. Manually specified tuners will use the Plug-In settings.


Options

Option 1 - HDHomeRun

Difficulty: Easy

Just set XMLTV Mode to HDHomeRun.

Plug-in settings

  • XMLTV Mode = hdhomerun
  • XMLTV Match by channel = number (not used in 0.9.x and above)
  • Channel Logo match by = hdhomerun, number (not used in 0.9.x and above)

Option 2 - File

Difficulty: Medium-Hard

Requires zap2xml or mc2xml. Create the smallest file possible for 2 days worth of data. The smaller the file, the faster the plug-in runs.

General steps

  1. Generate XMLTV.xml with zap2xml or mc2xml. Run it as scheduled task or cron job.
  2. Set XMLTV Mode = File
  3. Set XMLTV File Location to the path of xmltv.xml.

Read more - Generating XMLTV

Option 3 - Restapi

Difficulty: Hard

Requires:

  • JAVA
  • Channel-Guide-App
  • zap2xml or mc2xml, running as scheduled task / cron job.

General steps

  1. Generate XMLTV.xml with zap2xml or mc2xml. Set it as scheduled task.
  2. Channel-Guide-App: modify xmlTvPath in app-config.yml to point to the xmltv.xml file.
  3. Channel-Guide-App: Run the Channel-Guide-App using

java -jar channel-guide-app.jar server app-config.yml


Generating XMLTV

This sections is in progres...

There are 2 main methods of generating XMLTV to use with restapi/Channel-Guide-App or File mode. If using File mode, download not more than 2 days of data, and schedule the script/task everyday.

zap2xml

http://zap2xml.awardspace.info/

To get channel icons (-I), use capital i, not lower case L.

Example 1 (Windows)

  • zap2it account: -u my@email.com -p mypassword
  • 2 day limit: -d 2
  • program icons: -I

zap2xml -u my@email.com -p mypassword -d 2 -I

Example 2 (Windows)

  • tvguide.com account: -z -u my@email.com -p mypassword
  • 2 day limit: -d 2
  • program icons: -I

zap2xml -z -u my@email.com -p mypassword -d 2 -I

Example 3 (Windows)

  • No account
  • Manual lineup ID: -Y PC:01851
  • Zipcode: -Z 01851
  • 2 day limit: -d 2
  • program icons: -I

zap2xml -Y PC:01851 -Z 01851 -d 2 -I

Example 4 (Perl)

perl zap2xml.pl -u my@email.com -p mypassword -d 2 -I

mc2xml

http://mc2xml.hosterbox.net/

Platform: Windows, Linux, OSX

mc2xml supports many different service provider:

  • Microsoft media center legacy: free but expired
  • Metabroadcast ATLAS: UK only, free
  • Rovi Cloud: subscription, 30 day available
  • Perc Data: subscription, 7 day trial
  • Schedules Direct: subscription, 7 day trial
  • TitanTV: US only, free
  • TVMedia XMLTV: subscription, 14 day trial
  • Microsoft media center Win7+: Donate version of mc2xml

Go to mc2xml for more info.

Scheduled Task [in progress]