| To-do list for Kodibuntu:
There's two big areas of "to do" for this page:
One is the namechange from XBMC to Kodi, and the current assumption is that XBMCbuntu will become something like KodiBuntu. Since the page still needs to make sense for existing XBMC installs, just write "XBMCbuntu/KodiBuntu" for the time being.
The other area is transitioning this entire page to a basic how-to on just getting XBMC on a dedicated box. This likely needs to mention OpenELEC and how KodiBuntu compares to it, why people would choose one or the other, etc. OpenELEC is considered by Team XBMC/Kodi to be an officially sanctioned version of XBMC/Kodi.
- Specific to-do items
- The start of the page should be expanded (but not be too long) with a basic no-nonesense explanation about what KodiBuntu is and why someone would want to use it. This needs to be written so that totally new users can understand this.
- Basic usage needs to be covered, like switching between Kodi or the desktop mode. Things like installing drivers, using a web browser, configuring wifi via the GUI, should also be covered, but feel free to just use links for generic lubuntu advice if it applies.
- A separate KodiBuntu-specific troubleshooting page should be created and a section on this page should be made to lead into and link to that troubleshooting page.
- Anything more technical should be covered by more general Linux/Ubuntu related pages on the wiki.
Kodibuntu is a combination Kodi/operating system for use on PCs that are mainly just running Kodi. It is an alternative to installing Windows or a larger (and sometimes more complicated) Linux-based OS.
1 Hardware requirements
Kodibuntu should work with the general hardware requirements for Linux:
| Click to show hardware requirements -->
Note: Although Ubuntu 12.04 LTS is still being maintained by Canonical, Team Kodi no longer provides binaries for it. Kodi v15 for Ubuntu requires at least Ubuntu 14.04/15.04.
|| x86 or x86-64 processor such as: Intel Pentium 4/ Pentium M, AMD Athlon 64 / Opteron, or newer CPU (that support SSE2, which all CPUs made within the last 10-years does).
- If your GPU/VPU does not support hardware video decoding then you will require a fast modern processor is required to decode some 1080p videos encoded in H.264, VC-1/WMV9, HEVC/H.265 VP9, etc
- There is very limited Power PC (PPC) support: [Linux] How to install on Linux-ppc
- Recommended: 1GB or more in a HTPC media player appliance-like computer dedicated for Kodi, and 2GB or more in a computer for multipurpose use.
Kodi will run on most graphics cards made within the last 10-years or so, though for good hardware video decoding support a little newer graphics cards can be required. This includes most cards from AMD/ATI, Intel, or NVIDIA which support OpenGL 2.0 or later.
| Video decoding
|| For hardware video decoding, which may be necessary on low-performance CPUs to playback 1080p content, make sure your GPU or VPU supports either VAAPI, VDPAU, or OpenMAX.
Ubuntu 12.10 (or newer) users of ATI graphics cards are recommended to use a UVD 2.2 or higher graphics card
for proper hardware video decoding support.
| Drive space
|| The Kodi application generally only takes up between 100 to 200 MB of space, depending on how the binary is compiled. Technically speaking, if your hardware supports netbooting, you do not even require a internal storage for either the operating-system or for Kodi.
- Minimum: 4 to 8GB
- Recommended: 16GB or more
- Depending on how big your video library is. Most of the space required for Kodi comes from the images/artwork cache, which can be adjusted: HOW-TO:Reduce disk space usage.
Kodibuntu comes in an ISO form that can be written to a USB drive or burned to an optical disc.
Download the current stable Kodibuntu image from:
The Complete installation guide can be found here: Kodi Linux - The Complete Guide
- Kodibuntu has only one iso image file for all x86 computers, regardless of GPU.
- Currently, only a 64-bit version is available, but this should cover the vast majority of users.
- A pre release 32bit exists in mirrors with unstable ppa and RC candidate Kodi, which can be upgraded to stable kodi
- There will be no separate Kodibuntu release for Kodi 15.x as it's based on the same OS. To get Kodi 15.x on Kodibuntu, just upgrade the software as suggested below
Current Kodibuntu is based on a LTS release (long term release) which is supported for 5 years, this means that it isn't required to upgrade the OS base in order to obtain updated or upgraded application packages.
3.1 How to upgrade Kodi
To update Kodi when a new version is released, just do a general system/package or use the following commands in the terminal (or via SSH):
sudo apt-get update
sudo apt-get upgrade
In some cases where additional packages are required, Kodi will fail to upgrade when using the upgrade commands as above. To install additional packages use the command below:
sudo apt-get dist-upgrade
3.2 When to upgrade the OS
See Current Ubuntu releases if your current distro is listed under End of life table, you will need to upgrade your OS to a supported release.
3.3 How do I upgrade the Kodibuntu base OS?
To actually upgrade the underlying Linux which "Kodibuntu" is based on, it is possible to do so via release upgrade.
There are advantages and disadvantages to doing so. It's not a method recommended lightly to inexperienced users, doing so means you understand and accept responsibility for breaking your system.
BACKUP! Never attempt any upgrades without having proper backups of the files you consider important or value or have a full system image/backup of working system you can restore.
RECOMMENDED! It is possible (in order to preserve systems tweaks) to just upgrade Kodi itself by treating it as a normal Linux package and update/install via: Upgrading Kodi via ppa in Kodibuntu
sudo apt-get update
sudo apt-get install update-manager-core
This should upgrade your Base distribution, however if your current version is too old it may require repeating these steps until you reach the desired version.
Do note that this is not recommended to inexperienced Linux users in case of breakages that you wont be able to resolve.
4 Basic use
4.1 Desktop mode
Kodibuntu can boot directly into Kodi or it can also boot into a desktop mode for using applications such as a web browser.
In order to enter desktop mode, follow those steps below:
Step 2: Select Lubuntu and enter your username and password.
The username may differ from the one you supplied during installation. So please be aware, that "xbmc" (as shown in the screenshot) might not be the username you will see and/or have to use.
Note: If you last booted directly or switched to desktop and shutdown the HTPC while in desktop, on next reboot you will get the last used session by default.
To return to Kodi, logout, select Kodi as session in the top-right pulldown menu and enter your username and password again.
To login to the command line interface press Ctrl+Alt+F1 - F6 or connect over SSH by using usernamne and password supplied during installation.
Note: For the use of Ctrl+Alt+F1 - F6 no username and password is required. You are logged in directly to the command line.
4.3 Media center
Kodibuntu contains Kodi for Linux compiled with the 'standalone' mode, this enabled certain functions that are not available in normal Kodi installations (Windows, Mac Linux), these functions include Power Management, and Network Management.
4.4 Using desktop mode
Chromium is included for web browsing and can be found in the start menu.
In Systems / Package Manager tools - you can install other applications for your specific needs.
5 Other Uses
5.1 KodiBuntu VNC Server
- Install x11vnc
- Set password
- Test connection by running manual start command.
x11vnc -auth guess -forever -loop -noxdamage -repeat -rfbauth /home/USERNAME/.vnc/passwd -rfbport 5900 -shared
Have x11vnc start automatically via upstart in any environment (<=Utopic)
sudo nano /etc/init/x11vnc.conf
# description "Start x11vnc at boot"
start on runlevel 
stop on runlevel [^2345]
respawn limit 20 5
exec /usr/bin/x11vnc -auth guess -forever -loop -noxdamage -repeat -rfbauth /home/USERNAME/.vnc/passwd -rfbport 5900 -shared
6 KodiBuntu FAQ
- See: KodiBuntu FAQ
7 See also