| 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
- 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 or VDPAU. For everything but older AMD cards and Nvidia, VAAPI is recommended. On AMD, you might have to start with the environment variable |
KODI_GL_INTERFACE set to
GLX in order to get VDPAU 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.
Note: There´s no 304.xxx driver for Ubuntu 18.04 available anymore from the "Graphic Drivers"-ppa. Users who are using GeForce 6-series cards should either stay on an older Ubuntu version or use newer cards
|| Getting and downloading XBMCbuntu|
- 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.
|| Creating a bootable USB drive from iso|
XBMCbuntu comes in an ISO form that can be burned to an optical disc. It can also be formatted to a USB drive, as mentioned in the next section.
For complete instructions on how to acquire, create a bootable usb flash drive, boot or install to/from see:
2.1 Updating / Upgrading or Changing XBMC version
This page below contain all rounded up FAQ regarding upgrading/updating or changing XBMC packages via the Team XBMC ppas as well as useful information for those just starting out with Linux or XBMCbuntu/Kodibuntu
2.2 Upgrading XBMCBuntu 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.
2.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
<syntaxhighlighter lang=bash enclose="div">
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.
2.4 XBMCbuntu F.A.Q.
This area covers basic Frequently Asked Questions and contains relevant information regarding XBMCbuntu that may be useful to users just starting out with Linux or XBMCbuntu.
Subjects covered by XBMCbuntu F.A.Q. are, but not limited to:
- Upgrading drivers
- Handling backups
To login locally press Ctrl+Alt+F1 - F6 or via over SSH
4 Basic use
XBMCbuntu can boot directly into XBMC or it can also boot into a desktop mode for using applications such as a web browser.
Template: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.
4.1 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.
4.2 Using desktop mode
5 Common Issues