MythTV PVR: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
No edit summary
(28 intermediate revisions by 7 users not shown)
Line 1: Line 1:
{{:PVR/Contents}}
{{:PVR/Contents}}
{{mininav|[[PVR]]|[[Recording software]]}}
{{mininav|[[PVR]]|[[PVR_recording_software]]}}
<section begin="intro" />'''MythTV''' is a open source software PVR 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 expect from a DVR type appliance device. But more interesting for {{Kodi}} users is that as MythTV uses a [[wikipedia:distributed application|distributed application structure]] it can also be configured as PVR backend (PVR server) for {{Kodi}}, supporting multiple {{Kodi}} frontends as clients, with MythTV acting as the PVR backend that does work of tuning TV signals, recording, scheduling, and post processing jobs.  
<section begin="intro" />'''MythTV''' is a open source software PVR 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 expect from a DVR type appliance device. But more interesting for {{Kodi}} users is that as MythTV uses a [[wikipedia:distributed application|distributed application structure]] it can also be configured as PVR backend (PVR server) for {{Kodi}}, supporting multiple {{Kodi}} frontends as clients, with MythTV acting as the PVR backend that does work of tuning TV signals, recording, scheduling, and post processing jobs.  


By levering existing third-party [[PVR backend]] applications such as '''MythTV''' that specialize in receiving television signals and support a [[wikipedia:client–server model|client–server model]] which {{Kodi}} can access via a [[PVR|PVR client addon]], these PVR features allows you to watch Live TV, listen to radio, view a EPG TV-Guide, schedule recordings and enables many other TV related features, all using {{Kodi}} as your primary interface once the initial pairing connection to '''MythTV''' have been done and configuration of the [[PVR|PVR client addon]] for it is complete.<section end="intro" />
By levering existing third-party [[PVR_recording_software]] applications such as '''MythTV''' that specialize in receiving television signals and support a [[wikipedia:client–server model|client–server model]] which {{Kodi}} can access via a [[PVR|PVR client addon]], these PVR features allows you to watch Live TV, listen to radio, view a EPG TV-Guide, schedule recordings and enables many other TV related features, all using {{Kodi}} as your primary interface once the initial pairing connection to '''MythTV''' have been done and configuration of the [[PVR|PVR client addon]] for it is complete.
 
Note: This will not give you access to the '''Videos''' section. For videos you can enable [[NFS|NFS]].<section end="intro"./>
__TOC__
__TOC__
{{-}}
{{-}}
Line 10: Line 12:
MythTV can be set up 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 can be set up 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.


The released PVR client addon for {{Kodi}} have been tested with MythTV PVR backend (server) version 0.27 - 0.28.
The released PVR client addon for {{Kodi}} have been tested with MythTV PVR backend (server) version '''0.27''' to '''31'''.


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


== Connecting XBMC to MythTV ==
You have to setup an IPv4 address for all backends (master and slave) and the PIN code to allow remote connections from clients as Kodi. Kodi could connect to the master or any slave. The master backend chooses the best tuner/host regarding of the availability. Also in the addon settings you will have to enter the IPv4 address of the master backend, not a slave.
 
== Connecting Kodi to MythTV ==
{{PVR repo notice}}
{{PVR repo notice}}
# Enable Kodi TV at {{highlight|Settings -> TV}}
# Go to {{highlight|Settings -> Add-ons -> Enabled add-ons -> PVR Clients}} and select the MythTV add-on
# Go to {{highlight|Settings -> Add-ons -> Enabled add-ons -> PVR Clients}} and select the MythTV add-on
# Select "Configure"
# Select "Configure"


== MythTV addon designed for Kodi ('''pvr.mythtv''') ==
== MythTV addon designed for Kodi ('''pvr.mythtv''') ==
The addon supports MythTV Backend version 0.27 - 0.28. It inter-operates with new API provided by MythTV backend since 0.27. '''To use it first you have to enable the API services of your backend''' by running mythtv-setup and set the security pin as "'''0000'''"<ref>http://www.mythtv.org/wiki/User_Manual:Detailed_configuration_Backend</ref>, set the '''IPv6 address''' to value "'''::1'''" if you haven't IP6 network infrastructure.
{{main|Add-on:MythTV PVR Client}}
The addon supports MythTV Backend version 0.27 and up to 31. It inter-operates with new API provided by MythTV backend since 0.27. '''To use it first you have to enable the API services of your backend''' by running mythtv-setup and set the security pin as "'''0000'''"<ref>http://www.mythtv.org/wiki/User_Manual:Detailed_configuration_Backend</ref>, set the '''IPv6 address''' to value "'''::1'''" if you haven't IP6 network infrastructure.


Addon provides '''Live TV''', '''recording playback''' and '''schedules''' services. It includes its internal demuxer for mpeg-ts standard and allows access of sources and storages of all MythTV infrastructure including '''master''' and its '''slave''' backends.
Addon provides '''Live TV''', '''recording playback''' and '''schedules''' services. It includes its internal demuxer for mpeg-ts standard and allows access of sources and storages of all MythTV infrastructure including '''master''' and its '''slave''' backends.
Line 36: Line 39:
=== General ===
=== General ===
<section begin="Settings" />
<section begin="Settings" />
[[File:pvr.mythtv000.png|500px|right]]
[[File:pvr-mythtv-setting-general.png|500px|right]]
[[File:pvr-mythtv-setting-preferences.png|500px|right]]
{|
{|
|
|
Line 65: Line 69:
For older MythTV versions, please use and configure the addon-'''Internal''' template provider.
For older MythTV versions, please use and configure the addon-'''Internal''' template provider.
<section begin="Settings" />
<section begin="Settings" />
[[File:pvr.mythtv001.png|500px|right]]
[[File:pvr-mythtv-setting-template.png|500px|right]]
{|
{|
|
|
; Template provider
; Template provider
: '''- MythTV:''' Use MythTV's default recording rule template
: '''- MythTV:''' Use MythTV's default recording rule template
: '''- Internal:''' Use XBMC's respectively the addon's settings
: '''- Internal:''' Use Kodi's respectively the addon's settings
; Automatically Look Up Metadata
; Automatically Look Up Metadata
: Advises the MythTV backend to download metadata for this recording.
: Advises the MythTV backend to download metadata for this recording.
Line 82: Line 86:
: Advises the MythTV backend to automatically run the user defined jobs for this recording.
: Advises the MythTV backend to automatically run the user defined jobs for this recording.
;Note
;Note
: '''Start''' and '''End Offset''' is configured in [[PVR/XBMC#Recording|XBMC Live TV settings]]
: '''Start''' and '''End Offset''' is configured in [[Configuring_live_TV_settings|Kodi Live TV settings]]
|}
|}


=== Advanced ===
=== Advanced ===
Advanced tab contains settings to tune the addon. Some change the look and feel, while others modify the behavior with respect to your hardware configuration.
Advanced tab contains settings to tune the addon. Some change the look and feel, while others modify the behavior with respect to your hardware configuration.
[[File:pvr.mythtv002_1.png|500px|right]]
[[File:pvr-mythtv-setting-advanced.png|500px|right]]
{|
{|
|
|
; Include more debug information in the log file
; 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.
: 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 demuxing MPEG-TS
; Allow backend shutdown
: Enables the addon internal demuxing of the stream. Advantages are faster channel switching and better timeshift functionality.
: If turned off, backend will waiting KODI exit or sleep before shutdown. Even turned on, addon allows backend shutdown when '''screen saver becomes activated'''. It should be turned '''ON''' for normal usage.
: '''Note:''' This might not work with all video formats. Disable this settings in case you experience playback problems.
: '''Note:''' This option do not block shutdown or suspend initiated by KODI itself.
; Block backend shutdown
: If turned on, backend will waiting KODI exit or sleep before shutdown. Even turned on, addon allows backend shutdown when screen saver becomes activated. It should be turned '''ON''' for normal usage.
: '''Note:''' '''This option do not block shutdown or suspend initiated by KODI itself.'''
; Tuning delay (sec)
; Tuning delay (sec)
: Depending of your hardware, a delay could be needed to spawn Live TV.
: Depending of your hardware, a delay could be needed to spawn Live TV.
; Group recordings by title
; Limit channel tuning attempts
: Always , Only for series , Never
: Turn on, after a failure the addon will never retry to tune the channel with next tuners
; Enable commercial skip (EDL)
: Always , Dialog , Never
; Enable channel icons
: Disable this option on low powered platform as RPi
; Enable recording fanart/thumbnails
: Disable this option on low powered platform as RPi
|}
|}
<br/>
<br />
{{Next|[[PVR/XBMC|Configuring XBMC]]}}
{{Next|[[Configuring_live_TV_settings|Configuring Kodi]]}}
<br/><br/>
<br /><br />
<section end="Settings" />
<section end="Settings" />
----
----
Line 122: Line 117:
== Getting latest version from author ==
== Getting latest version from author ==
* Binaries versions are available for Ubuntu using the PPA [https://launchpad.net/~jlbarriere68/+archive/ubuntu/ppa janbar]
* Binaries versions are available for Ubuntu using the PPA [https://launchpad.net/~jlbarriere68/+archive/ubuntu/ppa janbar]
* OSX, Windows and OpenELEC binaries are available on github page [http://janbar.github.io/pvr.mythtv/download Download PVR.MythTV]
* For other platform, you have to build it from sources. Please see sections below.
* For other platform, you have to build it from sources. Please see sections below.


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


== Additional guides and links ==
== Additional guides and links ==
Line 134: Line 128:
* MythTV backend for Kodi support forum - http://forum.kodi.tv/forumdisplay.php?fid=170
* MythTV backend for Kodi support forum - http://forum.kodi.tv/forumdisplay.php?fid=170
* Addon's issue tracker: https://github.com/janbar/pvr.mythtv/issues
* Addon's issue tracker: https://github.com/janbar/pvr.mythtv/issues
* MythTV genre colours in Kodi EPG: [[PVR/Backend/MythTV/DVB-EIT-categories]]
* MythTV genre colours in Kodi EPG
* MythTV + HDHomeRun Prime: http://gameroomsolutions.com/live-tv-setup/
* MythTV + HDHomeRun Prime: http://gameroomsolutions.com/live-tv-setup/


==References==
== References ==
{{Reflist}}
<references />
 


[[Category:PVR|*]]
[[Category:PVR|*]]
[[Category:Live TV]]
[[Category:Live TV]]

Revision as of 20:25, 19 July 2020

PVR/Contents

Home icon grey.png   ▶ PVR ▶ PVR_recording_software ▶ MythTV PVR

MythTV is a open source software PVR 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 expect from a DVR type appliance device. But more interesting for Kodi users is that as MythTV uses a distributed application structure it can also be configured as PVR backend (PVR server) for Kodi, supporting multiple Kodi frontends as clients, with MythTV acting as the PVR backend that does work of tuning TV signals, recording, scheduling, and post processing jobs.

By levering existing third-party PVR_recording_software applications such as MythTV that specialize in receiving television signals and support a client–server model which Kodi can access via a PVR client addon, these PVR features allows you to watch Live TV, listen to radio, view a EPG TV-Guide, schedule recordings and enables many other TV related features, all using Kodi as your primary interface once the initial pairing connection to MythTV have been done and configuration of the PVR client addon for it is complete.

Note: This will not give you access to the Videos section. For videos you can enable NFS.


Installing MythTV

MythTV can be set up on a variety of Linux distributions and also on Mac OS X. The MythTV Wiki page has several pages of detailed instruction sets for various distros and tuner types.

The released PVR client addon for Kodi have been tested with MythTV PVR backend (server) version 0.27 to 31.

MythTV quick start guide

You have to setup an IPv4 address for all backends (master and slave) and the PIN code to allow remote connections from clients as Kodi. Kodi could connect to the master or any slave. The master backend chooses the best tuner/host regarding of the availability. Also in the addon settings you will have to enter the IPv4 address of the master backend, not a slave.

Connecting Kodi to MythTV

Template:PVR repo notice

  1. Enable Kodi TV at Settings -> TV
  2. Go to Settings -> Add-ons -> Enabled add-ons -> PVR Clients and select the MythTV add-on
  3. Select "Configure"

MythTV addon designed for Kodi (pvr.mythtv)

The addon supports MythTV Backend version 0.27 and up to 31. It inter-operates with new API provided by MythTV backend since 0.27. To use it first you have to enable the API services of your backend by running mythtv-setup and set the security pin as "0000"[1], set the IPv6 address to value "::1" if you haven't IP6 network infrastructure.

Addon provides Live TV, recording playback and schedules services. It includes its internal demuxer for mpeg-ts standard and allows access of sources and storages of all MythTV infrastructure including master and its slave backends.

Pvr.mythtv-channels.png Pvr.mythtv-recordings.png Pvr.mythtv-guide-actions.png

Addon allows streaming of Live TV and Recordings, listening to Radio channels, EPG and Timers, including fanarts, covers and previews from your MythTV backend.

Settings

General

Pvr-mythtv-setting-general.png
Pvr-mythtv-setting-preferences.png
MythTV Backend Hostname or IP
The hostname or IP address of the server where MythTV / master backend 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 Backend Port for API services
The default is 6544 but this will need updating if you have changed it in the MythTV settings.
MythTV Security PIN for API services
The default is 0000 but this will need updating if you have changed it in the MythTV settings.
MythTV Backend Ethernet address (WOL)
Add the MAC address of your backend to allow the addon to wake up the backend using WOL. Also addon will wait any user activities to send the magic packet, otherwise the backend won't be wake up to save power.
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.

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.

Pvr-mythtv-setting-template.png
Template provider
- MythTV: Use MythTV's default recording rule template
- Internal: Use Kodi'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 Kodi Live TV settings

Advanced

Advanced tab contains settings to tune the addon. Some change the look and feel, while others modify the behavior with respect to your hardware configuration.

Pvr-mythtv-setting-advanced.png
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.
Allow backend shutdown
If turned off, backend will waiting KODI exit or sleep before shutdown. Even turned on, addon allows backend shutdown when screen saver becomes activated. It should be turned ON for normal usage.
Note: This option do not block shutdown or suspend initiated by KODI itself.
Tuning delay (sec)
Depending of your hardware, a delay could be needed to spawn Live TV.
Limit channel tuning attempts
Turn on, after a failure the addon will never retry to tune the channel with next tuners


Next step: Configuring Kodi




Troubleshooting

  1. If you're experiencing troubles with the addon, MythTV section of Kodi Forum is the correct place to ask for help.
  2. Always include a full debug log with the addon setting Include more debug information in the log file enabled. (also please make yourself familiar with Kodi troubleshooting)
  3. Issues that are only related to this addon (not to Kodi itself or Kodi's general PVR code) should be reported here: https://github.com/janbar/pvr.mythtv/issues (if unsure, ask in the forum first!)

Getting latest version from author

  • Binaries versions are available for Ubuntu using the PPA janbar
  • For other platform, you have to build it from sources. Please see sections below.

Development

Additional guides and links

References