Add-on Repository
Install Add-on Repository
Kodi is a free and open source media player application developed by the XBMC Foundation, a non-profit technology consortium. Kodi is available for multiple operating-systems and hardware platforms, featuring a 10-foot user interface for use with televisions and remote controls. Select Install from Repository Kodi Add-on repository Program add-ons Log Viewer for Kodi Install After it installs, you can open it from the same screen where you installed it, or find it from the home screen Add-ons Program add-ons. The OpenWizard Kodi add-on, developed by drinfernoo, is a program add-on built for maintenance, backups, and builds. It’s a great utility add-on that everyone should have available in case you need to clean up some bad add-ons or if you’re interested in builds.
The most convenient install method of our Jellyfin add-ons is to use the official Kodi Jellyfin Repository. Using this repository allows for easy install of our add-ons, as well as automatically keeping the add-ons up to date with the latest version. Any other Jellyfin related add-ons that may be built in the future will also be available here.
The installation method for the repository varies depending on what kind of device you're using, outlined below.
General Use Devices (PCs and Tablets)
- Download the repository installer found here.
- It will be saved as
repository.jellyfin.kodi.zip
- It will be saved as
- Install the Jellyfin repository.
- Open Kodi, go to the settings menu, and navigate to 'Add-on Browser'
- Select 'Install from Zip File'
- If prompted, enter settings and enable 'Unknown Sources', then go back to the Add-on Browser
- Select the newly downloaded file and it will be installed
'Embedded' Devices (Android TV, Firestick, and other TV Boxes)
- Open Kodi, go to the settings menu, and navigate to 'File manager'
- Select 'Add source'
- In the text box, enter
https://kodi.jellyfin.org
- Enter a name for the data source, such as 'Jellyfin Repo' and select Ok
- From the settings menu, navigate to 'Add-on Browser'
- Select 'Install from Zip File'
- If prompted, enter settings and enable 'Unknown Sources', then go back to the Add-on Browser
- Select the data source you just added
- Install
repository.jellyfin.kodi.zip
- Select 'Install from Zip File'
Jellyfin for Kodi
Tip
It's highly recommended to install the Kodi Sync Queue
plugin into the Jellyfin server as well.This will keep your media libraries up to date without waiting for a periodic re-sync from Kodi.
Caution
Remote Kodi databases, like MySQL, are not supported. A local SQLite database is required (this is the default).
Jellyfin for Kodi Overview
This addon syncs metadata from selected Jellyfin libraries into the local Kodi database. This has the effect of making interacting with it feel very much like vanilla Kodi with local media. This means that our Jellyfin content will be displayed on the home screen under the proper media headings by default, it has virtually no delay while interacting with the library, etc. However, it also assumes that it's the only media source and in largely incompatible with other media sources that interact with Kodi's database.
Media in Kodi's database is automatically kept in sync with the server in one of several ways:
- Startup sync - Each time Kodi starts, it will reach out to the Kodi Sync Queue plugin in the server and request all updated media since it's last checkin time (when Kodi was last shut down)
- Live sync - This happens while Kodi is running. When the server updates an item, it will send a notification to Kodi over a websocket connection that it has new media that needs to be updated.
Install Jellyfin for Kodi Add-on
- Install Jellyfin for Kodi.
- From within Kodi, navigate to 'Add-on Browser'
- Select 'Install from Repository'
- Choose 'Kodi Jellyfin Addons', followed by 'Video Add-ons'
- Select the Jellyfin add-on and choose install
- Within a few seconds you should be prompted for your server details.
- If a Jellyfin server is detected on your local network, it will displayed in a dialog
- If a Jellyfin server is not detected on your local network, select 'Manually Add Server'. Enter your server info into the text field.
- Enter the server name or IP address and the port number (default value is 8096)
- Host:
192.168.1.10:8096
- Host:
- If using SSL and a reverse proxy, enter the full URL in the 'Host' field
- Host:
https://jellyfin.example.com
- Host:
- Note that if you have a baseurl set, you should append that value to the end of the host field.
- Host:
192.168.0.10:8096/jellyfin
- Host:
- Enter the server name or IP address and the port number (default value is 8096)
- Select user account and input password, or select 'Manual Login' and fill in your user infomation
- Once you're succesfully authenticated with the server, you'll be asked about which mode you'd like to use, Add-on vs Native, which are outlined below.
Add-on Mode
Add-on mode uses the Jellyfin server to translate media files from the filesystem to Kodi. This is the default setting for the add-on, and is sufficient for most use cases. It will work both on the local network and over the Internet through a reverse proxy or VPN connection. Providing network speed is sufficient, Kodi will direct play nearly all files and put little overhead on the Jellyfin server.
To use Add-on mode, simply choose 'Add-on' at the dialog and proceed to Library Syncing
Native Mode
Native mode accesses your media files directly from the filesystem, bypassing the Jellyfin server during playback. Native mode needs more setup and configuration, but it can, on rare occasions, lead to better performance where network bandwidth is a limitation. It requires your media to be available to the device Kodi is running on over either NFS or Samba, and therefore should only be used on a LAN or over a VPN connection.
To use Native mode, first set up your libraries in Jellyfin with a remote path.
- In the Jellyfin server, navigate to the Libraries section of the admin dashboard.
- Select an existing library (or create a new one)
- Select the media folder
- Enter the path to your network share in the 'Shared network folder' textbox
- Possible formats:
- NFS
nfs://192.168.0.10:/path/to/media
- Samba
- Guest User -
192.168.0.10share_name
- Custom User (Not Recommended) -
user:password@192.168.0.10share_name
- It's more secure to use the generic Guest mapping here and specify credentials from within Kodi
- Guest User -
- Mounted share
- If you have mounted your network share, you can reference the local mount point. This can be more performant but generally means it only works for one type of operating system, given the difference between the file systems
/mnt/media
(Linux)Z:media
(Windows)/Volumes/media
(Mac OS)
- If you have mounted your network share, you can reference the local mount point. This can be more performant but generally means it only works for one type of operating system, given the difference between the file systems
- NFS
- Configure libraries in Kodi
- Skip the initial library selection. We need to add file shares to Kodi first
- Within Kodi, navigate to the settings menu and select 'File manager'
- Select 'Add source'
- Select 'Browse' and 'Add network location'
- Create either a NFS or SMB location from the selection box and fill in the necessary information about your network share
- If you are using a mounted share, browse to the mount point on your file system rather than the network share
- Select your newly created location and choose 'Ok'
- Give your media source a name and choose 'Ok'
- Go to Add-ons -> Jellyfin -> Manage Libraries -> Add Libraries
- Proceed to Library Syncing
Library Syncing
This screen allows you to choose which libraries to sync to your Kodi install. This process will copy metadata for your media into the local Kodi database, allowing you to browse through your media libraries as if they were native to your device.
Either choose 'All' or select individual libraries you'd like synced, and select OK. Syncing the metadata will start automatically. The duration of this process varies greatly depending on the size of your library, the power of your local device, and the connection speed to the server.
You can still access any libraries that haven't been synced by going through the Jellyfin add-on menu. These unsynced libraries will be labeled as 'dynamic.'
If an error occurs during syncing, enable debug logging in the Jellyfin add-on in Kodi and if in a Unix-like OS, set the log level of Samba to 2 to see if there are issues authenticating.
Multiple User Accounts
The Jellyfin for Kodi addon doesn't natively handle multiple user accounts. Fortunately, Kodi has a built in method of handling this called profiles. Information about this can be found on the Profiles page of the Kodi Wiki. Once profiles have been created, you must install the Jellyfin add-on and go through the installation steps above for each user profile. When you switch Kodi profiles, you will also switch Jellyfin users. You can tell Kodi to bring you to a profile login screen during startup by going to the Profiles section inside of the Settings page and checking the box for 'Show login screen on startup.'
Note
Kodi's default skin does not display all unicode characters. To display unicode characters the skin's font must be changed.
Multiple Clients
When using multiple Kodi clients do not copy Kodi's database (i.e. myvideosXYZ.db
, jellyfin.db
) files from one client to the other to try and reduce initial syncing time. This will partially work, but it will cause conflicts between clients and the sync process from the server won't work properly.
JellyCon
JellyCon Overview
JellyCon behaves more like a standard Kodi streaming addon. Media is accessed primarily by going through the Add-ons -> JellyCon menu, however depending on what skin is being used custom shortcuts and widgets can be added to the home menu. It also allows easier switching between multiple Jellyfin servers or users since it doesn't have to rely on syncing all the metadata down. By not having metadata synced, it has to request info from the server which can take a bit more time when you're browsing, but you don't have to wait for the database to sync or keep it up to date. It's also compatible with other media sources and can be used with other add-ons without issue.
Install JellyCon Add-on
- Instally JellyCon Add-on
- From within Kodi, navigate to 'Add-on Browser'
- Select 'Install from Repository'
- Choose 'Kodi Jellyfin Addons', followed by 'Video Add-ons'
- Select the JellyCon add-on and choose install
- Within a few seconds you should be prompted for your server details.
- If a Jellyfin server is detected on your local network, it will displayed in a dialog. Otherwise, you will be prompted for a URL
- Select a user from the list, or Manual Login to type in a username/password
Configuring Home
Many Kodi skins allow for customizing of the home menu with custom nodes and widgets. However, all of these use slightly different layouts and terminology. Rather than a step by step guide, this section serves as an barebones introduction to customizing a skin.
Examples
If you would like a link on the home screen to open a library in your Jellyfin server called 'Kid's Movies', you would point the menu item to the path: Add-On -> Video Add-On -> JellyCon -> Jellyfin Libraries -> Kid's Movies -> Create menu item to here
.
Beyond just modifying where the home menu headers go, many skins also allow you to use widgets. Widgets help populate the home screen with data, often the posters of media in the selected image. If you would like to display the most recent movies across all of your Jellyfin libraries on the home screen, the path would be: Add-On -> Video Add-On -> JellyCon -> Global Lists -> Movies -> Movies - Recently Added (20) -> Use as widget
Another common use case of widgets would be to display the next available episodes of shows that you may be watching. As above, this can be done both with individual libraries or with all libraries combined:
Add-On -> Video Add-On -> JellyCon -> Jellyfin Libraries -> Anime -> Anime - Next Up (20) -> Use as widget
Add-On -> Video Add-On -> JellyCon -> Global Lists -> TV Shows -> TV Shows - Next Up (20) -> Use as widget
Having Kodi issues? Want help from us? Let us show you how to check log files in Kodi so that you can better help us assist you!
Checking log files in Kodi before you report an issue can give you a better idea of what issues you have and you might even be able to solve them yourself!
If you aren’t aware, Kodi tracks everything you do, from opening add-ons, attempting to stream files, and every keyboard press you make. If you receive an error on the dreaded “check log for more information” error in Kodi, you should know what to do!
The log files in Kodi are saved in a system folder on your computer or Kodi box, but there is a nice Kodi add-on that has a nice built-in tool for creating and uploading log files in Kodi addons.
A log file is necessary for us to troubleshoot issues for users on social media. If you have the problem “X doesn’t work” and you want us to help you, we require a log file or else we just can’t help you out. There are far too many factors that might be at fault such as version of Kodi, addon being used, specific stream, dependencies, builds, and other things.
To create and upload log files in Kodi, follow our guide below:
How to Check Log Files in Kodi / Upload Log Files
- First, enable debugging on Kodi. From the main menu, navigate to SYSTEM > SYSTEM > Logging (make sure your Settings level is Standard or Expert if you don’t see this) > Turn on the “Enable Debug Logging” option.
- From the Kodi main menu, navigate to SYSTEM > Add-ons > Install From Repository > Kodi Add-on Repository.
- Select Program Add-ons > Kodi Log Uploader > Install and wait for the add-on enabled notification.
- Restart Kodi
- Go through the process of recreating whatever it is that doesn’t work for you in Kodi.
- When you are done, launch Kodi Log Uploader from your Program add-ons folder.
- Wait a moment and the Kodi Log Updater program will automatically upload your log to the internet. It will give you an ubuntu.com address you can copy down.
- You can visit this web address to view and assess your log files in Kodi.
Kodi Log File Reading Tips
Here are some helpful tips on how to read log files and find what you want.
- Log files show a history of the time you enabled your debug logging to the time that you uploaded your log file. In order to find your error, you need to reproduce it before creating your log.
- The start of the log file contains system information about Kodi, including what addons and dependencies you have installed and the version number of all of your modules. This is helpful when sending your log to another person so that they can understand your system.
- Underneath the system information is a chronological order of all mouse clicks and movements you made in Kodi. Each time you take an action, Kodi loads the next screen or window and tells you in the log how it loaded.
- If you want to quickly find your “Error – Check Log File” issues, open up the find window (ctrl/command + F) and search for ERROR. This will return all of the specific error you ran into and take you immediately to where your issue is.
Now, if you need help from us with your Kodi issues, send us your log files on Twitter or Facebook.
PROTECT YOURSELF ON THE INTERNET
View Status In Kodi Build
Sign up for a premium Kodi VPN and access the internet unrestricted. We offer exclusive discounts for NordVPN, the highest respected VPN in the Kodi community. It has some great features for users:
Apps for Android, iOS, Mac, Linux & more
Zero Logs
Unlimited bandwidth
Tier 1 hardware (no speed slowdown)
Access to servers hundreds of VPN servers