|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 is officially supported on a number of operating systems and hardware devices that are designed to be connected directly to a TV. Kodi runs well on what are relatively "underpowered" systems, thanks to hardware video decoding being common on nearly all supported platforms. These requirements don't include what might be required for some "advanced" features, such as PVR, which might require additional hardware.
| 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.
| Ubuntu binary add-ons
How to install certain binary add-ons for Ubuntu, such as PVR, audio decoder/encoders, audio DSP, screensavers, and visualizations.
| 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 how-to has flaws: Never Ever start Kodi without a window manager! (FernetMenta: the author of Kodi's X11 windowing system)
The main goal of most of these methods is to start an Xserver only for Kodi. Most of these methods will not work if you have a window manager installed (however, it should not be hard to modify the scripts to suit your needs). The lightdm method might work if you need to use a window manager.
Choose only one method from sections 2 and on based on which distribution and init system you're using.
This page presents an approach to turning a minimal installation of Fedora 25 into a standalone Kodi 17.x (Krypton) installation, with minimal additional software / overhead. The Kodi packages available from RPMFusion are used as the basis for this setup. The guide shows how to install pre-built packages from RPMFusion (which do not support DVD playback), and alternatively shows how to rebuild the RPMFusion packages with DVD-playback capability enabled. 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. How to install certain binary add-ons for Ubuntu, such as PVR, audio decoder/encoders, audio DSP, screensavers, and visualizations.
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 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 was easly on first ported for use on Hardkernel ODROID-X, X2, U2, U3, XU, XU2, XU3 and XU3 Lite. And later Kodi has also been ported to the ODROID-C series, and today ODROID-C/C+ and ODROID-C2 supports Full 1080p (Full HD) video playback of the most commonly used codecs, including support for most if not all Kodi add-ons, as well as offering very good 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, Raspberry Pi 2/3 and Raspberry Pi Zero are a 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 are mass produced at very low prices and the high number of units sold gives it massive community support. As Kodi HTPC, all Raspberry Pis support full 1080p (Full HD) video playback of the most commonly used codecs, most if not all Kodi add-ons, and have 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 Core 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 (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