Jump to: navigation, search
Home icon grey.png   TriangleArrow-Right.svg Devices TriangleArrow-Right.svg Android
Looking for information on the XBMC remote control app for Android? See Official XBMC Remote/Android.
Attention talk.png Read this page and still need help? Check out the XBMC for Android support forum.

XBMC for Android is a full port of the complete XBMC application to Google's Android operating-system. With the Android NDK (Native Development Kit for Android) XBMC runs natively under Android as a Native Activity application. The initial aim for the Android port is to get XBMC working on inexpensive Android set-top-boxes. Phones and tablets will be supported as well for those who want XBMC on-the-go.


1 Main topics

Other Android-specific wiki pages for topics, guides, and advice. For everything else, standard XBMC pages will normally apply.

Gnome-emblem-downloads.svg HOW-TO:Install XBMC 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.
FAQ icon.png Android FAQ
Frequently Asked Questions for Android.
Nuvola apps ksim.png Android hardware
This is a list of Android SoC's (System on a Chip, which is the CPU, GPU, VPU, etc. Also known as "chipsets".) that will playback common video codecs smoothly using XBMC. For most HD videos, hardware video decoding is necessary for smooth video playback. While some devices might be able to do SD and even some 720 content using software video decoding, hardware video decoding is considered essential for most Android devices.
Applications-development.svg Developing XBMC for Android
Team-XBMC ported XBMC Media Center software to Android in 2012. XBMC is a huge open source project and it takes loads of people working together to maintain it for all platforms, that is why Team-XBMC is always on the lookout for C/C++ programmers to volunteer in assisting us with the development of XBMC. Whether you have contributed to the XBMC project in the past or not, please consider doing so now.
Circle arrow right font awesome.svg How-to's
Gnome-colors-fusion-icon.svg Tips and tricks
Boost performance, troubleshoot, enhance, and more.
Circle arrow right font awesome.svg Helpful applications
Circle arrow right font awesome.svg Device specific info
Circle arrow right font awesome.svg Random notes

2 Requirements

Attention.png NOTICE:
It is highly recommended for users to not make any purchases in anticipation of running XBMC on Android without researching the device you want to buy. If you do buy, make sure multiple people can verify that it works! If in doubt, don't buy that box!
  • Due to the nature of Android hardware it is hard to give exact requirements. The basic set of requirements include:
    • NEON compatible ARM processor (for example: Nvidia Tegra 1/2 probably will never be supported, while Tegra 3 and later will be fully supported.)
    • Android 4.0 or later is supported, but Android 4.4 and later is recommended.
    • Hardware decoding support in XBMC is likely a must for HD video playback (720p+). Don't expect this to work on any device until someone has specifically tested it and can confirm hardware decoding support for that device. For more details on hardware video decoding support, see Android hardware.
  • The main aim for the Android port is to initially target media-players/set-top-boxes/sticks that connect to a large screen television and uses a standard remote control as interface device, (that is the same market at HTPC). However expect tablet/phone/touch/mobile/etc support to eventually improve with time.

3 How-to's

Assorted how-to's related to the video library that have been added to the wiki:

HOW-TO:Add local media sources on OUYA
Ouya has a bit different setup than normal Android devices with XBMC for adding local media, but is roughly the same.
HOW-TO:Install XBMC 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.
OUYA uses XBMC for Android. The future XBMC version, v13 "Gotham", should be fully compatible with the OUYA.
HOW-TO:Use external players on Android
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

  • Note: Remember that hardware video decoding, which will be required on most devices for smooth video playback, requires a nightly build.
  • Avoid using wireless. A lot of Android devices 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, XBMC -> Settings -> Video -> File and deselect 'generate thumbnails'.
  • H.264 videos encoded with Hi10P profile will not work on most Android hardware as there are no ARM processors powerful enough to software decode it, and no hardware decoders exist for it.
  • 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 XBMC handles images.
  • Passthrough audio hacks for Rockchip based devices:

4.1 Helpful applications

Some helpful XBMC related Android applications, as suggested by the community. This list should not be seen as any kind of official endorsement by XBMC.

Name Description Requires
Link2SD Good for moving XBMC userdata to the external SD card, in case you are getting low on internal memory. Yes link
full!screen If you are using XBMC on a Android 4.3 or lower, you can use full!screen to hide the "nav buttons", allowing for full screen playback of videos. Future Gotham feature: (Note: XBMC on Android 4.4 should support immersive mode, allowing this switch to full screen to happen automatically) Yes link
AnTuTu CPU Master (Free) Allows for disabling CPU power saving features for some Android devices, which could speed up the device. ? link
Rescan Media ROOT Some Android firmware have a media scanner enabled, which can slow things down on some devices. This application will allow you to disable/enable the media scanner. Yes link
Startup Manager (Free) Allows XBMC to open at startup. ? link
SendLog Useful for sending system logs to XBMC 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 XBMC files, such as keymaps and advancedsettings.xml No link
XBMC Updater Easily update or install XBMC 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.

Amazon Fire TV
The 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 XBMC 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 XBMC.
The CuBox is a very small, fan-less nettop-class computer manufactured by the Israeli company SolidRun Ltd. It is cube-shaped at only approximately 2 × 2 × 2 inches and weighs 91 grams (0.2 lb, or 3.2 oz). CuBox is the first commercially available desktop computer based on the Marvell Technology Group's Armada 500-series SoC (System-on-Chip), and said to currently be the worlds smallest complete desktop computer.
OUYA is an Android-based game console/set-top-box that contains a very powerful ARM processor that can even handle some of the more heavy XBMC skins, in addition to outputting video at 1080. XBMC currently requires a test build to enable hardware video decoding on the OUYA, and the first official and full version of XBMC on OUYA will be v13 "Gotham". An unofficial, but stable, v12-based version is available from OUYA to hold users over until v13 is released.
Pivos XIOS
The Pivos XIOS is an ARM set-top-box that can run XBMC on either Android or Linux. The Pivos XIOS is the original development target for the XBMC for Android port. The XIOS 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.

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.

Personal tools

Google Search
Wiki help