Kodi Media Center

If you haven’t heard already, Kodi is available with Batocera. It’s been preinstalled and configured for controller support.

Kodi is a free and open-source media player software application developed by the XBMC Foundation, a non-profit technology consortium. Kodi is available for multiple operating systems and hardware platforms, with a software 10-foot user interface for use with televisions and remote controls or gamepads. It allows users to play and view most streaming media, such as videos, music, podcasts, and videos from the Internet. It supports all common digital media files from local and network storage media.

To launch Kodi, please follow the steps below.

  • Make sure Kodi is enabled in the SYSTEM SETTINGSKODI SETTINGS menu
  • From this menu, you can associate Kodi to the X button, or enable it at Batocera start.
  • Then, when enabled and depending on the configuration options, you can launch Kodi with the X button, or the first entry in the main menu when you press the start button on your controller.
  • Once you are in the Kodi interface, to exit and get back to Batocera's game menu, you can press select and click on the on/off icon in the top left corner of the screenshot below, and select exit from this menu.

If you have a Netflix account, you can use Kodi to watch Netflix shows. However, by default, you'll need to enter your Netflix credentials on each reboot. The reason is, by default, Batocera Linux creates a unique machine-id on every boot, and if the Kodi Netflix plugin sees a new machine-id, it requires you to log in again.

Workaround to force always the same machine-id:

1. Log through SSH on your Batocera machine.

2. Save permanently your current machine-id with the following commands:

 # cat /var/lib/dbus/machine-id > /userdata/system/machine-id
 # ln -sf /userdata/system/machine-id /var/lib/dbus/machine-id
 # batocera-save-overlay

3. Now, your UUID is saved in /userdata/system/machine-id and will not change on each reboot, and Netflix shouldn't ask for your credentials every time.

Caveat: you have to recreate the symbolic link and save the overlay after each Batocera upgrade/downgrade.

To fix local network access (such as NAS, networked TV devices, media servers, etc.) for Kodi on Batocera there is a very simple thing to do!

In Kodi, navigate to SettingsServicesSMB client

And change its two parameters:

Minimum protocol version:
Maximum protocol version:


Minimum protocol version: SMBv2
Maximum protocol version: SMBv3
  • Minimum protocol version - Set the minimum SMB protocol version to negotiate when making connections. Forcing SMBv2 may be required to prevent SMBv1 use on some OS. SMBv1 is not recommended for security reasons.
  • Maximum protocol version - Set the maximum SMB protocol version to negotiate when making connections. Forcing SMBv2 or SMBv1 compatibility may be required with older NAS's and Windows' shares. Sometimes, access to specific SMB versions can be adjusted from the server (NAS, Windows computer hosting the share, etc.) itself. Always use as high a version of SMB as possible.

With this in mind, consider that Batocera is not a secure operating system and take care when adjusting network settings on your other devices.

Some NAS vendors support only older versions of SMB. Known examples are:

  • Freebox Revolution - Set the mininum protocol version to SMBv1.
  • Orange Livebox 2019 - Set the mininum protocol version to SMBv1.

Source: https://kodi.wiki/view/Settings/Services/SMB_Client#Minimum_protocol_version

  • kodi.txt
  • Last modified: 6 weeks ago
  • by atari