MythTV on Android

From MythTV Official Wiki
Revision as of 00:58, 11 April 2015 by Markspieth (talk | contribs) (Program Guide Gestures)

Jump to: navigation, search

MythTV runs on Android but an official apk is not distributed, here is how to build an android package for yourself.

It uses Linux as the build platform, and opengl as the display layer.

Background & Caveats

Currently it is not very well tested

What works?

Only the frontend works.


  • Tt works the same way it does on Linux.
  • The same themes (or new ones) or any downloadable ones work.
  • Live TV works with program guide to change channels.
  • Playback gesture key mapping is reconfigurable with phpmyadmin.
    • Guide gesture mapping is (currently) Fixed and Click does not work.
  • Only OpenGL Mode for rendering and playback.
    • You cant return from setup screens in OpenGL mode, but it works in Qt rendering mode.

What doesn't work?

  • No backend (currently)
  • Builds are device specific.
  • playback is a bit hiccuppy.
  • not all screens have even rudimentary gesture support.

Unofficial Android Pre-Builds

Some master only builds exist on with various dates.

Gesture Support

Limited gesture support has been added to various widgets so that button lists, playback and program guide are navigable.

Playback Gestures

The playback gestures are reconfigurable in the DB settings. There is a unique map for LiveTV and for recording playback.

LiveTV Map

  • Settings Name : LiveTVScreenPressKeyMap
    • Default: "P,Up,Z,S,Left,Return,Return,Right,A,Down,Q,F"

These are mapped onto a 4x3 grid as follows:

P Up Z S
Left Return Return Right
A Down Q F

To change channels, access the guide (S), find the channel you want and then swipe RightThenLeft or use the menu key.

Recorded Playback Map

  • Settings Name : PlaybackScreenPressKeyMap
    • Default: "P,Up,Z,],Left,Return,Return,Right,A,Down,Q,["

These are mapped onto a 4x3 grid as follows:

P Up Z ]
Left Return Return Right
A Down Q [

Button List Gestures

  • Left : Left
  • Right : Right
  • Up : PgUp
  • Down : PgDn
  • UpLeft : Up
  • UpRight : Up
  • DownLeft : Dn
  • DownRight : Dn
  • Press button once to focus, then again to click

Program Guide Gestures

  • Left : Left
  • Right : Right
  • Up : Up
  • Down : Dn
  • UpThenLeft : PageLeft or PgUp
  • DownThenRight : PageRight or PgDn
  • UpThenRight : PgUp
  • LeftThenUp : PgUp or PageLeft
  • RightThenDown : PgDn or PageRight
  • LeftThenDown : Day Left
  • RightThenUp : Day Right
  • RightThenLeft to change channel on highlighted channel


Existing these work fine and the click sensitivity make it quite usable.

Currently there does not exist any special themes for touch screen usage.

Build Procedure

To build MythTV for android, use the following steps.

There is currently no automated way to get all dependencies and build an apk in one step

1. Clone the repos from the android fork

mkdir workdir
cd workdir
git clone
cd packaging/android
git clone

2. Get Android sdk, ndk and Qt using the online installer

  • I used Qt 5.4.1
  • You need the sdk version you are compiling to. I used 17 for 4.2.2 as minimum compatability level. File will be something like
  • install in ~/android as the build scripts assume its there
  • also get android-ndk-r10d-linux-x86_64.bin and install it in ~/android too.
  • also get and install that too in ~/android
  • if you want to build a release apk, you need to create a key.
  • modify and copy android-utilities/* to ~/android
    cp android-utilities/ ~/android
  • create a toolchain for the correct version. see for this. sdk 17 is the default

You should have a dir structure like this after you are done:

       android-ndk -> android-ndk-r10d

3. Get a sufficiently suitable version of java. I used oracle-java7-jdk_7u76_amd64.deb

  • Install it and make it the active one. Note that you can't use java8.

4. Get the following tarballs and put then in ./libs and extract (tar xf) them in this directory

  1. exiv2-0.24.tar.gz
  2. freetype-2.5.5.tar.bz2
  3. lame-3.99.5.tar.gz
  4. libiconv-1.14.tar.gz
  5. mariadb-connector-c-2.1.0-src.tar.gz
  6. openssl-1.0.2.tar.gz
  7. taglib-1.9.1.tar.gz
  8. qt-everywhere-opensource-src-5.4.1.tar.xz
  • This process will be made automatic in time using the windows mythbuild.

5. build all the libraries


6. build it (debug by default)