PSA: Our Wiki software is being updated to the latest version to fix the ReCaptcha issue. We request that no edits be made until this banner is removed. The wiki is still available for research purposes. Thankyou.
- Looking for information on the Kodi remote control app for Android? See Kore -The official Kodi Remote for Android.
|Read this page and still need help? Check out the Kodi for Android support forum.|
Kodi for Android is a full port of the complete Kodi application to Google's Android operating-system. With the Android NDK (Native Development Kit for Android) Kodi runs natively under Android as a Native Activity application. The main goal for the Android port is to have Kodi working on inexpensive Android set-top-boxes. And whole Android smartphones and tablets are not the main target platforms they do have limited support as well.
1 Main topics
Other Android-specific wiki pages for topics, guides, and advice. For everything else standard Kodi pages will normally apply.
| HOW-TO:Install Kodi for Android
This page describes how to install Kodi, either from an app "store" such as Google Play, or manually from an APK file.
| Android FAQ|
Frequently Asked Questions for Android.
| Android hardware
For most high-definition videos (1080p or higher resolution), hardware video decoding is necessary for smooth video playback on most Android devices. Therefor this article contains a list of SoC chipset hardware, (SoC stands for "System on a Chip" which contain the CPU plus GPU and VPU circuits combination, and is also known as a "chipset"), as on Android platforms this SoC chipset is what can playback common video codecs smoothly using Kodi/XBMC.
| Developing Kodi for Android|
Team-Kodi (formerly called Team-XBMC) first ported XBMC Media Center software to Android in 2012, 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|
| Touch controls
Touch screen devices, such as those for Android and iOS, have a number of default functions and can also be modified using a touchscreen.xml keymap. The ability to change these controls with a keymap file was added in v13.
| Supplemental tools|
| Random notes|
|It is highly recommended for users to not make any purchases in anticipation of running Kodi on Android without first researching the device you want to buy. Before you do buy, make sure multiple people have verified that it works! If in doubt, do not buy that hardware!|
- Kodi v17 requires Android 5.0 or higher.
- x86 (Intel) or NEON compatible ARM processor, (for example: Nvidia Tegra 3 and newer are fully supported by Kodi, while Tegra 2 and older are not).
- The main aim for the Android port of Kodi is to foremost target media-players/set-top-boxes/sticks that connect to a large screen television and uses a standard remote control as its main interface device, (that is the same market as for HTPC).
Assorted how-tos related to the video library that have been added to the wiki:
As of v14, Kodi supports a backdoor to specify the location of your settings folder, which includes the userdata folder and add-ons. It is the equivalent of using environment variables on other platforms This is a guide to installing CyanogenMod 11 to the OUYA, which effectively updates the OUYA to Android 4.4 (Kitkat). This is required for running Kodi v15 and later on the OUYA, as the normal OUYA OS, which is based on Android, no longer meets the minimal install requirements. Kodi v14.2 and earlier versions of XBMC will continue to work on the original OUYA OS. This page describes how to install Kodi, either from an app "store" such as Google Play, or manually from an APK file. This page describes some of the methods to install Kodi onto an Amazon Fire TV (box) or Fire TV Stick. The Fire TV uses Kodi for android and does not require root. All Fire TV products allow sideloading, so no hacking or modification is required to install Kodi. Android apps can be launched from within Kodi by going to custom home items.. It is even possible to launch Android apps from shortcuts on the main menu for skins that supports To use an external player on Kodi for Android you simply need to make a playercorefactory.xml file in the userdata folder.
4 Tips and tricks
- Avoid using wireless. A lot of Android boxes and "sticks" have weak wifi, even those that advertise as being wireless-n. It may be possible to use a USB-to-ethernet dongle on some devices, or even a USB wifi adapter that has a better wifi radio than what is built-in.
- Switch to a different network protocol to see if that has any effect, i.e. SMB/CIFS, NFS, FTP, WebDAV, etc.
- Try sharing the media on another device to rule out a device-specific (or network) issue.
- Turn off thumbnails, Kodi -> Settings -> Video -> File and deselect 'generate thumbnails'.
- H.264 videos encoded with Hi10P profile will not work on some Android hardware as some ARM processors are not powerful enough to software decode it, and no hardware decoders exist for it. However, some newer/faster processors are able to playback Hi10P video using software decoding.
- If RSS feed is enabled, disable it in settings. This can make the main menu a bit faster.
- Running out of disk space storage, or want to try tweaking caching and other performance settings to achieve faster response times? See HOW-TO:Reduce disk space usage for help on modifying how Kodi handles images.
4.1 Helpful applications
Some helpful Kodi related Android applications, as suggested by the community. This list should not be seen as any kind of official endorsement by Kodi.
- A free app that reports your device's system info, including CPU type, codec support, and more.
- Another auto launcher
CatLog (requires root)
- Useful for sending system logs to developers when trying to troubleshoot issues. If someone asks you for a "Log Cat" or a "crash log", this application will get that log.
FireStarter (Fire TV/stick only)
- Fire TV replacement launcher that can also launch Kodi by default. Also includes options to both install and update official Kodi versions.
- Easily update or install Kodi without having to manually sideload.
Media Codec Info
- A tool to display what video codecs are enabled for your device. In theory, anything that your device has enabled for media codec should then work in Kodi.
Multilanguage Keymap Redefiner
- Remap keys on the Android level without having to use Kodi keymaps
- Automatic bluetooth audio routing. Useful for switching between bluetooth headphones and TV audio automatically.
Startup Manager (Free)
- Allows an app, such as Kodi, to be launched when the Android device starts up.
Ted (Text Editor) XBMC Launcher
- Set Kodi (and various forks) as a Launcher without having to mod the APK
5 Device specific info
Here are a few device-specific guides/help areas that the community has provided.
|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. *|
Amazon Fire TV (first and second-generations) is a series of Android-based (Fire OS) set-top-box that contains a powerful ARM processor (that can even handle some of the more heavy Kodi skins). First released in 2014, Amazon's Fire TV series stands above some of the other Android-based offerings due to Amazon's strong product support and because it contains more remote friendly versions of Netflix, Amazon Prime Video, and other video service clients, which generally makes it a good pairing with 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. Nexus Player is an x86-64 (64-bit Intel Atom CPU) based Android digital media player co-developed by Google and Asus. Running the Android 5.0 "Lollipop" operating system, this Nexus Player was the first device to employ Google's Android TV platform. 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).
NVIDIA SHIELD TV (originally known as SHIELD Console) is an Android-based set-top box and game console that contains a very powerful ARM processor, (that is able to handle the most heavy of Kodi skins and more). It is one of the first Android based devices featuring high-end media playback capabilities such as of and support high-definition audio at up to 192 kHz, 23.976 Hz support with automatic refresh rate switching, 10-bit HEVC (H.265), and VP9 video codecs, and 4K UltraHD (2160p) resolution with HDR via HDMI 2.0b output support for Kodi. OUYA is an Android-based game console and set-top-box that contains a Nvidia Tegra based ARM-processor that can handle most Kodi skins, in addition to outputting video in Full HD (1080p). 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.
Razer Forge TV is an ARM-processor based Android digital media player running the Android 5.0 "Lollipop" operating system using Google's Android TV platform. 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. Xiaomi Mi Box from Xiaomi here specifically refers to the 2016 released Xiaomi Mi Box with Android TV 6.0 or later and a bluetooth voice remote included. This box is in some places also sold as "Xiaomi Mi Box 3". This is an affordable 4K UltraHD (2160p) resolution capable Android TV box based on Amlogic S905X SoC that as of yet, as an Android TV box, Xiaomi have given the impression that the firmware for this box is better maintained and supported than most other Android TV boxes out there.
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.
- Make "dummy" Kodi add-ons for launching Android apps. Kodi can do this without the dummy-add-on, but some skins might require it for home screen placement: https://github.com/elmerohueso/nnxbmcnetflix