| 25px 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 processor such as: Intel Pentium 4, Intel Pentium M, AMD Athlon XP/64, AMD Opteron, or newer CPU (that support SSE. Anything made in the last few 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 videos (H.264, VC-1, etc) in 1080p.
- There is very limited Power PC (PPC) support: [Linux] How to install on Linux-ppc
- Minimum: 256MB
- Recommended: 1 to 2 GB or more
XBMC will run on most graphics cards made in the last few years, including hardware video decoding support. This includes most cards from ATI/AMD, 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, OpenMAX, or CrystalHD.
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 XBMC binary generally takes up between 100 to 200 MB of space, depending on how it's compiled. Technically speaking, if your hardware supports netbooting, you don't even require a hard drive for either the OS or XBMC.
- Minimum: 4 to 8GB
- Recommended: 16GB or more
- Depending on how big your video library is. Most of the space required for XBMC comes from the images/artwork cache, which can be adjusted: HOW-TO:Reduce XBMC disk space.
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
To update XBMC/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 install xbmc # for 13.2
sudo apt-get install kodi # for 14.0 and up
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.
| Click to show upgrading instructions for the OS -->
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
sudo apt-get do-release-upgrade
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 XBMCbuntu FAQ
- See: XBMCbuntu_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