Peertube
/
kodi.plugin.video.peertube
mirror of https://framagit.org/StCyr/plugin.video.peertube
1
0
Fork 0
Code Issues Releases Wiki Activity
Un add-on di Kodi per guardare contenuti ospitati su PeerTube. Riprodurre video (compresi i video in diretta) Sfoglia i video su un'istanza Cercare i video su un'istanza Selezionare l'istanza di PeerTube da utilizzare https://peertube.uno
81 Commits 4 Branches 5 Tags 3.6 MiB
Python 100%
Go to file
Thomas 4346178db9 Guide the user when libtorrent cannot be imported 
Libtorrent is required to play videos but its installation is still
manual so now a message is displayed when libtorrent could not be
imported instead of having a "service could not start" error at Kodi
startup.
The message contains a link to a page which explains how to install
libtorrent. It will be displayed when:
* the add-on starts
* the user selects a video to play (including when called externally)

Other additions:
* Create a kodi_utils module to centralize some calls to the Kodi API
* Add license information in the header of the files
* Ignore some files in Git (python cache and Mac OS system file)
 		2021-04-08 23:25:49 +02:00
resources Guide the user when libtorrent cannot be imported 2021-04-08 23:25:49 +02:00
.gitignore Guide the user when libtorrent cannot be imported 2021-04-08 23:25:49 +02:00
LICENSE.txt Initial commit. 2018-07-26 11:33:47 +02:00
README.md Allow playing videos only with the video ID 2021-04-08 23:16:39 +02:00
TESTME.md Add TESTME.md information and needed tool to create a kodi package 2018-11-23 11:50:05 +01:00
addon.xml Release 0.3.2 2021-04-08 21:04:46 +00:00
createaddon.sh Add TESTME.md information and needed tool to create a kodi package 2018-11-23 11:50:05 +01:00
fanart.jpg Add TESTME.md information and needed tool to create a kodi package 2018-11-23 11:50:05 +01:00
icon.png icon.png was bad 2018-07-26 22:08:38 +02:00
peertube.py Guide the user when libtorrent cannot be imported 2021-04-08 23:25:49 +02:00
service.py Guide the user when libtorrent cannot be imported 2021-04-08 23:25:49 +02:00

README.md

A Kodi add-on for watching content hosted on Peertube.

This code is still proof-of-concept but it works, and you're welcome to improve it.

Features

  • Browse all videos on a PeerTube instance
  • Search for videos on a PeerTube instance
  • Select Peertube instance to use (Doesn't work yet)
  • Select the preferred video resolution: the plugin will try to play the select video resolution. If it's not available, it will play the lower resolution that is the closest from your preference. If not available, it will play the higher resolution that is the closest from your preference.

User settings

  • Preferred PeerTube instance
  • Preferred video resolution
  • Number of videos to display per page
  • Sort method to be used when listing videos (Currently, only 'views' and 'likes')
  • Select the filter to use when browsing the videos on an instance:
    • local will only display the videos which are local to the selected instance
    • all-local will only display the videos which are local to the selected instance plus the private and unlisted videos (requires admin privileges)

API

This add-on can be called from other add-ons in Kodi to play videos thanks to the following API:

plugin://plugin.video.peertube/?action=play_video&instance=<instance>&id=<id>

where:

  • <instance> is the base URL of the instance hosting the video
  • <id> is the ID or the UUID of the video on the instance server

For instance to play the video behind the URL https://framatube.org/videos/watch/9c9de5e8-0a1e-484a-b099-e80766180a6d call the add-on with:

plugin://plugin.video.peertube/?action=play_video&instance=framatube.org&id=9c9de5e8-0a1e-484a-b099-e80766180a6d

Limitations

  • This add-on doesn't support Webtorrent yet. So, it cannot download/share from/to regular PeerTube clients. The reason is that it uses the libtorrent python library which doesn't support it yet (see https://github.com/arvidn/libtorrent/issues/223)
  • The add-on doesn't delete the downloaded files at the moment. So, it may fill up your disk.

Requirements

  • Kodi 17 (Krypton) or above
  • libtorrent python bindings must be installed on your machine (on Debian type apt install python-libtorrent as root).