Add-on:Emby for Kodi: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
(24 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{Addon
{{Add-on
|Name=Emby for Kodi
|Name=Emby for Kodi
|provider-name=xnappo, null_pointer, im85288
|provider-name=angelblue05, marcelveldt, null_pointer, xnappo, im85288, jurmb84(sync plugin)
|ID=plugin.video.emby
|ID=plugin.video.emby
|latest-version=1.1.39
|latest-version=2.2.19
|extension point=xbmc.python.pluginsource
|extension point=xbmc.python.pluginsource
|provides=video audio
|provides=video audio
|Summary=Allows Kodi to use an Emby as a media management backend. This add on effectively replaces the Kodi built-in media database with Emby. Currently supported media includes Movies, TV Episodes, & Music.
|Summary=Allows Kodi to use Emby as a media management back-end.
|Description=The Emby addon for Kodi combines the best of Kodi - ultra smooth navigation, beautiful UIs and playback of any file under the sun, and [https://emby.media Emby] - the most powerful fully open source multi-client media metadata indexer and server.
<br />
|Platform=all
|Platform=all
|Language=en
|Language=en
|License=GNU GENERAL PUBLIC LICENSE. Version 2, June 1991
|License=GNU GENERAL PUBLIC LICENSE. Version 2, June 1991
|Forum=http://emby.media/community/index.php?/forum/99-kodi/
|Forum=https://emby.media/community/index.php?/forum/99-kodi/
|Website=http://emby.media/
|Website=https://emby.media Emby
|Source=https://github.com/MediaBrowser/Emby.Kodi
|Source=https://github.com/MediaBrowser/plugin.video.emby Github
|repo= [http://www.mb3admin.com/downloads/addons/xbmb3c/kodi-repo/repository.emby.kodi-1.0.2.zip Emby for Kodi Repository]
|Email=
|Email=
|repo=[http://embydata.com/downloads/addons/xbmb3c/repo-install/repository.emby.kodi-1.0.3.zip Kodi Emby Repository - Version 1.0.3]
|broken=
|broken=
|icon url=}}
|icon url=https://raw.githubusercontent.com/MediaBrowser/Emby.Resources/master/images/Logos/logoicon.png
|repo=[https://emby.media/]
}}


== Introduction ==  
== Introduction ==
<section begin="intro"/>Emby is a media management server that allows you to synchronize media libraries, watched status, and watch progress between compatible devices. Emby for Kodi allows Kodi to use an Emby as a media management backend. This add-on effectively replaces the Kodi built-in media database with Emby. Currently supported media includes Movies, TV Episodes, & Music. <section end="intro"/>
<section begin="intro"/>Emby is a media management server that allows you to synchronize media libraries, watched status, and watch progress between compatible devices. Emby for Kodi allows Kodi to use Emby as a media management back-end. This add-on effectively replaces the Kodi built-in media database with Emby. Supported media includes movies, series, music and more.<section end="intro"/>


A quick intro video from one of the dev's: https://youtu.be/IaecDPcXI3I?t=119
=== Overview of Steps===
# Install & set up Emby server
# Install Emby add-on in Kodi
# Configure Emby add-on in Kodi
 
A quick intro video:
 
{{youtube|IaecDPcXI3I}}
 
{|
|| {{divbox|yellow||<big>'''NOTICE:''' This add-on completely takes over the Kodi database, so be sure to do a backup before you begin.</big>}}||
|}
 
<big>Reference: [[Import-export_library]]</big>


<br />
<br />
== Setting up Emby ==
 
== Setting up your Emby server ==


=== Basic Setup ===
=== Basic Setup ===
# Download and install Emby for your desired operating system: http://emby.media/download/
# Download and install Emby for your desired operating system: https://emby.media/download/
# Open the Emby web interface @ http://[server ip address]:8096
# Open the Emby web interface @ http://[server ip address]:8096
# Follow the instructions as prompted
# Follow the instructions as prompted
# Enable path substitution, if necessary
# Set up your libraries Emby and include "Optional Network Paths": [https://support.emby.media/support/solutions/articles/44001159319-library-setup]
::a. Select Library from the left side of the server management page
::b. Select Path Substitution
::c. Setup all path substitutions


=== Optional: Plugins ===
=== Optional: Plugins ===
;: Installation of Emby plugins (Add-ons) is done from the Emby web interface
;: Installation of Emby plugins (Add-ons) is done from the Emby web interface
# Navigate to http://[server ip address]:8096/web/dashboard.html
# Navigate to http://[server ip address]:8096/web/dashboard.html
# Select Plugins from the left side
# Select '''Plugins''' from the left side
# Select Catalog from within the right side of the window
# Select '''Catalog''' from within the right side of the window
# Scroll down to general and select Emby for Kodi Sync Queue to install it.
# Scroll down to general and select the desired pugin to install it.
# Restart your Emby service by clicking on '''Dashboard''' and then the little power icon next to the server name, select '''Restart Emby Server'''
==== Useful Emby Plugins ====
==== Useful Emby Plugins ====
# Emby for Kodi Sync Queue: This plugin will speed up the media sync done by kodi on every startup
# Kodi Companion: This plugin will speed up the media sync done by Kodi on every startup
# Auto-Box Set:  Automatically organizes Movies into sets (collections in Emby), based on data from themoviedb.org
# Auto Box Set:  Automatically organizes Movies into sets (collections in Emby), based on data from themoviedb.org
# Trakt.tv:  Sync's watched status between Emby and trakt.tv
# Trakt.tv:  Sync's watched status between Emby and trakt.tv
::Disable Trakt.tv add-on from all kodi installs, if this is used.
::Disable Trakt.tv add-on from all kodi installs, if this is used.
<br />
 
;For further information or a more detailed explanation of the installation process, please see [https://github.com/MediaBrowser/Wiki/wiki/Installation the Emby Official Wiki page]
;For further information or a more detailed explanation of the installation process, please see [https://github.com/MediaBrowser/Wiki/wiki/Installation the Emby Official Wiki page]


<br />
<br />


== Installing Emby for Kodi ==
== Installing the Emby add-on for Kodi ==
 
{|
|| {{divbox|yellow||<big>'''NOTICE:''' It is recommended to start with a fresh Kodi install. Otherwise, remove any Kodi sources added as Emby libraries. </big>}}||
|}


'''Step 1:''' Download the Emby for Kodi repository.
'''Step 1:''' Download the Emby repository.
::a. [http://www.mb3admin.com/downloads/addons/xbmb3c/kodi-repo/repository.emby.kodi-1.0.2.zip Stable Repository]
More info on: https://kodi.emby.media/
::b. [http://www.mb3admin.com/downloads/addons/xbmb3c/kodi-beta-repo/repository.beta.mediabrowser.kodi-1.0.4.zip Beta Repository]
::a. [https://github.com/MediaBrowser/plugin.video.emby/wiki/Emby-Repository No Side-Loading Method] - Set up a new https source and download the add-in (no external media required)
::b. [https://kodi.emby.media/repository.emby.kodi-1.0.6.zip Stable Repository] - Load via USB or other media
::c. [https://kodi.emby.media/repository.beta.emby.kodi-1.0.9.zip Beta Repository] - Load via USB or other media
<br />
'''Step 2:''' Open Kodi.
'''Step 2:''' Open Kodi.


Line 69: Line 92:
</gallery>
</gallery>


;At this point Emby for Kodi is installed and it has connected to your Emby server.  You should see a box in on the screen showing the progress of the import from Emby into the Kodi database.
;At this point Emby for Kodi is installed and it has connected to your Emby server.  You should see the progress of the import from Emby into the Kodi database.


<br />
<br />
Line 78: Line 101:
;# Select Configure
;# Select Configure


=== Emby Tab ===
View the Emby for Kodi settings here: [https://github.com/MediaBrowser/plugin.video.emby/wiki/Emby-for-kodi-settings Settings Details]
[[File:Emby_for_Kodi_Emby.PNG|none|500px]]
<br />
:- Primary Server Address
== Bug and issue report ==
::=> ''This is the IP address of the computer running Emby''
Please follow our guide: [https://emby.media/community/index.php?/topic/17599-how-to-report-a-problem/ How to report your issue]<br />
:- Port Number
For faster support, post your inquiries on our [https://emby.media/community/index.php?/forum/99-kodi/ Emby for Kodi forums]
::=> ''The port used by Emby (Defaut: 8096)''
<br />
:- Enable HTTPS
== Emby Shortcuts on the Kodi Home Screen ==
::=> ''Enable to use HTTPS instead of HTTP''
Basic knowledge will help you for most skins. The add-on will automatically tag your content by Emby library name and recreate your them as Video Nodes and Playlists.
::- Verify Host SSL Certificate
:::=> ''description''
::- Client SSL certificate
:::=> ''description''
:- Use alternate address
::=> ''Enable secondary server address.  This is useful for mobile devices that will access Emby both on a local network and remotely''
::- Secondary Server Address
:::=> ''Secondary IP address for Emby.''
::- Enable HTTPS
:::=> ''Enable to use HTTPS instead of HTTP''
:::- Verify Host SSL Certificate
::::=> ''description''
:::- Client SSL certificate
::::=> ''description''
:- Username
::=> ''Emby primary username''
:- Use alternate Device Name
::=> ''Allows you to set the device name, as seen by Emby''
::- Device Name
:::=> ''Custom Device name seen by Emby''
 
=== Sync Options Tab===
[[File:Emby_for_Kodi_Sync_Options.PNG|none|500px]]
:- Show sync progress on screen
::=> ''Toggle on to display sync progress pop-up within Kodi''
:- Sync specials ordering
::=> ''description''
:- Sync empty TV Shows
::=> ''Add TV Shows to Kodi Library that do not currently have any associated episodes in the library''
:- Enable Music Library Sync
::=> ''Sync Kodi Library to Emby''
::- Direct stream music library
:::=> ''Directly play music from network shares, instead of through Emby''
::- Use local paths instead of addon redirect for playback
:::=> ''Directly play videos from network shares, instead of through Emby''
:- Auto add images to the Kodi texture cache
::=> ''Add Images to Kodi texture cache during sync.''
:- Use incremental sync at startup (Requires Server Plugin)
::=> ''Limit startup sync data to only changes, instead of the full library''
::: ''Requires "Emby for Kodi Sync Queue" plugin to be installed in Emby''
::- Max change set size
:::=> ''description''
 
=== Playback Tab ===
:- Network username
::=> ''Username used to connect to SMB shares''
:- Network Password
::=> ''Password used to connect to SMB shares''
:- Offer delete after playback
::=> ''Enables a prompt that will show up after watching a video.''
::: ''This prompt gives the user the option to delete the video from the Emby library''
::- For Episodes
:::=> ''Enable prompt to delete video for Episodes''
::- For Movies
:::=> ''Enable prompt to delete video for Movies''
:- On Resume jump Back Seconds
::=> ''On resume, the video will start a specified number of seconds before the point at which it was stopped''
:- Play from HTTP instead of SMB
::=> ''Use the Emby HTTP server for playback source, instead of SMB shares''
::- Video Quality
:::=> ''Specify the maximum video transfer rate''
 
=== Extras Tab ===
:- Disable Enhanced Images (eg CoverArt)
::=> ''Disable special images i.e. CoverArt''
::- Force CoverArt Ratio
:::=> ''Resize CoverArt to match Kodi sizes (may result in images being distorted)''
:- Ignore specials in next episodes
::=> ''Causes "Next Episodes" to ignore all special episodes''
:- Permanent users to add to the session
::=> ''List of all other uses whose watched status should be updated when videos are watched''
 
=== Advanced Tab ===
:- Log Level:
::=> ''Select level of data to be included in the log (None/Info/Debug)''
:- Suppress server connection message on start-up
::=> ''Suppress welcome message when connecting to Emby''
:- Enable server message when it's restarting
::=> ''Enable notification that Emby has restarted''
:- Reset Local Kodi DB
::=> ''Completely wipe data out of local Kodi database''
::: ''Requires Kodi to be restarted''


'''Step 1: Step "Simple"'''
# Your only job as a user is to add the Emby library shortcuts created for you to your Home Screen.
<br />
<br />
== Extra Info ==
== Extra Info ==
 
:See: '''[https://github.com/MediaBrowser/Emby.Kodi/wiki Emby for Kodi Github Wiki]'''
:'''Note: This page is currently in the process of being updated.'''
:See: '''https://github.com/MediaBrowser/Emby.Kodi/wiki'''

Revision as of 09:12, 31 August 2020

Emby for Kodi
https://raw.githubusercontent.com/MediaBrowser/Emby.Resources/master/images/Logos/logoicon.png

Author: angelblue05, marcelveldt, null_pointer, xnappo, im85288, jurmb84(sync plugin)
Website: Emby link
Type: Music/Audio and Video
Repo:

License: GPL v2.0
Source: Github Source code
Summary: Allows Kodi to use Emby as a media management back-end.
Home icon grey.png   ▶ Add-ons ▶ Emby for Kodi
Attention talk.png Need help with this add-on? See here.

The Emby addon for Kodi combines the best of Kodi - ultra smooth navigation, beautiful UIs and playback of any file under the sun, and Emby - the most powerful fully open source multi-client media metadata indexer and server.

Introduction

Emby is a media management server that allows you to synchronize media libraries, watched status, and watch progress between compatible devices. Emby for Kodi allows Kodi to use Emby as a media management back-end. This add-on effectively replaces the Kodi built-in media database with Emby. Supported media includes movies, series, music and more.

Overview of Steps

  1. Install & set up Emby server
  2. Install Emby add-on in Kodi
  3. Configure Emby add-on in Kodi

A quick intro video:

Reference: Import-export_library


Setting up your Emby server

Basic Setup

  1. Download and install Emby for your desired operating system: https://emby.media/download/
  2. Open the Emby web interface @ http://[server ip address]:8096
  3. Follow the instructions as prompted
  4. Set up your libraries Emby and include "Optional Network Paths": [1]

Optional: Plugins

Installation of Emby plugins (Add-ons) is done from the Emby web interface
  1. Navigate to http://[server ip address]:8096/web/dashboard.html
  2. Select Plugins from the left side
  3. Select Catalog from within the right side of the window
  4. Scroll down to general and select the desired pugin to install it.
  5. Restart your Emby service by clicking on Dashboard and then the little power icon next to the server name, select Restart Emby Server

Useful Emby Plugins

  1. Kodi Companion: This plugin will speed up the media sync done by Kodi on every startup
  2. Auto Box Set: Automatically organizes Movies into sets (collections in Emby), based on data from themoviedb.org
  3. Trakt.tv: Sync's watched status between Emby and trakt.tv
Disable Trakt.tv add-on from all kodi installs, if this is used.
For further information or a more detailed explanation of the installation process, please see the Emby Official Wiki page


Installing the Emby add-on for Kodi

Step 1: Download the Emby repository. More info on: https://kodi.emby.media/

a. No Side-Loading Method - Set up a new https source and download the add-in (no external media required)
b. Stable Repository - Load via USB or other media
c. Beta Repository - Load via USB or other media


Step 2: Open Kodi.

At this point Emby for Kodi is installed and it has connected to your Emby server. You should see the progress of the import from Emby into the Kodi database.


Configuring Emby for Kodi Add-on

  1. Navigate to System > Add-ons > My add-ons > Video add-ons
  2. Open Emby
  3. Select Configure

View the Emby for Kodi settings here: Settings Details

Bug and issue report

Please follow our guide: How to report your issue
For faster support, post your inquiries on our Emby for Kodi forums

Emby Shortcuts on the Kodi Home Screen

Basic knowledge will help you for most skins. The add-on will automatically tag your content by Emby library name and recreate your them as Video Nodes and Playlists.

Step 1: Step "Simple"

  1. Your only job as a user is to add the Emby library shortcuts created for you to your Home Screen.


Extra Info

See: Emby for Kodi Github Wiki