Skip to content
Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


The Web Portal for Kodi to display, search and download your personal multimedia content


You can try Kodi Web Portal here (

  • Login : kodi
  • Password : K0d1P4s5W0rD


Kodi Web Portal is a web interface to browse, display, search and eventually download your Kodi multimedia content indexed. This web application is very light, without framework (except JQuery) and dependencies.

Kodi Web Portal needs to be deployed with a direct file access to your media content if the downloading feature is enabled. This web application requires an access to the MySQL's Kodi database.

You can use Kodi (XBMC) with a MySQL/MariaDB database to centralized all your multimedia content. This dabatase contains all your movies references, tv shows, details about them (script writers, realisators, actors, studio, synopsis, original title and in your language, etc.), fanart and thumb URLs and file path to play the content.

Kodi Web Portal allows you to access your Kodi's database through a simple web browser.

Alt text Alt text Alt text

Original idea of Kodi Web Portal came from my personal centralization of all backuped movies and tv shows into a Synology NAS. Through this excellent kind of NAS, you can deploy additionnal module in the DSM, like :

  • Web Station : Apache and PHP server
  • MariaDB : fork of MySQL database
  • phpMyAdmin : to administrate the MariaDB database
  • Directory Server : an LDAP server in the Synology for manage users and groups A Synology NAS acts as a complete web server to host my Kodi's data and the Kodi Web Portal.

I wanted to use my Synology NAS with these features to provide a private and personal web interface displaying all my Kodi's movies and TV show scraped, and so, if I was outside home, I would have been able to browse and download my personal content with ease. Kodi Web Portal was born.

Kodi Web Portal interface is available in French (fr), English (en - default) and Spanish (es). Language is automatically choosen depending on your browser's language.


Kodi's versions :

  • Kody Leia 18.2 (default database name "xbmc_video116")
  • Kodi Krypton 17.0 (default database name "xmbc_video107")
  • Kodi Jarvis 16.1 (default database name "xmbc_video99")
  • Kodi Jarvis 16.0 (default database name "xmbc_video99")
  • Kodi Isengard 15.2 (default database name "xbmc_video93")

Kodi Web Portal is configured by default to choose the most recent Kodi's database (xbmc_videoXXX).

System :

  • Apache server with PHP (>= 5.5) (Windows / Linux)
  • Synology NAS (DSM 5, DSM 6)


Access to Kodi Web Portal can be :

  • Anonymous : no login/password required, Kodi Web Portal content is displayed to anyone
  • Internal authentication : user accounts (login / password) are defined in the config.php file
  • LDAP authentication : Kodi Web Portal delegate the authentication to an LDAP directory, with group membership check.
  • Chaining authentication : check authentication with internal account, then LDAP.

Alt text

How to install Kodi Web Portal ?

Just clone the Git repo source code and edit the "config.php" file. Apache server who host the Kodi Web Portal needs :

  • mod_xsendfile : to be able to sent big file, like a movie, through HTTP/HTTPS.
  • PHP >= 5.5, 6 or 7 : if you want to use internal authentication mecanism. Password are hashed with bcrypt.
  • php-pdo_mysql module : to communicate with the Kodi's database MySQL/MariaDB
  • php-ldap module : only if you want to authenticate your users on LDAP directory.
  • access to your multimedia content through filesystem (with mounting point or stored locally)

How to configure my Synology NAS to use Kodi Web Portal?

For this specific deployement on a Synology NAS, you need :

  • Web Station package installed via DSM
  • PHP package installed via DSM
  • MariaDB package installed via DSM
  • phpMyAdmin package installed via DSM (just for administration tasks, this package can be stopped after)
  • Directory Server package installed via DSM (only if you need to manage users and groups through LDAP)

Alt text

Check PHP configuration for loading right modules (pdo_mysql, ldap if needed...) :

Alt text

Configure your Kodi to use the MariaDB/MySQL database on your NAS with a dedicated account (Kodi creates a database like "xbmc_videoXXX" with "XXX" a number automatically defined).

Alt text

Once Kodi has pushed all your multimedia content into the SQL database, check if all your media content files are presents in a dedicated Synology share like "MEDIATHEQUE".

Alt text

Allow the internal Synology user "httpd" to access to this "MEDIATHEQUE" share with "read" permission (in the DSM, edit "permission" on the "MEDIATHEQUE" share, choose "Internal Group" and enable "read" for user "httpd").

Alt text

Finaly, you have to edit an Apache config file manualy through SSH, to add the "/volume1/MEDIATHEQUE" path usable by the X-send-file Apache module (and only this path in the XSendFilePath directive).

  • vi /etc/httpd/conf/extra/mod_xsendfile.conf-user # Synology DSM5
  • vi /volume1/@appstore/WebStation/usr/local/etc/httpd/conf/extra/mod_xsendfile.conf-user # Synology DSM6
  • vi /volume1/@appstore/Apache2.2/usr/local/etc/apache22/conf/extra/mod_xsendfile.conf # Synology DSM6 for package Apache 2.2
  • vi /volume1/.4/usr/local/etc/apache24/conf/extra/mod_xsendfile.conf # Synology DSM6 for package Apache 2.4
  • For the next updates and evolution of DSM version and package version, it's possible to use the following command to find the right mod_xsendfile.conf via SSH : find / -name "*xsendfile*conf*"
XSendFilePath /volume1/MEDIATHEQUE

Alt text

Note : be carefull, after any upgrade of your DSM or WebStation package, XSendFile configuration is reset, so you have to edit this file again to allow download.

Reboot the Synology's Apache server to load the new configuration (stop the package then restart it).

Alt text

Ideas for the future...

  • Adding SQL users authentication
  • Adding users comments on movies / TV show
  • Track movies / tvshow watched by a user himself
  • Create an install.php page with compatibility checks and auto-create config.php file
  • Add "stars" on new entry since the last connection of a user
  • Add "Music" and others Kodi's category
  • Extend functionality with home personal streaming


Thanks to all contributor !

  • vmauduit
  • @boing86
  • @JayRabas


The Web Portal for Kodi to display, search and download your personal multimedia content.



No releases published


No packages published

Contributors 4