ViPER4Android GitHub Guide: Repositories, Releases and Source Code

Navigate ViPER4Android on GitHub: the app and ViPERFX_RE repositories, where APKs and modules live, what main.zip contains, and how to report issues.

Illustration of concentric rings representing connected GitHub repositories
Illustration created for this guide

ViPER4Android is developed in the open on GitHub. Knowing how the repositories fit together saves time and keeps you away from unofficial copies. This guide is a map.

The repositories that matter

RepositoryWhat it contains
likelikeslike/ViPER4AndroidThe Material 3 Android app, its README, presets documentation and the preset converter tool
likelikeslike/ViPERFX_REThe reverse-engineered DSP driver, built as AIDL and non-AIDL Magisk modules
ViPER4Windows and ViPER4MacSeparate desktop projects linked from the driver README; not covered on this site

What main.zip contains

The download button on our homepage fetches main.zip, GitHub's automatic archive of the app repository's main branch. When we checked it was about 0.3 MB. Inside the ViPER4Android-main folder you will find:

  • README.md with features, installation and Q&A.
  • LICENSE with the full GPL-3.0 text.
  • app/ with the Kotlin source and Android resources, including Russian and Simplified Chinese translations.
  • tools/convert_preset.py for converting old presets.
  • Gradle build files and a Makefile for developers.

The archive is useful for reading documentation offline, converting presets and building the app yourself. It is not an installable APK.

Releases: where installable files live

Prebuilt APKs are attached to entries on the app's Releases page, and driver module ZIPs on the ViPERFX_RE Releases page. Each release has notes that describe changes. Read them before updating, especially when preset formats or module requirements change.

Building the app yourself

The repository is a standard Gradle Android project targeting Java 17 compatibility. Developers with Android Studio can open the extracted folder, let Gradle sync, and build a debug APK. The minimum SDK is 28 (Android 9). If you only want to use the app, the release APK is simpler.

Using the preset converter

# v1 flat JSON to v2.1
python3 tools/convert_preset.py preset.json --to 2.1 -o preset.v2.json
# legacy XML to v2.1
python3 tools/convert_preset.py preset.xml --to 2.1 -o preset.v2.json

The script needs Python 3.11 or newer. It auto-detects the input format and fills missing fields with app defaults.

Reporting problems the right way

  1. Search existing issues first.
  2. Note your phone model, Android version, root manager and which module you flashed.
  3. Capture logs while reproducing the problem. The driver README lists the commands in order.
  4. Attach the logs to a new issue with clear reproduction steps.

App logs can also be viewed inside the app: tap the Driver Version entry in Settings seven times.

Contributing and translations

The README welcomes issues and pull requests. Translators can follow the template in app/res-template. Community translators are credited for Russian and Simplified Chinese.

How to spot unofficial copies

  • Check the owner name in the URL: the app lives under likelikeslike/ViPER4Android.
  • Be wary of forks that only add "mod" or "no root" to the name.
  • Prefer release assets attached to the official repository over re-uploads on file hosts.

See the latest APK version guide and how to install Viper4Android.

Get the ViPER4Android source archive

main.zip from the official GitHub repository, GPL-3.0. The download starts on this page.

Download