|Read this page and still need help? Check out the Kodi for Linux discussion forum.|
Kodi for Linux is primarily developed for Ubuntu Linux. Third-party packages for most other Linux distributions are however available, and it is also possible to compile Kodi media center software application from scratch for nearly any Linux distribution. Linux supports full hardware decoding with most graphics cards. Linux is generall the best way to get a fast, free, and "appliance" feel for an Kodi powered HTPC.
1 Main topics
Other Linux-specific wiki pages for topics, guides, and advice. For everything else, standard Kodi pages will normally apply.
| HOW-TO:Install Kodi for Linux
|| Linux FAQ|
Frequently Asked Questions for Kodi running under Linux-based operating systems.
| Supported hardware
Kodi needs a 3D capable GPU graphics hardware controller for all rendering. The required 3D GPU chips are common today in most modern computers, and even some set-top boxes. Kodi runs well on what (by Intel ATOM standards) are relatively underpowered OpenGL 1.3 (with GLSL support), OpenGL ES 2.0 or Direct3D (DirectX) 9.0 capable systems that are IA-32/x86, x86-64, or ARM CPU based.
When software decoding of a Full HD 1080p high-definition video is performed by the system CPU, a dual-core 2 GHz or better CPU is required in order to allow for perfectly smooth playback without dropping frames or giving playback a jerky appearance. Kodi can however offload most of the video decoding process onto GPU and VPU hardware that supports one of the following types of hardware-accelerated video decoding: Android StageFright and MediaCodec API, Intel's VAAPI, Nvidia's VDPAU, AMD's XvBA, Microsoft's DXVA, Apple's VDADecoder/VideoToolBox, or OpenMAX. By taking advantage of such hardware-accelerated video decoding, Kodi can run well on many inexpensive and low-power systems which contain a modern GPU and VPU.
| Developing Kodi for Linux|
Team-Kodi (formerly called Team-XBMC) first ported XBMC Media Center software to Linux in 2007, and the whole project cross-platform application was renamed to Kodi in 2014. Kodi itself is a huge open source project and it takes loads of people working together to maintain it for all platforms, that is why Team-Kodi is always on the lookout for C/C++ programmers to volunteer in assisting us with the development of Kodi. Whether you have contributed to the Kodi/XBMC project in the past or not, please consider doing so now.
|| Tips and tricks|
Boost performance, troubleshoot, enhance, and more.
| Helpful applications
|| Device specific info|
| Supplemental tools
|| Random notes|
|CPU|| 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).
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.|
|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.
3 Linux distributions
For install instructions for various Linux distros, see HOW-TO:Install Kodi for Linux.
- Amlogic M3 devices - http://forum.kodi.tv/showthread.php?tid=192034
- Amlogic M1/M3 devices - http://www.pivosforums.com/viewtopic.php?f=25&t=4518
- Amlogic M6/M8 devices - EmbER (Embedded Entertainment ROM)
How to automatically start up in Kodi using various Linux distributions. This page presents an approach to turning a minimal installation of Fedora 22 into a standalone Kodi 15.x installation, with minimal additional software / overhead. The Kodi packages available from RPMFusion are used as the basis for this setup. At the end of this guide you will have a set-top box style of system that, when powered up, will quickly boot and then start Kodi automatically without intervention (e.g. no need to first log in). This page explains procedures and methods to create a USB bootable drive or install Kodi into a USB flash drive. The instructions are written for Kodibuntu, but may work for other installs with ISO images. Network File System, or NFS, is a way to share folders over a network, and was added to XBMC in v11 (Eden). The main benefits of using NFS instead of SMB are its low protocol overhead (which allows it to send data across a network more quickly) and its use of simple UID's to authenticate users rather than username/password combinations. This part bears repeating, as many people are confused on this point and try to create usernames and passwords to get Kodi to work with NFS: NFS does not use usernames or passwords as logins; it uses a UNIX-based "userID" (UID) alone.
5 Device specific info
|These pages are maintained by the community and should not be considered an endorsement or recommendation. Device pages are made when there's a bunch of useful information for a particular device, and someone takes the time to make that page. Keep in mind, some devices simply don't need a page of specific information, but are still excellent devices. *|
The Chromebox is an inexpensive small form-factor PC which runs Google's ChromeOS; it is the desktop variant of a Chromebook laptop. Although Kodi does not run natively under ChromeOS, the Chromebox can easily be made to run Linux (or Windows) and Kodi. CompuLab Utilite multi-purpose ARM-based mini-computer that is capable of running either Kodi on Android or on Linux, both using firmware images provided by CompuLab development team and third-parties of which many comes with Kodi pre-installed. EzeeCube is an expandable smart media centre developed and sold by Ezee Systems Limited. It supports cross platform connectivity between iOS, Android, Mac and Windows devices. It stores photos and media content from up to 6 devices. All content can be accessed from the connected HDTV and any paired devices. EzeeCube comes with a customised version of Kodi pre-installed and pre-configured. Media content can be synced using the EzeeSync app for iOS/Android devices or Mac/Windows.
EzeeCube was crowdfunded via Indiegogo in June 2014, and reached 196% of its target. The campaign included the EzeeCube base unit, add-on storage, and an add-on blu-ray player. EzeeCube started shipping in June 2015.
The Intel NUC is a series of small, awesome, x86 hardware based PCs that works fantastically as an HTPC. Can run a full desktop OS if desired. Reasonable starting price considering size and power. Uses Celeron to Core i5 CPUs. Can run fanless with a replacement heatsink case. MK808B Plus (not to be confused with the very different MK808 or MK808B), is a small inexpensive ARM-based Android "stick" hardware that uses an Amlogic S805 SoC chipset. MK808B Plus is also able to run Kodi on Linux using unofficial third-party firmware images of example OpenELEC.
While the integrated WiFi support in it is pretty sucky, for about $35 USD, the MK808B Plus is a fairly good value as a decent 1080p set-top box device that can decode most popular used video codecs today, including HEVC (H.265).
ODROID-X is a series of powerful ARM-based single-board computers (developer boards), manufactured by Hardkernel Co., Ltd., an open-source hardware company located in South Korea, capable of running Android or Linux. Kodi should work on Hardkernel ODROID-X, X2, U2, U3, XU, XU2, XU3 and XU3 Lite. As an Kodi HTPC, the ODROID-C serie supports Full 1080p (Full HD) video playback of the most commonly used codecs, support for most if not all Kodi add-ons, and offers adequate GUI performance. Pivos XIOS DS is an ARM-based media player set-top box that can run Kodi on either Android or Linux. This Pivos XIOS DS was the original reference hardware target for the XBMC/Kodi for Android port development. Pivos XIOS DS performs roughly at the level as a jailbroken ATV2, but also comes with USB ports, micro-SD card, and doesn't need to be jailbroken. Pivos XIOS XS (or "XIOS XS Media Play") is an ARM-based media player set-top box that can currently run Kodi on Android, and in the future might also be able to run Kodi on Linux using unofficial third-party image firmware, similar to its predecessor Pivos XIOS DS.
This Pivos XIOS XS and its predecessor Pivos XIOS DS doesn't need to be jailbroken and was previously both reference hardware target for Kodi on Android development. While Pivos XIOS DS only had a single CPU core and performed roughly at the level as a jailbroken ATV2, Pivos XIOS XS have a dual-core CPU which can perform about twice as fast as its predecessor. Both also come with comes with USB ports, micro-SD card, Ethernet port, integrated WiFi, and a remote control.
The Raspberry Pi (and Raspberry Pi 2) is an series of ARM powered, credit card sized single-board computers (developer boards) made in the UK by the non-profit Raspberry Pi Foundation organization for educational and hobbyist purposes. These low power computers is mass produced at very low prices and the high number of units sold gives it massive community support. As an Kodi HTPC, all Raspberry Pis supports full 1080p (Full HD) video playback of the most commonly used codecs, support for most if not all Kodi add-ons, and reasonably responsive GUI performance. CuBox-i series (which includes CuBoxTV) is SolidRun's second-generation family of multi-purpose ARM-based mini-computers that is capable of running either Kodi on Android or on Linux, both using firmware images provided by SolidRun development team and third-parties of which many comes with Kodi pre-installed. Hummingboard is SolidRun's ARM-based development board that is capable of running either Kodi on Android or on Linux, both using firmware images provided by SolidRun development team and third-parties of which many comes with Kodi pre-installed.
With its hardware built around the same SolidRun MicroSOM platform as the SolidRun CuBox-i series, it uses scalable and open source friendly Freescale i.MX6 family of SoC (System-on-Chip) ranging from a single to quad ARM Cortex-A9 processor cores, 2D/3D hardware graphics processing unit, video decoding and encoding acceleration hardware, and HDMI 1.4 1080p 3D output support.
UDOO is a series of Freescale i.MX 6 single-board computers integrated with a Arduino 2 compatible microcontroller, primarily designed for the education of computer science, the world of makers and the Internet of Things.
The product was initially launched on Kickstarter at April 2013 reaching wide consensus, with three models of UDOO available: UDOO Dual Basic, UDOO Dual, UDOO Quad, respectively priced at $99, $115, $135 at launch.
Wandboard is an ARM-based development board that is capable of running either Kodi on Android or on Linux, both using firmware images provided by WandboardWandboard development team and third-parties of which many comes with Kodi pre-installed.
Wandboard uses scalable and open source friendly Freescale i.MX6 family of SoC (System-on-Chip) ranging from a single to quad ARM Cortex-A9 processor cores, 2D/3D hardware graphics processing unit, video decoding and encoding acceleration hardware, and HDMI 1.4 1080p 3D output support.
WeTek Play (also sold as an WeTek OpenELEC edition) is an ARM-based media player device that can currently run either Kodi on Android or on Linux, both using official first-party firmware images provided by WeTek and OpenELEC development teams which comes with Kodi pre-installed. WeTek Play is also one of the first Kodi based set-top box devices that have support for integrated ATSC and DVB TV-tuners, which are currently fully functional via plug-and-play under Android and Linux in combination with Tvheadend PVR backend or VDR PVR backend and its matching PVR client addon for Kodi.
6 Random notes
Feel free to place various notes, tips, and links here. As this section of the wiki gets more organized, those notes will be properly sorted. Consider this like a dumping ground for when you're not sure where to put something.
7 See also