Skip to content

About

Native Android companion for RootVault with TOTP, encrypted backups, and local-network synchronization

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

RootVault Android

Native Android companion for RootVault, written in Kotlin and Jetpack Compose.

Current version: 0.3.1.

Current version

  • Local account cards with title, site, login, password, notes, custom fields, favorite state, and folder assignment.
  • TOTP generation for SHA-1, SHA-256, and SHA-512 with 6–8 digits and configurable periods.
  • Permission-free QR scanning for standard otpauth://totp enrollment codes.
  • Search and folder filters.
  • Folder creation and removal.
  • Password-protected .rootvaultsync import and export using AES-256 encrypted ZIP entries.
  • Transactional merge or full-replacement restore modes.
  • Desktop-compatible RootVault.accounts JSON import and export.
  • One-step LAN synchronization with RootVault Desktop by scanning its temporary QR code.
  • Stable record IDs, deletion propagation, and desktop-wins conflict handling.
  • App-private SQLite storage without field-level Android Keystore encryption.
  • Screen capture protection via Android FLAG_SECURE.
  • Network access is used only for direct synchronization with the desktop address from the QR code.
  • Android cloud backup is disabled.

Use .rootvaultsync for normal transfers. The JSON export is intentionally plain text for compatibility with desktop RootVault. Treat JSON exports as sensitive and delete or move them into encrypted storage after use.

Versions 0.1.0–0.2.0 used field-level Android Keystore encryption. Version 0.2.1 performs a one-time in-place migration to plain SQLite text and removes the legacy key so list filtering stays fast even for larger vaults.

LAN synchronization

  1. In RootVault Desktop, open Settings → Device Sync and show the synchronization QR code.
  2. On Android, open the menu, choose Sync with computer, and scan the QR code.
  3. Keep both devices on the same local network until synchronization finishes.

The phone IP address does not need to stay fixed. The QR code contains only the desktop's temporary local address and port. The desktop database is the master when both devices changed the same account. Attachments are not synchronized yet.

LAN synchronization is intentionally unauthenticated and unencrypted. Use it only on a trusted local network while the temporary QR screen is open.

Build

The project targets Android API 35 and requires Java 17.

export ANDROID_HOME="$HOME/Android/Sdk"
./gradlew test assembleDebug

The debug APK is written to app/build/outputs/apk/debug/app-debug.apk.

Planned modules

  • Direct desktop .rootvaultbackup archive import.
  • File attachments and protected Secure Notes UI.
  • Scheduled remote backup and restore.
  • Optional biometric unlock and auto-lock timeout.

About

Native Android companion for RootVault with TOTP, encrypted backups, and local-network synchronization

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages