Add-on:Emby for Kodi

From Official Kodi Wiki
Jump to navigation Jump to search

Emby for Kodi

Author: xnappo, null_pointer, im85288
Website: link
Type: Music/Audio and Video
Repo:

License: GPL v2.0
Source: Source code
Summary: Allows Kodi to use an Emby Server as a media management backend. This add on effectively replaces the Kodi built-in media database with the Emby Server. Currently supported media includes Movies, TV Episodes, & Music.
Home icon grey.png   ▶ Add-ons ▶ Emby for Kodi
Attention talk.png Need help with this add-on? See here.

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 an Emby Server as a media management backend. This add-on effectively replaces the Kodi built-in media database with the Emby Server. Currently supported media includes Movies, TV Episodes, & Music.

A quick intro video from one of the dev's: https://youtu.be/IaecDPcXI3I?t=119


Setting up Emby

Basic Setup

  1. Download and install Emby server for your desired operating system: http://emby.media/download/
  2. Open the Emby web interface @ http://[server ip address]:8096
  3. Follow the instructions as prompted
  4. Enable path substitution, if necessary
a. Select Library from the left side of the server management page
b. Select Path Substitution
c. Setup all path substitutions

Optional: Plugins

Installation of Emby plugins (Add-ons) is done from the Emby Server 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 Emby for Kodi Sync Queue to install it.

Useful Emby Plugins

  1. Emby for Kodi Sync Queue: 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 the Emby Server 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 Emby for Kodi

Step 1: Download the Emby for Kodi repository.

a. Stable Repository
b. Beta Repository

Step 2: Open Kodi.

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 the Emby server 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

Emby Tab

- Primary Server Address
=> This is the IP address of the computer running Emby Server
- Port Number
=> The port used by the Emby Server (Defaut: 8096)
- Enable HTTPS
=> Enable to use HTTPS instead of HTTP
- 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 server both on a local network and remotely
- Secondary Server Address
=> Secondary IP address for Emby Server.
- Enable HTTPS
=> Enable to use HTTPS instead of HTTP
- Verify Host SSL Certificate
=> description
- Client SSL certificate
=> description
- Username
=> Emby Server primary username
- Use alternate Device Name
=> Allows you to set the device name, as seen by Emby server
- Device Name
=> Custom Device name seen by Emby Server

Sync Options Tab

- 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 Server
- Direct stream music library
=> Directly play music from network shares, instead of through Emby Server
- Use local paths instead of addon redirect for playback
=> Directly play videos from network shares, instead of through Emby Server
- 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 on Emby Server
- 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


Extra Info

Note: This page is currently in the process of being updated.
See: https://github.com/MediaBrowser/Emby.Kodi/wiki