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
| Repository | What it contains |
|---|---|
| likelikeslike/ViPER4Android | The Material 3 Android app, its README, presets documentation and the preset converter tool |
| likelikeslike/ViPERFX_RE | The reverse-engineered DSP driver, built as AIDL and non-AIDL Magisk modules |
| ViPER4Windows and ViPER4Mac | Separate 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.mdwith features, installation and Q&A.LICENSEwith the full GPL-3.0 text.app/with the Kotlin source and Android resources, including Russian and Simplified Chinese translations.tools/convert_preset.pyfor 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
- Search existing issues first.
- Note your phone model, Android version, root manager and which module you flashed.
- Capture logs while reproducing the problem. The driver README lists the commands in order.
- 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.
Related reading
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.