Repository navigation
CONTRIBUTING
Languages: English | العربية | Čeština | Deutsch | Español | فارسی | Français | हिन्दी | Bahasa Indonesia | Italiano | 日本語 | 한국어 | Nederlands | Polski | Português | Русский | Svenska | ไทย | Türkçe | Українська | Tiếng Việt | 中文
Thanks for your interest in VD Infos. Contributions are welcome: detection lists, translations, bug reports, documentation and code. Most contributions need no Kotlin.
Most of what the app looks for lives as plain-text lists under
VDInfos/app/src/main/assets/data/, not as code. Adding or removing a target is editing
one line and opening a pull request:
-
*_apps.txt- one package name per line. -
props.txt- the system-property catalog,CATEGORY<tab>key. -
spoof_keys.txt- the settings matrix,key:TYPE. -
known_certs.txt- the signing-certificate catalog,SHA-256<tab>owner(the full hash, taken from a real APK withapksigner verify --print-certs). - other
.txtfiles - one entry per line (kernel-module name fragments, file names, and so on).
A # starts a comment and blank lines are ignored. Some files pack a few space- or
tab-separated fields per line, or optional markers; keep the shape of the lines already
in the file.
- VD Infos reads the truth and never fakes anything. It reports what each method returned, exactly. Do not soften a reading to make it look nicer, and do not add anything that would change a value rather than read it.
- Privacy is absolute. Everything runs on-device. Never add a network call, or anything that sends a reading off the device.
- Exports stay masked. Identity-bearing values are masked in a shared report. Keep it that way.
Translations are a valuable contribution. The readme is translated per language
(README.<lang>.md), the app strings per language, and this documentation under
docs/<lang>/. Keep terminology consistent within a language, match the existing tone,
and never machine-translate a technical term you are unsure of.
Open an issue with your device model, Android version, and, if it is about a reading, a shared export (its identity-bearing values are masked). The export is built for exactly this.
- Build release, never debug. Test on a real device. See Building.
- Keep comments out of the code; names explain intent. The only header is the license banner at the top of each source file.
- Match the existing style and keep changes focused.
By contributing you agree that your contribution is licensed under the project's GNU AGPL-3.0-or-later.
This documentation was generated with Claude (Anthropic) and is maintained by VD171. Corrections and improvements are welcome; see CONTRIBUTING.md.