| 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.
XBMCbuntu is a combination XBMC/operating system for use on PCs that are mainly just running XBMC. It is an alternative to installing Windows or a larger (and sometimes more complicated) Linux-based OS.
1 Hardware requirements
XBMCbuntu should work with the general hardware requirements for Linux:
| Click to show hardware requirements -->
|| 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 XBMC/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.
XBMCbuntu comes in an ISO form that can be written to a USB drive or burned to an optical disc.
Download the current stable KodiBuntu/XBMCbuntu image from:
- Unlike XBMCbuntu v12, v13 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.
3 Upgrading Kodi Media Center
3.1 Upgrading the OS
Current XBMCbuntu is based on a LTS release (long term release) which is supported for 5 years, this means that you wont require to upgrade the OS base in order to obtain updated or upgrade application packages.
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.
However should you need to upgrade the OS base a quick how-to follows.
3.2 How do I upgrade the XBMCbuntu base OS?
To actually upgrade the underlying Linux which "XBMCbuntu" 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 XBMC itself by treating it as a normal Linux package and update/install via: Upgrading XBMC via ppa in XBMCbuntu
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 KodiBuntu FAQ
- See: KodiBuntu FAQ
5 Basic use
5.1 Desktop mode
XBMCbuntu can boot directly into XBMC or it can also boot into a desktop mode for using applications such as a web browser.
In order to enter desktop mode, exit XBMC and on the login screen use the top-right pulldown menu and select the proper session, which will be XBMCbuntu.
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 XBMC, logout again and select XBMC as session in the top-right pulldown menu.
To login to the command line interface press Ctrl+Alt+F1 - F6 or connect over SSH with the following login information:
5.3 Media center
XBMCbuntu contains XBMC for Linux compiled with the 'standalone' mode, this enabled certain functions that are not available in normal XBMC installations (Windows, Mac Linux), these functions include Power Management, and Network Management.
5.4 Using desktop mode
6 See also