Skip to content
OpenMW for Android
Kotlin Java C Perl Python Shell CMake
Branch: master
Clone or download
Latest commit a19c712 Oct 6, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
app Bump version code Oct 6, 2019
buildscripts Update openmw Oct 6, 2019
gradle/wrapper Update gradle Sep 16, 2019
.gitignore Add a Nightly build flavor with a custom icon May 11, 2019
LICENSE.txt Add LICENSE Apr 29, 2019 android-port => openmw-android Aug 18, 2019
build.gradle Update gradle Sep 16, 2019 Migrate to androidx Apr 28, 2019
gradlew Migration project from eclipse to android studio May 2, 2015
gradlew.bat Migration project from eclipse to android studio May 2, 2015
settings.gradle Migration project from eclipse to android studio May 2, 2015

OpenMW for Android

Google Play | Google Play (Nightly)

F-Droid | F-Droid (Nightly)

FAQ & Info


There are two steps for building OpenMW for Android. The first step is building C/C++ libraries. The second step is building the Java launcher.


You will need some standard tools installed that you probably already have (bash, gcc, g++, sha256sum, unzip).

CMake 3.6.0 or newer is required, you can download the latest version here (and place in your PATH) if your distro ships with an outdated version.

Additionally, to build the launcher you will need Android SDK installed, it is suggested that you use Android Studio which can set it up for you (see step 2).

Step 1: Build the libraries

Go into the buildscripts directory and run ./ The script will automatically download the Android native toolchain and all dependencies, and will compile and install them.

Step 2: Build the Java launcher

To get an APK file you can install, open the openmw-android directory in Android Studio and run the project.

Alternatively, if you do not have Android Studio installed or would rather not use it, run ./gradlew assembleDebug from the root directory of this repository. The resulting APK, located at ./app/build/outputs/apk/debug/app-debug.apk, can be transferred to the device and installed.

Notes for developers

Debugging native code

You can debug native code with ndk-gdb. To use it, once you've built both libraries and the apk and installed the apk, run the application and let it stay on the main menu. Then cd to app/src/main and run ./ [arch]. The arch variable has to match the library your device will be using (one of arm, arm64, x86_64, x86; arm is the default).

This also automatically enables gdb to use unstripped libraries, so you get proper symbols, source code references, etc.

Running Address Sanitizer

To compile everything with ASAN:

# Clean previous build
# Build with ASAN enabled & debug symbols
./ --ccache --asan --debug
# Or: ./ --ccache --asan --debug --arch arm64

Then open Android Studio and compile and install the project.

To get symbolized output:

adb logcat | ./tool/ --demangle -s ./symbols/armeabi-v7a/
# Or: adb logcat | ./tool/ --demangle -s ./symbols/arm64-v8a/


Source code

Original Java code written by sandstranger. Build scripts originally written by sandstranger and bwhaines.

You can’t perform that action at this time.