PlexKodiConnect/README.md

128 lines
9 KiB
Markdown
Raw Normal View History

2017-07-02 22:11:58 +10:00
[![stable version](https://img.shields.io/badge/stable_version-1.8.5-blue.svg?maxAge=60&style=flat) ](https://dl.bintray.com/croneter/PlexKodiConnect/bin/repository.plexkodiconnect/repository.plexkodiconnect-1.0.0.zip)
2017-08-03 04:09:02 +10:00
[![beta version](https://img.shields.io/badge/beta_version-1.8.7-red.svg?maxAge=60&style=flat) ](https://dl.bintray.com/croneter/PlexKodiConnect_BETA/bin-BETA/repository.plexkodiconnectbeta/repository.plexkodiconnectbeta-1.0.0.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)
2017-03-25 01:27:32 +11:00
2017-03-25 01:54:10 +11: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**
2016-12-05 00:38:03 +11:00
PKC combines the best of Kodi - ultra smooth navigation, beautiful and highly customizable user interfaces and playback of any file under the sun - and the Plex Media Server.
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.
2017-03-25 01:21:33 +11:00
### Please Help Translating
2017-04-30 18:45:42 +10:00
Please help translate PlexKodiConnect into your language: [Transifex.com](https://www.transifex.com/croneter/pkc)
2016-12-05 00:44:52 +11:00
### Content
2017-02-05 22:59:30 +11:00
* [**Warning**](#warning)
2017-03-17 18:11:32 +11:00
* [**What does PKC do?**](#what-does-pkc-do)
2017-03-18 01:27:08 +11:00
* [**PKC Features**](#pkc-features)
2017-02-05 23:01:31 +11:00
* [**Download and Installation**](#download-and-installation)
2017-05-30 00:34:42 +10:00
* [**Additional Artwork**](#additional-artwork)
2017-02-05 23:01:31 +11:00
* [**Important notes**](#important-notes)
* [**Donations**](#donations)
2017-03-17 05:27:40 +11:00
* [**Request a New Feature**](#request-a-new-feature)
2017-02-05 23:01:31 +11:00
* [**Known Larger Issues**](#known-larger-issues)
* [**Issues being worked on**](#issues-being-worked-on)
* [**Credits**](#credits)
2016-12-05 00:44:52 +11:00
2016-10-16 23:23:40 +11:00
### Warning
2016-12-05 00:38:03 +11:00
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 ;-)).
2016-10-16 23:23:40 +11:00
2017-03-25 01:52:33 +11:00
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:22:23 +11:00
### What does PKC do?
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 at full speed (cached artwork)
2017-03-25 01:52:33 +11:00
- Automatically get additional artwork (more than Plex offers)
2017-03-17 05:22:23 +11:00
- Enjoy Plex features using the Kodi interface
2016-12-05 01:07:34 +11:00
2017-03-17 05:26:08 +11:00
### PKC Features
2016-04-08 23:35:03 +10:00
2017-03-17 05:22:23 +11:00
- [Amazon Alexa voice recognition](https://www.plex.tv/apps/streaming-devices/amazon-alexa)
- [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
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
- PKC is available in the following languages:
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
2017-04-30 18:45:42 +10:00
+ [Please help translating](https://www.transifex.com/croneter/pkc)
2017-03-18 01:27:08 +11:00
### Download and Installation
2017-03-25 02:22:27 +11:00
Install PKC via the PlexKodiConnect Kodi repository below (we cannot use the official Kodi repository as PKC messes with Kodi's databases). 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.
2017-03-18 01:27:08 +11:00
2017-03-25 02:19:19 +11:00
| Stable version | Beta version |
2017-03-25 02:20:38 +11:00
|----------------|--------------|
2017-03-25 02:19:19 +11:00
| [![stable version](https://img.shields.io/badge/stable_version-latest-blue.svg?maxAge=60&style=flat) ](https://dl.bintray.com/croneter/PlexKodiConnect/bin/repository.plexkodiconnect/repository.plexkodiconnect-1.0.0.zip) | [![beta version](https://img.shields.io/badge/beta_version-latest-red.svg?maxAge=60&style=flat) ](https://dl.bintray.com/croneter/PlexKodiConnect_BETA/bin-BETA/repository.plexkodiconnectbeta/repository.plexkodiconnectbeta-1.0.0.zip) |
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
### Important Notes
1. If you are using a **low CPU device like a Raspberry Pi or a CuBox**, PKC might be instable or crash during initial sync. Lower the number of threads in the [PKC settings under Sync Options](https://github.com/croneter/PlexKodiConnect/wiki/PKC-settings#sync-options). Don't forget to reboot Kodi after that.
2. **Compatibility**:
* PKC is currently not compatible with Kodi's Video Extras plugin. **Deactivate Video Extras** if trailers/movies start randomly playing.
* PKC is not (and will never be) compatible with the **MySQL database replacement** in Kodi. In fact, PKC replaces the MySQL functionality because it acts as a "man in the middle" for your entire media library.
2017-05-06 16:30:20 +10:00
* If **another plugin is not working** like it's supposed to, try to use [PKC direct paths](https://github.com/croneter/PlexKodiConnect/wiki/Direct-Paths-Explained)
2017-03-18 01:27:08 +11:00
### Donations
I'm not in any way affiliated with Plex. Thank you very much for a small donation via ko-fi.com and PayPal if you appreciate PKC.
**Full disclaimer:** I will see your name and address on my PayPal account. Rest assured that I will not share this with anyone.
[![Donations](https://az743702.vo.msecnd.net/cdn/kofi1.png?v=a)](https://ko-fi.com/A8182EB)
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)
2016-07-16 23:00:06 +10:00
### Known Larger Issues
2016-03-25 04:55:17 +11:00
2016-03-24 03:16:32 +11:00
Solutions are unlikely due to the nature of these issues
2016-12-05 00:38:03 +11:00
- A Plex Media Server "bug" leads to frequent and slow syncs, see [here for more info](https://github.com/croneter/PlexKodiConnect/issues/135)
2016-05-01 18:43:55 +10:00
- *Plex Music when using Addon paths instead of Native Direct Paths:* Kodi tries to scan every(!) single Plex song on startup. This leads to errors in the Kodi log file and potentially even crashes. See the [Github issue](https://github.com/croneter/PlexKodiConnect/issues/14) for more details
2016-04-08 23:35:03 +10:00
*Background Sync:*
2016-07-16 23:00:06 +10:00
The Plex Server does not tell anyone of the following changes. Hence PKC cannot detect these changes instantly but will notice them only on full/delta syncs (standard settings is every 60 minutes)
2016-04-08 23:35:03 +10:00
- Toggle the viewstate of an item to (un)watched outside of Kodi
2016-04-22 23:32:32 +10:00
- Changing details of an item, e.g. replacing a poster
2016-05-01 18:45:32 +10:00
2016-04-08 23:35:03 +10:00
However, some changes to individual items are instantly detected, e.g. if you match a yet unrecognized movie.
2016-03-24 03:16:32 +11:00
2016-07-16 23:00:06 +10:00
### Issues being worked on
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).