Official Kodi Wiki - User contributions [en]

MythTV PVR/BuildFromSource

2014-01-01T23:54:45Z

Teeedubb: /* Build MythTV addon on Ubuntu */

* The addon is part of XBMC's official addon repository: https://github.com/opdenkamp/xbmc-pvr-addons
* The addon's development repository is https://github.com/fetzerch/xbmc-pvr-addons. You will also find the addon's issue tracker here.

== Branches ==
XBMC PVR addons like the MythTV addon are not compatible with all versions of XBMC (due to the PVR API version dependency).
The addon repositories have different branches for the different XBMC versions.
* Branch ''master'': Compatible with XBMC pre-Gotham (v13) development builds
* Branch ''frodo'': Compatible with XBMC Frodo (v12)
Use <code>git checkout <BRANCH></code> after cloning the repository to switch to the according branch before starting the build.

== Build MythTV addon on Ubuntu ==
* Add repository for XBMC nightly builds
<pre>
sudo add-apt-repository ppa:team-xbmc/unstable
sudo apt-get update
sudo apt-get upgrade
</pre>

* Install XBMC from nightly builds
<pre>sudo apt-get install xbmc</pre>

* Install build utilities/libraries
<pre>
sudo apt-get install ubuntu-restricted-extras autoconf git
sudo apt-get install build-essential automake checkinstall
sudo apt-get install autoconf automake bison flex libtool intltool zip
sudo apt-get install libmysqlclient-dev libboost-filesystem-dev
</pre>

* Create zip file for XBMC MythTV addon
<pre>
mkdir source
cd source
git clone git://github.com/fetzerch/xbmc-pvr-addons.git
cd xbmc-pvr-addons
./bootstrap
./configure --enable-addons-with-dependencies
make clean zip
</pre>

* Put the addon in a handy location
<pre>
cp addons/pvr.mythtv.cmyth-linux-x86_64.zip $HOME
</pre>

* You may need to delete the previous addon zip file out of ~/.xbmc/addons/packages/ to allow installation of newer revision with the same addon version number
<pre>
rm ~/.xbmc/addons/packages/pvr.mythtv.cmyth-linux-x86_64.zip
</pre>

* Start XBMC, add the addon using the zip file, then finally enable Live TV using the MythTV addon above.

== Build MythTV addon on OSX ==
* Install '''Xcode''' for your Mac. Go to http://connect.apple.com/
:Snow leopard: Xcode 3.2.6
:Lion: Xcode 4.3
:Mountain Lion: Xcode 4.4

* Install '''git'''. Go to http://code.google.com/p/git-osx-installer

* Now open a '''terminal''' console and clone the tool chain repository to build addon. Below the tool chain is installed in the folder '''$HOME/src'''
<pre>mkdir src ; cd src
git clone git://github.com/janbar/xbmc-pvr-toolchain-osx.git</pre>

* Clone the '''xbmc-pvr-addons''' sources from git repository inside the tool chain
<pre>cd xbmc-pvr-toolchain-osx
git clone git://github.com/fetzerch/xbmc-pvr-addons.git</pre>

* Optionally you can choose the branch you want to build. By default master branch is checked out
''frodo branch''
<pre>cd xbmc-pvr-addons ; git checkout frodo ; cd ..</pre>
''master branch''
<pre>cd xbmc-pvr-addons ; git checkout master ; cd ..</pre>

* Build it. You have to be in the root folder of the tool chain
<pre>make</pre>

* Install addon '''pvr.mythtv.cmyth''' with '''XBMC'''
The builder create a new folder '''pvr.mythtv.cmyth''' containing the addon. You have to copy it into '''$HOME/Library/Application\ Support/XBMC/addons/'''. Also you can zip it to be uploaded with '''XBMC''' as zip file.

* You can rebuild the addon at anytime using command ''make''. To completely clean up the tool chain, type ''make distclean''.

== Build MythTV addon on Windows ==
* Install '''Visual C++ 2010'''
* Download '''xbmc-pvr-addons''' sources from git repository
<pre>cd src
git clone git://github.com/fetzerch/xbmc-pvr-addons.git</pre>
* Execute '''DownloadBuildDeps.bat''' in '''xbmc-pvr-addons\project\BuildDependencies'''
* Open '''xbmc-pvr-addons.sln''' from '''xbmc-pvr-addons\project\VS2010Express''' in Visual C++ 2010
* Build it
* To install the addon, copy the folder '''xbmc-pvr-addons\addons\pvr.mythtv.cmyth\addon''' to your XBMC Frodo addon direcory

== Build MythTV git into OpenELEC ==
* Follow normal OpenELEC build instructions (http://wiki.openelec.tv/index.php?title=Compile_from_source) but adjust the "Start compiling" procedure as below
<pre>cd OpenELEC.tv</pre>
* Run the below script to replace normally included pvr-addons with latest development git version
<pre>#!/bin/bash

source ./packages/mediacenter/xbmc-pvr-addons/meta

if [ ! -d ./sources/$PKG_NAME/ ]; then
mkdir -p ./sources/$PKG_NAME/
fi
wget --no-check-certificate https://github.com/fetzerch/xbmc-pvr-addons/archive/master.zip
unzip master.zip
mv xbmc-pvr-addons-master $PKG_NAME-$PKG_VERSION
tar -cJf $PKG_NAME-$PKG_VERSION.tar.xz $PKG_NAME-$PKG_VERSION
rm -r $PKG_NAME-$PKG_VERSION master.zip

mv $PKG_NAME-$PKG_VERSION.tar.xz ./sources/$PKG_NAME/
md5sum sources/$PKG_NAME/$PKG_NAME-$PKG_VERSION.tar.xz > sources/$PKG_NAME/$PKG_NAME-$PKG_VERSION.tar.xz.md5
echo "http://sources.openelec.tv/devel/$PKG_NAME-$PKG_VERSION.tar.xz" > ./sources/$PKG_NAME/$PKG_NAME-$PKG_VERSION.tar.xz.url

rm -rf ./build.OpenELEC*/.stamps/xbmc-pvr-addons ./build.OpenELEC*/xbmc-pvr-addons-* ./build.OpenELEC*/image/.stamps/xbmc-pvr-addons
</pre>
* Continue with regular build instructions (PROJECT=XXX ARCH=YYY make release)

Archive:MythTV PVR Client/DVB-EIT-categories

2013-10-30T07:50:25Z

Teeedubb: Created page with "he MythTV addon / XBMC only supports DVB-SI EIT categories. If you get your EPG data from other sources (for example xmltv), the addon / XBMC won't be able to map the categori..."

he MythTV addon / XBMC only supports DVB-SI EIT categories. If you get your EPG data from other sources (for example xmltv), the addon / XBMC won't be able to map the categories correctly. MythTV supports colors also for other categories, but again depending on the source, you don't get perfect results.

You can use a small wrapper script as mythfilldatabase which changes the categories in the MythTV database to the default DVB-SI EIT categories.

== MythTV backend needs to be configured to use this script as mythfilldatabase replacement: ==

/usr/local/bin/my-mythfilldatabase
<pre>
#!/bin/bash

export LANG=de_DE.UTF-8
export LC_ALL=de_DE.UTF-8

/usr/bin/mythfilldatabase --loglevel debug -- "--days 18"
RES=$?
if [ $RES -eq 0 ]; then
fi
exit $RES
</pre>

== The SQL file epg.sql that does the category conversion, it will vary with language and below will be some examples: ==

You can get all currently used categories with the following:
<pre>
/usr/bin/mysql -h htpc -u mythtv -p mythtv -D mythconverg <<< "SELECT DISTINCT category FROM program;"
</pre>
-h = host, -u = username, -p = db password, -D = database name.

/usr/local/bin/epg.sql

'''German:'''
<pre>
/*

See DVB-SI spec (ETSI EN 300 468 V1.11.1 (2010-04), page 40, http://www.etsi.org/deliver/etsi_en/300400_300499/300468/01.11.01_60/en_300468v011101p.pdf)

Undefined
0x0 0x0 to 0xF undefined content

Movie/Drama:

0x1 0x0 movie/drama (general)
0x1 0x1 detective/thriller
0x1 0x2 adventure/western/war
0x1 0x3 science fiction/fantasy/horror
0x1 0x4 comedy
0x1 0x5 soap/melodrama/folkloric
0x1 0x6 romance
0x1 0x7 serious/classical/religious/historical movie/drama
0x1 0x8 adult movie/drama
0x1 0x9 to 0xE reserved for future use
0x1 0xF user defined

*/

UPDATE program SET category = 'Movie' WHERE category IN ('filme','action','kurzfilm');
UPDATE program SET category = 'Movie - Detective/Thriller' WHERE category IN ('krimi', 'thriller');
UPDATE program SET category = 'Movie - Adventure/Western/War' WHERE category IN ('abenteuer', 'western');
UPDATE program SET category = 'Movie - Science Fiction/Fantasy/Horror' WHERE category IN ('science fiction', 'fantasy', 'mystery+horror');
-- Comedy
UPDATE program SET category = 'Movie - Soap/melodrama/folkloric' WHERE category IN ('serien', 'soap', 'krankenhaus');
UPDATE program SET category = 'Movie - Romance' WHERE category = 'romantik/liebe';
-- Classical
UPDATE program SET category = 'Movie - Adult ' WHERE category = 'erotik';
UPDATE program SET category = 'Drama' WHERE category = 'drama';

/*

News/Current affairs:

0x2 0x0 news/current affairs (general)
0x2 0x1 news/weather report
0x2 0x2 news magazine
0x2 0x3 documentary
0x2 0x4 discussion/interview/debate
0x2 0x5 to 0xE reserved for future use
0x2 0xF user defined

*/

UPDATE program SET category = 'News' WHERE category = 'nachrichten';
-- weather
UPDATE program SET category = 'News magazine' WHERE category = 'magazin';
UPDATE program SET category = 'Documentary' WHERE category = 'dokumentarfilm';
-- discussion

/*

Show/Game show:

0x3 0x0 show/game show (general)
0x3 0x1 game show/quiz/contest
0x3 0x2 variety show
0x3 0x3 talk show
0x3 0x4 to 0xE reserved for future use
0x3 0xF user defined

*/

UPDATE program SET category = 'Entertainment' WHERE category IN ('humor', 'comedy');
UPDATE program SET category = 'Game Show' WHERE category IN ('show','shows','spielshows');
UPDATE program SET category = 'Variety Show' WHERE category = 'familien-show';
UPDATE program SET category = 'Talk Show' WHERE category IN ('talkshows','gerichtsshow','reality');

/*

Sports:

0x4 0x0 sports (general)
0x4 0x1 special events (Olympic Games, World Cup, etc.)
0x4 0x2 sports magazines
0x4 0x3 football/soccer
0x4 0x4 tennis/squash
0x4 0x5 team sports (excluding football)
0x4 0x6 athletics
0x4 0x7 motor sport
0x4 0x8 water sport
0x4 0x9 winter sports
0x4 0xA equestrian
0x4 0xB martial sports
0x4 0xC to 0xE reserved for future use
0x4 0xF user defined

*/

UPDATE program SET category = 'Sports' WHERE category IN ('extremsport', 'golf', 'us-sport');
-- special events
-- magazines
UPDATE program SET category = 'Football (Soccer)' WHERE category = 'fussball';
UPDATE program SET category = 'Tennis/Squash' WHERE category = 'tennis';
UPDATE program SET category = 'Misc. Team Sports' WHERE category IN ('handball', 'volleyball');
UPDATE program SET category = 'Athletics' WHERE category = 'leichtathletik';
UPDATE program SET category = 'Motor Sport' WHERE category = 'motorsport';
UPDATE program SET category = 'Water Sport' WHERE category = 'wassersport';
UPDATE program SET category = 'Winter Sports' WHERE category = 'wintersport';
-- equestrian
UPDATE program SET category = 'Martial Sports' WHERE category = 'boxen';

/*

Children's/Youth programmes:

0x5 0x0 children's/youth programmes (general)
0x5 0x1 pre-school children's programmes
0x5 0x2 entertainment programmes for 6 to14
0x5 0x3 entertainment programmes for 10 to 16
0x5 0x4 informational/educational/school programmes
0x5 0x5 cartoons/puppets
0x5 0x6 to 0xE reserved for future use
0x5 0xF user defined

*/

UPDATE program SET category = 'Kids' WHERE category = 'jugend';
-- pre-school
-- 6-14
-- 10-16
-- informational
UPDATE program SET category = 'Cartoons/Puppets' WHERE category IN ('zeichentrick', 'anime');

/*

Music/Ballet/Dance:

0x6 0x0 music/ballet/dance (general)
0x6 0x1 rock/pop
0x6 0x2 serious music/classical music
0x6 0x3 folk/traditional music
0x6 0x4 jazz
0x6 0x5 musical/opera
0x6 0x6 ballet
0x6 0x7 to 0xE reserved for future use
0x6 0xF user defined

*/

UPDATE program SET category = 'Music/Ballet/Dance' WHERE category = 'musik';
UPDATE program SET category = 'Rock/Pop' WHERE category IN ('rock', 'pop', 'alternative');
UPDATE program SET category = 'Classical Music' WHERE category = 'klassik';
UPDATE program SET category = 'Folk Music' WHERE category = 'volksmusik';
UPDATE program SET category = 'Jazz' WHERE category = 'jazz';
UPDATE program SET category = 'Musical/Opera' WHERE category = 'musical';
-- ballet

/*

Arts/Culture (without music):

0x7 0x0 arts/culture (without music, general)
0x7 0x1 performing arts
0x7 0x2 fine arts
0x7 0x3 religion
0x7 0x4 popular culture/traditional arts
0x7 0x5 literature
0x7 0x6 film/cinema
0x7 0x7 experimental film/video
0x7 0x8 broadcasting/press
0x7 0x9 new media
0x7 0xA arts/culture magazines
0x7 0xB fashion
0x7 0xC to 0xE reserved for future use
0x7 0xF user defined

*/

UPDATE program SET category = 'Arts/Culture' WHERE category = 'kultur';
UPDATE program SET category = 'Performing Arts' WHERE category = 'theater';
-- fine arts
-- religion
-- pop
-- literature
-- film
-- experimental film
-- broadcasting
-- new media
-- arts
-- fashion

/*

Social/Political issues/Economics:

0x8 0x0 social/political issues/economics (general)
0x8 0x1 magazines/reports/documentary
0x8 0x2 economics/social advisory
0x8 0x3 remarkable people
0x8 0x4 to 0xE reserved for future use
0x8 0xF user defined

*/

UPDATE program SET category = 'Social/Policical/Economics' WHERE category = 'politik';
UPDATE program SET category = 'Magazines/Reports/Documentary' WHERE category IN ('reportagen','dokumentation','heimat','geschichte');
UPDATE program SET category = 'Economics/Social Advisory' WHERE category IN ('ratgeber','wirtschaft');
-- remarkable people

/*

Education/Science/Factual topics:

0x9 0x0 education/science/factual topics (general)
0x9 0x1 nature/animals/environment
0x9 0x2 technology/natural sciences
0x9 0x3 medicine/physiology/psychology
0x9 0x4 foreign countries/expeditions
0x9 0x5 social/spiritual sciences
0x9 0x6 further education
0x9 0x7 languages
0x9 0x8 to 0xE reserved for future use
0x9 0xF user defined

*/

UPDATE program SET category = 'Education/Science/Factual' WHERE category = 'wissen';
UPDATE program SET category = 'Nature/animals/Environment' WHERE category = 'natur';
-- technology
UPDATE program SET category = 'Medicine/Physiology/Psychology' WHERE category = 'gesundheit';
-- foreign countries
UPDATE program SET category = 'Social/Spiritual Sciences' WHERE category = 'familie';
-- further education
-- languages

/*

Leisure hobbies:

0xA 0x0 leisure hobbies (general)
0xA 0x1 tourism/travel
0xA 0x2 handicraft
0xA 0x3 motoring
0xA 0x4 fitness and health
0xA 0x5 cooking
0xA 0x6 advertisement/shopping
0xA 0x7 gardening
0xA 0x8 to 0xE reserved for future use
0xA 0xF user defined

*/

-- leisure hobbies
UPDATE program SET category = 'Tourism/Travel' WHERE category = 'reise';
UPDATE program SET category = 'Handicraft' WHERE category = 'heimwerken';
UPDATE program SET category = 'Motoring' WHERE category = 'motor+verkehr';
UPDATE program SET category = 'Fitness & Health' WHERE category = 'gymnastik';
UPDATE program SET category = 'Cooking' WHERE category = 'kochshow';
UPDATE program SET category = 'Advertizement/Shopping' WHERE category = 'homeshopping';
-- gardening
</pre>

MythTV PVR

2013-10-30T07:01:36Z

Teeedubb:

{{:PVR/Contents}}
MythTV is a Free Open Source software digital video recorder (DVR) project that is designed to run on Linux, although other operating system packages are available. With MythTV you can watch live TV, schedule recordings, view episode guide information, and many other features you'd expect from a DVR type device. MythTV can also be setup with multiple backends (master/slave) and multiple frontends to spread out the workload of recording, scheduling, and post processing jobs. More information on MythTV can be found on their [http://www.mythtv.org/ official] website.

The released addon supports MythTV Backend version 0.24 - 0.26.

__TOC__
{{-}}

== Installing MythTV ==
MythTV can be setup on a variety of Linux distributions and also on Mac OS X. The [http://www.mythtv.org/wiki/Packages MythTV Wiki] page has several pages of detailed instruction sets for various distros and tuner types.

== MythTV quick start guide ==
If your tuner hardware is not detected or is having issues, check http://linuxtv.org for driver support.

== Connecting XBMC to MythTV ==
{{PVR repo notice}}
# Go to {{highlight|Settings -> Add-ons -> Enabled add-ons -> PVR Clients}} and select the MythTV add-on
# Select "Configure"

== Settings ==
=== General ===
<section begin="Settings" />
[[File:Xbmc-settings-mythtv-general.png|500px|right]]
{|
|
; MythTV Backend Hostname or IP
: The hostname or IP address of the server where MythTV / MythBackend is installed. If backend and frontend run on the same machine then 'localhost' can be used.
; MythTV Backend Port
: The default is 6543 but this will need updating if you have changed it in the MythTV settings.
; MythTV Database Username
: The default is 'mythtv' but this will need updating if you have changed it for the MythTV database.
; MythTV Database Password
: The default is 'mythtv' but this will need updating if you have changed it for the MythTV database.
; MythTV Database Databasename
: The default is 'mythconverg' but this will need updating if you have changed it in the MythTV settings.
; Include more debug information in the log file
: If turned on, additional debugging information is written to the log file. This should be turned on if you want to debug or report problems. It should be off for normal usage.
; Enable Live TV
: This enables Live TV. Switch it off if you do want to use MythTV only for watching recordings.
; Allow Live TV to move scheduled shows
: This allows MythBackend to move scheduled recordings to another tuner if the scheduled tuner is blocked by an active Live TV playback. If turned off, you might miss recordings!
; Conflict handling
: This allows to configure the Live TV vs. scheduled recoding conflict handling. The setting determines how the addon should handle upcoming recordings for a tuner, that is being used for Live TV at the moment.
: '''- Prefer Live TV when recording has later slot:''' (default) Continue watching Live TV in case there is a known later slot for the recording. Reschedule to record this repeat instead. If there's no later slot, stop Live TV and start the recording now.
: '''- Prefer recording and stop Live TV:''' Stop Live TV and start the scheduled recording.
: '''- Prefer Live TV and cancel conflicting recording:''' Ignore the conflicting, upcoming recording and continue to watch Live TV instead.
|}
{{-}}
In addition the addon supports advanced settings, that can be edited in the addon's settings file: <code>[[userdata]]/addon_data/pvr.mythtv.cmyth/settings.xml</code>
{|
|
; MythTV Database Hostname or IP
: The default is your MythTV Backend Hostname but this will need updating if your database server runs on a different host.
:<code><setting id="db_host" value="192.168.0.1" /></code>
; MythTV Database Port
: The default is 3306 but this will need updating if you have changed it.
:<code><setting id="db_port" value="3306" /></code>
|}
<section end="Settings" />

=== Recording template ===
Configuration of the default rules for new recordings. Recording rule templates have been introduced in MythTV 0.26.
For older MythTV versions, please use and configure the addon-'''Internal''' template provider.
<section begin="Settings" />
[[File:Xbmc-settings-mythtv-template.png|500px|right]]
{|
|
; Template provider
: '''- MythTV:''' Use MythTV's default recording rule template
: '''- Internal:''' Use XBMC's respectively the addon's settings
; Automatically Look Up Metadata
: Advises the MythTV backend to download metadata for this recording.
; Commercial Flag new recordings
: Advises the MythTV backend to run the commercial flag job for this recording.
; Allow recordings to expire?
: Allows the MythTV backend to automatically delete the recording when necessary.
; Transcode new recordings and Transcoder
: Advises the MythTV backend to automatically transcode the recording into a different format.
; Run user Job #1-4
: Advises the MythTV backend to automatically run the user defined jobs for this recording.
;Note
: '''Start''' and '''End Offset''' is configured in [[PVR/XBMC#Recording|XBMC Live TV settings]]
|}

<section end="Settings" />

{{Next|[[PVR/XBMC|Configuring XBMC]]}}

== Troubleshooting ==
# If you're experiencing troubles with the addon, [http://forum.xbmc.org/forumdisplay.php?fid=170 MythTV section of XBMC Forum] is the correct place to ask for help.
# Always include a '''full [http://wiki.xbmc.org/index.php?title=Debug_log debug log]''' with the addon setting '''Include more debug information in the log file''' enabled. (also please make yourself familiar with [http://wiki.xbmc.org/index.php?title=Troubleshooting XBMC troubleshooting])
# Issues that are only related to this addon (not to XBMC itself or XBMC's general PVR code) should be reported here: https://github.com/fetzerch/xbmc-pvr-addons/issues (if unsure, ask in the forum first!)

== Development ==
* See [[PVR/Backend/MythTV/BuildFromSource|Build addon from source]] to learn how to build addon from the official or from the development repository
* This addon uses the Transifex Localization platform. You're welcome to contribute translations: https://www.transifex.com/projects/p/XBMC-Main-Frodo/resource/pvr-mythtv-cmyth/

== Additional guides and links ==
* MythTV website - http://mythtv.org
** [http://www.mythtv.org/wiki/ Documentation]
* MythTV backend for XBMC support forum - http://forum.xbmc.org/forumdisplay.php?fid=170
* Addon's issue tracker: https://github.com/fetzerch/xbmc-pvr-addons/issues
* MythTV genre colours in XBMC EPG: http://wiki.xbmc.org/index.php?title=PVR/Backend/MythTV/DVB-EIT-categories