How protonvpn/android-app works
ProtonVPN for Android is a client for account-backed VPN connections. The core runtime coordinates user/session state, server inventory, connection state, and a WireGuard service; Android Quick Settings can also expose connection controls. The repository tree documents adjacent capabilities including app configuration updates, profiles, excluded locations, bug reporting, managed auto-login, and Google-specific promotional offers. Source excerpts establish several internal calls, but most screens and connection orchestration were not sampled, so their relationships are intentionally not inferred.
Main entry points: WireguardWrapperService.kt WireGuard service · PeriodicUpdateManager.kt Periodic updates · CurrentUser.kt Current user state · AutoLoginManager.kt Managed auto-login
Components 22
VPN connection
- Quick Settings tile
app/src/main/java/com/protonvpn/android/components/QuickTileService.kt - Tile state store
app/src/main/java/com/protonvpn/android/quicktile - WireGuard service
app/src/main/java/com/protonvpn/android/vpn/wireguard/WireguardWrapperService.kt - Connection manager
app/src/main/java/com/protonvpn/android/vpn/VpnConnectionManager.kt - VPN state monitor
app/src/main/java/com/protonvpn/android/vpn/VpnStateMonitor.kt - Server inventory
app/src/main/java/com/protonvpn/android/servers/ServersDataManager.kt - Server store
app/src/main/java/com/protonvpn/android/servers - VPN certificates
app/src/main/java/com/protonvpn/android/vpn/CertificateStorage.kt
Account and access
- Current user state
app/src/main/java/com/protonvpn/android/auth/usecase/CurrentUser.kt - VPN user database
app/src/main/java/com/protonvpn/android/auth/data/VpnUserDatabase.kt - Managed auto-login
app/src/main/java/com/protonvpn/android/managed/AutoLoginManager.kt - Account screens
app/src/main/java/com/protonvpn/android/auth/ui
App data and updates
- VPN API client
app/src/main/java/com/protonvpn/android/api/VpnApiClient.kt - App configuration
app/src/main/java/com/protonvpn/android/appconfig/AppConfig.kt - Periodic updates
app/src/main/java/com/protonvpn/android/appconfig/periodicupdates/PeriodicUpdateManager.kt - Update schedule store
app/src/main/java/com/protonvpn/android/appconfig/periodicupdates/PeriodicUpdatesDao.kt - Local data store
app/src/main/java/com/protonvpn/android/userstorage
Client features
- Connection profiles
app/src/main/java/com/protonvpn/android/userstorage/ProfileManager.kt - Excluded locations
app/src/main/java/com/protonvpn/android/excludedlocations/usecases/ObserveExcludedLocations.kt - Bug reporting
app/src/main/java/com/protonvpn/android/bugreport/PrepareAndPostBugReport.kt - Promotional offers
app/src/google/java/com/protonvpn/android/promooffers/usecase/GetEligibleOffers.kt
Other components
- VPN user
Connections 14
- VPN user → Quick Settings tile: controls
- Quick Settings tile → Tile state store: observes state
app/src/main/java/com/protonvpn/android/components/QuickTileService.kt - WireGuard service → Connection manager: notifies lifecycle
app/src/main/java/com/protonvpn/android/vpn/wireguard/WireguardWrapperService.kt - WireGuard service → VPN state monitor: checks state
app/src/main/java/com/protonvpn/android/vpn/wireguard/WireguardWrapperService.kt - WireGuard service → Current user state: reads account
app/src/main/java/com/protonvpn/android/vpn/wireguard/WireguardWrapperService.kt - Server inventory → Server store: uses store
app/src/main/java/com/protonvpn/android/servers/ServersDataManager.kt - VPN user → Account screens: signs in
- Current user state → VPN user database: loads user data
app/src/main/java/com/protonvpn/android/auth/usecase/CurrentUser.kt - Managed auto-login → Current user state: checks account
app/src/main/java/com/protonvpn/android/managed/AutoLoginManager.kt - Managed auto-login → Account screens: resets UI
app/src/main/java/com/protonvpn/android/managed/AutoLoginManager.kt - Periodic updates → Update schedule store: tracks updates
app/src/main/java/com/protonvpn/android/appconfig/periodicupdates/PeriodicUpdateManager.kt - Periodic updates → App configuration: refreshes config
- Periodic updates → VPN API client: calls API
- VPN certificates → Local data store: persists certificates
app/src/main/java/com/protonvpn/android/vpn/CertificateStorage.kt