PlexKodiConnect/README.md

114 lines
7.6 KiB
Markdown
Raw Normal View History

2019-11-15 23:40:34 +11:00
[![stable version](https://img.shields.io/badge/stable_version-2.10.4-blue.svg?maxAge=60&style=flat) ](https://github.com/croneter/binary_repo/raw/master/stable/repository.plexkodiconnect/repository.plexkodiconnect-1.0.2.zip)
2020-02-03 00:18:17 +11:00
[![beta version](https://img.shields.io/badge/beta_version-2.10.9-red.svg?maxAge=60&style=flat) ](https://github.com/croneter/binary_repo/raw/master/beta/repository.plexkodiconnectbeta/repository.plexkodiconnectbeta-1.0.2.zip)
2017-03-25 02:19:19 +11:00
2017-03-25 02:02:09 +11:00
[![Installation](https://img.shields.io/badge/wiki-installation-brightgreen.svg?maxAge=60&style=flat)](https://github.com/croneter/PlexKodiConnect/wiki/Installation)
2017-03-25 02:10:25 +11:00
[![FAQ](https://img.shields.io/badge/wiki-FAQ-brightgreen.svg?maxAge=60&style=flat)](https://github.com/croneter/PlexKodiConnect/wiki/faq)
2017-03-25 01:54:10 +11:00
[![Forum](https://img.shields.io/badge/forum-plex-orange.svg?maxAge=60&style=flat)](https://forums.plex.tv/discussion/210023/plexkodiconnect-let-kodi-talk-to-your-plex)
2019-02-14 22:37:32 +11:00
[![Donate](https://img.shields.io/badge/donate-kofi-blue.svg)](https://ko-fi.com/A8182EB)
2017-03-25 01:27:32 +11:00
2019-06-29 00:40:45 +10:00
[![GitHub issues](https://img.shields.io/github/issues/croneter/PlexKodiConnect.svg?maxAge=60&style=flat)](https://github.com/croneter/PlexKodiConnect/issues) [![GitHub pull requests](https://img.shields.io/github/issues-pr/croneter/PlexKodiConnect.svg?maxAge=60&style=flat)](https://github.com/croneter/PlexKodiConnect/pulls) [![Codacy Badge](https://api.codacy.com/project/badge/Grade/a66870f19ced4fb98f94d9fd56e34e87)](https://www.codacy.com/app/croneter/PlexKodiConnect?utm_source=github.com&utm_medium=referral&utm_content=croneter/PlexKodiConnect&utm_campaign=Badge_Grade)
2017-02-28 05:59:30 +11:00
2016-07-16 23:00:06 +10:00
# PlexKodiConnect (PKC)
**Combine the best frontend media player Kodi with the best multimedia backend server Plex**
2018-09-05 00:47:20 +10:00
PKC synchronizes your media from your Plex server to the native Kodi database. Hence:
- Use virtually any other Kodi add-on
- Use any Kodi skin, completely customize Kodi's look
- Browse your media very fluently (cached artwork)
- Automatically get additional artwork (more than Plex offers)
- Use Plex features with a Kodi interface
2016-07-16 23:00:06 +10:00
2016-07-17 00:09:10 +10:00
Have a look at [some screenshots](https://github.com/croneter/PlexKodiConnect/wiki/Some-PKC-Screenshots) to see what's possible.
2018-04-07 22:02:45 +10:00
### Update Your PKC Repo to Receive Updates!
2017-12-15 23:00:40 +11:00
Unfortunately, the PKC Kodi repository had to move because it stopped working (thanks https://bintray.com). If you installed PKC before December 15, 2017, you need to [**MANUALLY** update the repo once](https://github.com/croneter/PlexKodiConnect/wiki/Update-PKC-Repository).
2016-12-05 00:44:52 +11:00
### Content
2018-04-07 22:01:18 +10:00
* [**Download and Installation**](#download-and-installation)
* [**Warning**](#warning)
2017-03-18 01:27:08 +11:00
* [**PKC Features**](#pkc-features)
2017-05-30 00:34:42 +10:00
* [**Additional Artwork**](#additional-artwork)
2017-02-05 23:01:31 +11:00
* [**Donations**](#donations)
2017-03-17 05:27:40 +11:00
* [**Request a New Feature**](#request-a-new-feature)
2018-04-07 22:01:18 +10:00
* [**Issues and Bugs**](#issues-and-bugs)
2017-02-05 23:01:31 +11:00
* [**Credits**](#credits)
2016-12-05 00:44:52 +11:00
2018-04-07 22:01:18 +10:00
### Download and Installation
2016-10-16 23:23:40 +11:00
2018-04-07 22:01:18 +10:00
Install PKC via the PlexKodiConnect Kodi repository download button just below (do NOT use the standard GitHub download!). See the [github wiki installation manual](https://github.com/croneter/PlexKodiConnect/wiki/Installation) for a detailed guide. Please use the stable version except if you really know what you're doing. Kodi will update PKC automatically.
| Stable version | Beta version |
|----------------|--------------|
| [![stable version](https://img.shields.io/badge/stable_version-latest-blue.svg?maxAge=60&style=flat) ](https://github.com/croneter/binary_repo/raw/master/stable/repository.plexkodiconnect/repository.plexkodiconnect-1.0.2.zip) | [![beta version](https://img.shields.io/badge/beta_version-latest-red.svg?maxAge=60&style=flat) ](https://github.com/croneter/binary_repo/raw/master/beta/repository.plexkodiconnectbeta/repository.plexkodiconnectbeta-1.0.2.zip) |
2017-03-25 01:52:33 +11:00
2018-04-07 22:01:18 +10:00
### Warning
Use at your own risk! This plugin assumes that you manage all your videos with Plex (and none with Kodi). You might lose data already stored in the Kodi video and music databases as this plugin directly changes them. Don't worry if you want Plex to manage all your media (like you should ;-)).
Some people argue that PKC is 'hacky' because of the way it directly accesses the Kodi database. See [here for a more thorough discussion](https://github.com/croneter/PlexKodiConnect/wiki/Is-PKC-'hacky'%3F).
2017-03-17 05:26:08 +11:00
### PKC Features
2016-04-08 23:35:03 +10:00
2019-11-02 22:12:31 +11:00
- Kodi 19 Matrix is not yet supported (PKC is written in Python 2)
2019-01-29 18:25:23 +11:00
- Support for Kodi 18 Leia
2017-03-17 05:22:23 +11:00
- [Amazon Alexa voice recognition](https://www.plex.tv/apps/streaming-devices/amazon-alexa)
2018-05-05 03:06:59 +10:00
- [Cinema Trailers & Extras](https://support.plex.tv/articles/202934883-cinema-trailers-extras/)
- [Plex Watch Later / Plex It!](https://support.plex.tv/hc/en-us/sections/200211783-Plex-It-)
- [Plex Companion](https://support.plex.tv/hc/en-us/sections/200276908-Plex-Companion): fling Plex media (or anything else) from other Plex devices to PlexKodiConnect
2018-08-04 02:39:26 +10:00
- Automatically sync Plex playlists to Kodi playlists and vice-versa
2016-07-16 23:00:06 +10:00
- [Plex Transcoding](https://support.plex.tv/hc/en-us/articles/200250377-Transcoding-Media)
- Automatically download more artwork from [Fanart.tv](https://fanart.tv/), just like the Kodi addon [Artwork Downloader](http://kodi.wiki/view/Add-on:Artwork_Downloader)
2017-03-25 01:52:33 +11:00
- Automatically group movies into [movie sets](http://kodi.wiki/view/movie_sets)
- [Direct play](https://github.com/croneter/PlexKodiConnect/wiki/Direct-Play) from network paths (e.g. "\\\\server\\Plex\\movie.mkv"), something unique to PKC
- Delete PMS items from the Kodi context menu
2018-09-30 00:54:09 +10:00
- PKC is available in the following languages. [Please help and easily translate PKC!](https://www.transifex.com/croneter/pkc)
2017-03-17 05:22:23 +11:00
+ English
+ German
+ Czech, thanks @Pavuucek
2017-05-31 22:49:34 +10:00
+ Spanish, thanks @bartolomesoriano, @danichispa
2017-03-17 05:22:23 +11:00
+ Danish, thanks @FIGHT
2017-03-20 00:49:15 +11:00
+ Italian, thanks @nikkux, @chicco83
2017-03-30 06:22:57 +11:00
+ Dutch, thanks @mvanbaak
2017-07-26 04:31:06 +10:00
+ French, thanks @lflforce, @ahivert, @Nox71, @CotzaDev, @vinch100, @Polymorph31, @jbnitro, @Elixir59
2017-04-07 20:07:12 +10:00
+ Chinese Traditional, thanks @old2tan
+ Chinese Simplified, thanks @everdream
2017-07-01 22:34:28 +10:00
+ Norwegian, thanks @mjorud
2017-07-26 04:31:06 +10:00
+ Portuguese, thanks @goncalo532
2018-03-20 21:56:51 +11:00
+ Russian, thanks @UncleStark
2018-04-06 23:38:23 +10:00
+ Hungarian, thanks @savage93
2018-07-05 00:27:51 +10:00
+ Ukrainian, thanks @uniss
2019-07-21 20:29:43 +10:00
+ Lithuanian, thanks @egidusm
2017-03-18 01:27:08 +11:00
### Additional Artwork
PKC uses additional artwork for free from [TheMovieDB](https://www.themoviedb.org). Many thanks for lettings us use the API, guys!
2017-05-30 00:36:39 +10:00
[![Logo of TheMovieDB](themoviedb.png)](https://www.themoviedb.org)
2017-03-18 01:27:08 +11:00
### Donations
2018-02-07 21:10:26 +11:00
I'm not in any way affiliated with Plex. Thank you very much for a small donation via ko-fi.com and PayPal, Bitcoin or Ether if you appreciate PKC.
2018-02-07 22:38:31 +11:00
**Full disclaimer:** I will see your name and address if you use PayPal. Rest assured that I will not share this with anyone.
2017-03-18 01:27:08 +11:00
[![Donations](https://az743702.vo.msecnd.net/cdn/kofi1.png?v=a)](https://ko-fi.com/A8182EB)
2018-07-04 22:28:57 +10:00
**Ethereum address for donations:
2018-02-07 22:37:05 +11:00
0x0f57D98E08e617292D8bC0B3448dd79BF4Cf8e7F**
2018-07-04 22:28:57 +10:00
**Bitcoin address for donations:
2018-02-07 22:37:05 +11:00
3BhwvUsqAGtAZodGUx4mTP7pTECjf1AejT**
2018-02-07 21:10:26 +11:00
2017-03-17 05:22:23 +11:00
### Request a New Feature
[![Feature Requests](http://feathub.com/croneter/PlexKodiConnect?format=svg)](http://feathub.com/croneter/PlexKodiConnect)
2018-04-06 23:38:23 +10:00
### Issues and Bugs
2016-07-16 23:00:06 +10:00
2016-12-05 01:07:34 +11:00
Have a look at the [Github Issues Page](https://github.com/croneter/PlexKodiConnect/issues). Before you open your own issue, please read [How to report a bug](https://github.com/croneter/PlexKodiConnect/wiki/How-to-Report-A-Bug).
2016-07-16 23:00:06 +10:00
2016-03-04 02:58:00 +11:00
2016-07-16 23:00:06 +10:00
### Credits
2015-03-26 05:11:48 +11:00
2016-04-08 23:35:03 +10:00
- PlexKodiConnect shamelessly uses pretty much all the code of "Emby for Kodi" by the awesome Emby team (see https://github.com/MediaBrowser/plugin.video.emby). Thanks for sharing guys!!
- Plex Companion ("PlexBMC Helper") and other stuff were adapted from @Hippojay 's great work (see https://github.com/hippojay).
2016-07-16 23:00:06 +10:00
- The foundation of the Plex API is all iBaa's work (https://github.com/iBaa/PlexConnect).