/plugin.video.retrospect

Retrospect is a Kodi video add-on which allows you to watch streams of a number of free and publicly available online TV stream sites.

Primary LanguagePython

Retrospect - Public GIT Repository

License Build Status Quality Gate Status

This repository holds the main code for Retrospect. For more information of bug reporting please visit https://github.com/retrospect-addon/plugin.video.retrospect or https://www.rieter.net/content/.

Installing and updating Retrospect under Kodi Leia and up

If you are using Kodi Leia then the installation is straight forward: you can install Retrospect and the dependencies from the Kodi repository. You will find Retrospect in the repository under the Video Add-ons. Updating Retrospect will then automatically be done using the Kodi repository.

Installing Retrospect

There are a couple of ways to install and/or update Retrospect using this GIT repository:

1 - Installing and updating Retrospect the 'Easy way'

If a plugin.video.retrospect-x.x.x.zip is available from the download section, this zip can be installed using Kodi's Install from ZIP feature. Keep in mind that you these zip files may not always be up-to-date.

This method can also be used to install new versions of Retrospect and thus upgrading older installs.

2 - Installation of Retrospect the 'Advanced way'

The installation comes down to putting the folders from the GIT repo (either via a 'GIT Clone' or 'Full Zip Download')in the Kodi add-on folder (very often: /home//.kodi/addons or c:\users<user>\AppData\Roaming\Kodi\addons). The result should be that the addons folder now contains at least these folders:

 plugin.video.retrospect
 plugin.video.retrospect.channel.be
 plugin.video.retrospect.channel.mtg
 plugin.video.retrospect.channel.mtv
 plugin.video.retrospect.channel.nick
 plugin.video.retrospect.channel.no
 plugin.video.retrospect.channel.nos
 plugin.video.retrospect.channel.regionalnl
 plugin.video.retrospect.channel.rtlnl
 plugin.video.retrospect.channel.sbsnl
 plugin.video.retrospect.channel.se
 plugin.video.retrospect.channel.streams
 plugin.video.retrospect.channel.uk
 plugin.video.retrospect.channel.videos

Option A - ....via 'GIT Clone'

Clone the Nightly GIT repository into a folder of your choice:

git clone https://github.com/retrospect-addon/plugin.video.retrospect.git

The cloned GIT repository should contain the folders mentioned above. Now either copy or symlink (junction on Windows) each those folders into the Kodi Add-ons folder. I would suggest using symlinks or junctions so changes from a git pull are automatically available in Kodi.

Option B - ....via 'Full Zip Download'

Download the complete GIT repo and extract it into the Kodi Add-on folder.

Caution!

Be aware that if you install it using Option A or Option B Kodi will disable the add-on by default and it will not install any of the dependencies. So you need to enable it manually and install all the dependencies by hand. Starting from Kodi Leia this is easier as it has a "View Dependencies" option of add-ons.

3 - Updating Retrospect

Option A - ....via 'GIT Clone'

Pull latest changes into your clone (located in the Kodi Add-on folder). After that remove all existing *.pyc and *.pyo files within the Retrospect folders (don't skip this).

Option B - ....via 'Full Zip Download'

Download the complete GIT repo. Remove all existing Retrospect folders (don't skip this) and extract the new ones it into the Kodi Add-on folder.

Finalizing the update

In both situation run Retrospect at least once before accessing the Retrospect add-on settings. The initial run might take longer than usual, as Retrospect is initialising some stuff and downloads artwork.

! Be advised !

Retrospect will NOT auto-update. So new version need to be installed manually.

Troubleshooting

Playing Widevine DRM content

Starting with Kodi Leia (Kodi 18) the playback of DRM protected streams is supported using the input.adaptive add-on. Kodi comes with this pre-installed, but by default it is disabled. So make sure that you enable it first. In order to play Widevine DRM files you will need to have the Google Widevine libraries installed. Android based devices have this as a native component, for Windows and Linux you will need to install them:

The Easy way:

  1. Open the Retrospect add-on settings.
  2. Enable support for the InputStream Adaptive add-on within Retrospect by enabling Use Kodi InputStream Adaptive add-on when possible.
  3. Select OK to save the settings.
  4. Open the Retrospect add-on settings again.
  5. Go to Install Widevine using InputStream Adaptive Helper add-on en select this option.
  6. Complete the steps that the InputStream Adaptive Helper add-on give you.

The Manual way:

  1. Determine the last version of the Widevine libraries: https://dl.google.com/widevine-cdm/versions.txt
  2. Download the appropriate version for your OS/Kodi combination (replace the {version} with the most recent version):
  3. For Windows installation copy these files into your <kodi-profile>\cdm folder. Linux users need to install them manually (or they can use this gist (Fork) to install it automatically).

Example:

If the most recent version obtained via https://dl.google.com/widevine-cdm/versions.txt is 4.10.1440.19, then the download url for 64-bit windows is https://dl.google.com/widevine-cdm/4.10.1440.19-win-x64.zip.

The kodi.log will tell you if you did not put them in the correct place or if you have copied the wrong version.

NOTE: for Kodi Krypton it seems that version 1.4.8.1008 is the last version that is compatible.

For ARM Devices (Such as a Raspberry Pi) things might be a bit different. If you are running Android, you probably don't need to do anything at all and Widevine should work. However, if you are running Linux on ARM and the above method does not work, there is a different approach:

  1. Determine the last version of the libraries for ARM using this url: https://dl.google.com/dl/edgedl/chromeos/recovery/recovery.conf
  2. From that configuration file, find the image for an ARM device that resembles your device.
  3. From that recovery image you will need the Widevine files located in /opt/google/chrome/libwidevinecdm*.so.
  4. These files need to be copied to the <kodi-profile>/cdm folder.

NOTE: Keep in mind that you might need to try multiple recovery images before you find a working one.

Copyrights and Licenses

See also: http://www.rieter.net/content/xot/license/.

Retrospect (Dual) License

Retrospect Framework by Bas Rieter is licensed under a Creative Commons Attribution-Non-Commercial-No Derivative Works 3.0 Unported License. Files that belong to the Retrospect Framework have a disclaimer stating that they are licensed under the Creative Commons Attribution-Non-Commercial-No Derivative Works 3.0 Unported License.

All channels, skins and config.py (further called Retrospect Additions) are free software: you can redistribute it and/or modify it under the terms of the GNU General Public License version 3 as published by the Free Software Foundation. Retrospect Additions are distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with Retrospect Additions. If not, see [1]. Kodi Add-on packages containing modified code must be given a different add-on identification to prevent confusion with the official packages. Distributing Retrospect

The official add-on packages that are currently available within the official Retrospect Repository may not be distributed via other channels than the official Retrospect Repository. Only the official Retrospect Respository (respository.retrospect) package itself may be distributed and/or included within other Kodi (super) repositories.

Disclaimer

Retrospect or Rieter.net are not connected to or in any other way affiliated with Kodi, Team Kodi, or the Kodi Foundation. Furthermore, any software, addons, or products offered by Retrospect or Rieter.net will receive no support in official Kodi channels, including the Kodi forums and various social networks.

Rules & Terms

As more and more people are starting to make channels for the Retrospect Framework, we want to lay out some rules and terms for the channels that we will host on this site. Please stick to them before asking us to post or link to them on the site:

  1. We, the Retrospect Framework team, are not responsible for any content that is displayed using the Retrospect Framework.
  2. We, the Retrospect Framework team, do not support any kind of Adult content for the Retrospect Framework nor will we host it on our servers.