- 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
Installing applications on Android is quite easy compared to many other platforms, although it is somewhat different from other platforms. On this page we list the steps needed for basic installation an uninstallation.
| 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 Android devices. And 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.
The fact is, while some devices might be able to smoothly decode standard-definition videos and even some 720p or higher resolution videos using only software video decoding with raw CPU compute power, offloading a large part of video decoding tasks to an integrated VPU (Video Processor Unit) that is optimized specifically for this job is considered essential for most Android devices to be able to smoothly playback high definition videos.
| 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 XBMC v13 "Gotham".
| 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!
- Due to the fractured nature of the Android operating system ecosystem and diversified hardware devices with poor usage of standard APIs by manufacturers, it makes it very hard to give exact minimum requirements, so instead the basic set of requirements includes:
- Android 4.4 operating-system or later is recommended, though Android 4.0 or later is supported by Kodi 14 (Helix), however the newer Kodi 15 (Isengard) and later will require at least Android 4.2 or later version of the operating-system.
- x86 (Intel) or NEON compatible ARM processor, (for example: Nvidia Tegra 3 and newer are fully supported by Kodi, while Tegra 2 and older Tegra probably will never be supported because its processor lacks NEON instruction set compatibility).
- Hardware decoding support in Kodi is likely a must for high definition video playback (720p or higher resolution). Do not expect Kodi to work properly on any device until someone knowledgeable have specifically already tested it and can confirm working hardware decoding support for that device. For more details on hardware video decoding support, see Android hardware.
- 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). However expect the initial tablet/phone/touch/mobile/etc support to eventually improve with time.
Assorted how-to's related to the video library that have been added to the wiki:
Ouya has a bit different setup than normal Android devices with XBMC for adding local media, but is roughly the same. 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. Installing applications on Android is quite easy compared to many other platforms, although it is somewhat different from other platforms. On this page we list the steps needed for basic installation an uninstallation. 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. OUYA uses Kodi for Android. The current version is Kodi v14.2 Helix. To use an external player on XBMC 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 most Android hardware as some (most?) ARM processors are not powerful enough to software decode it, and no hardware decoders exist for it. As faster ARM CPUs come out this will get better, but don't expect miracles from the average Android box.
- 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 XBMC disk space 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.
|Link2SD||Good for moving the userdata to the external SD card, in case you are getting low on internal memory.||Yes||link|
|full!screen||If you are using Kodi on a Android 4.3 or lower, you can use full!screen to hide the "nav buttons", allowing for full screen playback of videos. (Note: Kodion Android 4.4 should support immersive mode, allowing this switch to full screen to happen automatically)||Yes||link|
|Multilanguage Keymap Redefiner||Remap keys on the Android level without having to use Kodi keymaps||?||link|
|Startup Manager (Free)||Allows delectable software to open at startup.||?||link|
|CatLog||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.||Yes||link|
|Ted (Text Editor)||Free and open source text editor that is useful for editing various files, such as keymaps and advancedsettings.xml||No||link|
|XBMC Launcher||Set Kodi (and various forks) as a Launcher without having to mod the APK||?||link|
|XBMC Updater||Easily update or install Kodi without having to manually sideload||No||link|
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.
Do not use this page as a guide for what to buy to run Kodi. Disclaimer
Amazon Fire TV is an Android-based (Fire OS) set-top-box that contains a very powerful ARM processor (that can even handle some of the more heavy Kodi skins). Fire TV 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, making it a good pairing with Kodi. Amazon Fire TV Stick is a newly announced low cost Android-based (Fire OS) set-top box in a HDMI-stick format. Amazon Fire TV Stick contains a little less powerful ARM processor but technically provides all the same features as its big brother, Amazon Fire TV. 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.
CompuLab Utilite hardware is built around the scalable and open source friendly Freescale i.MX6 family of SoC (System-on-Chip) with ARM Cortex-A9 processors, 2D/3D hardware graphics processing unit, video decoding and encoding acceleration hardware, and HDMI 1.4 1080p 3D output support.
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 not great, 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 Console is an upcoming next-generation Android-based set-top box and game console that will contains a very powerful ARM processor, (and should be able to handle the most heavy of Kodi skins). It will be one of the first Android-based which features high-fidelity audio support, HDMI 2.0 output, and is built to handle Ultra HD digital media playback and output in 4K resolution at 60 Hz, including 60 frames per second decoding of the more recent HEVC (H.265) and VP9 video codecs.
Running the Android TV operating system (based on Android 5.0 "Lollipop") on a Tegra X1 SoC (System on Chip), the Nvidia SHIELD Console will stand above most of the other high-end Android-based hardware offerings not only because of its graphics and audio capabilities, but also because due to Nvidia's strong product support. It will come with remote friendly versions of Netflix, Hulu, Google Play Movies, YouTube and other video service clients, with many supporting videos in 4K (Ultra HD) resolution.
Adding to that its comes with Nvidia's gaming ecosystem capable of running all graphically intensive AAA ("triple A") games for Android in 1080p at 60fps, as well as supporting Nvidia's low-latency GameStream technologies for GeForce-equipped PC game streaming, and Nvidia's GRID cloud game-streaming service.. All this making it a very good pairing with Kodi.
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.
The ODROID-X series was primary designed to act as a development platform for developers wanting to prototype embedded systems based on Samsung Exynos 3, 4, and 5 series of System-on-Chips (SoC), but have since also been made popular for multi-purpose use by low-power device enthusiasts and hobbyist alike, including those using it for as HTPC (Home Theater PC) 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 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.
Razor 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 Play 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 development team 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 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. Computers and appliance devices with an x86 processor (a "desktop class"/"normal" Intel or AMD x86/x86-64 based CPU) are the usually the most stable option for an Kodi powered HTPC (Home Theater PC) / media center computer.
Using standard x86 computer hardware provides a great amount of flexibility and can be made from spare parts, old laptop/desktop computers, or new dedicated hardware, and as such are also by definition upgradable.
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