How getlantern/lantern works
Lantern is a cross-platform censorship-circumvention client. The main workflow is a user request through a platform client, into its VPN/tunnel implementation and the shared Go functionality that supports tunneling and related services. The tree also shows app selection, private-server, logging, update-relay, and iOS widget capabilities. Source evidence is uneven: several platform components and Go modules are indexed but not excerpted, so their unverified connections are omitted or shown as dashed.
Main entry points: core.go Lantern core · MainActivity.kt Android activity · LanternVpnService.kt Android VPN service · mobile.go Go mobile API
Components 25
Client and controls
- Android activity
android/app/src/main/kotlin/org/getlantern/lantern/MainActivity.kt - Android methods
android/app/src/main/kotlin/org/getlantern/lantern/handler/MethodHandler.kt - Android events
android/app/src/main/kotlin/org/getlantern/lantern/handler/EventHandler.kt - VPN status
android/app/src/main/kotlin/org/getlantern/lantern/utils/VpnStatusManager.kt - Quick settings tile
android/app/src/main/kotlin/org/getlantern/lantern/service/QuickTileService.kt - Widget tunnel control
ios/LanternWidget/WidgetTunnelController.swift - Widget state
ios/Shared/VPNWidgetState.swift - macOS methods
macos/Runner/Handlers/MethodHandler.swift
VPN and tunnels
- Android VPN service
android/app/src/main/kotlin/org/getlantern/lantern/service/LanternVpnService.kt - Platform interface
android/app/src/main/kotlin/org/getlantern/lantern/service/PlatformInterfaceWrapper.kt - VPN tunnel
lantern-core/vpn_tunnel/vpn_tunnel.go - iOS VPN manager
ios/Runner/VPN/VPNManager.swift - VPN profile
ios/Runner/VPN/Profile.swift - Packet tunnel provider
ios/Tunnel/PacketTunnelProvider.swift - System extension manager
macos/Runner/VPN/SystemExtensionManager.swift - macOS VPN manager
macos/Runner/VPN/VPNManager.swift - Packet tunnel provider
macos/PacketTunnel/PacketTunnelProvider.swift
Shared Go services
- Go mobile API
lantern-core/mobile/mobile.go - Lantern core
lantern-core/core.go
Platform features
- App filtering
android/app/src/main/kotlin/org/getlantern/lantern/apps/AppFilters.kt - App discovery
lantern-core/apps/apps.go - Private servers
lantern-core/private-server/server.go - Update relay
lantern-core/updaterelay/relay.go - Log stream
lantern-core/logs/stream.go
Other components
- User
Connections 23
- User → Android activity: requests connection
- Android activity → Android VPN service: starts service
android/app/src/main/kotlin/org/getlantern/lantern/MainActivity.kt - Android activity → Android methods: registers handler
android/app/src/main/kotlin/org/getlantern/lantern/MainActivity.kt - Android methods → Go mobile API: calls API
android/app/src/main/kotlin/org/getlantern/lantern/handler/MethodHandler.kt - Android VPN service → Go mobile API: starts VPN
android/app/src/main/kotlin/org/getlantern/lantern/service/LanternVpnService.kt - Android VPN service → Platform interface: uses platform interface
android/app/src/main/kotlin/org/getlantern/lantern/service/LanternVpnService.kt - Android VPN service → VPN status: posts status
android/app/src/main/kotlin/org/getlantern/lantern/service/LanternVpnService.kt - Android activity → VPN status: updates status
android/app/src/main/kotlin/org/getlantern/lantern/MainActivity.kt - Quick settings tile → Android VPN service: starts or stops
android/app/src/main/kotlin/org/getlantern/lantern/service/QuickTileService.kt - Android methods → App filtering: uses filters
android/app/src/main/kotlin/org/getlantern/lantern/handler/MethodHandler.kt - Lantern core → VPN tunnel: uses tunnel
lantern-core/core.go - Lantern core → App discovery: uses app services
lantern-core/core.go - Lantern core → Private servers: uses server service
lantern-core/core.go - iOS VPN manager → VPN profile: loads profile
ios/Runner/VPN/VPNManager.swift - iOS VPN manager → Widget state: reads connection choice
ios/Runner/VPN/VPNManager.swift - Widget tunnel control → Widget state: reads and updates
ios/LanternWidget/WidgetTunnelController.swift - Widget tunnel control → Packet tunnel provider: starts tunnel
- macOS methods → System extension manager: uses extension manager
macos/Runner/Handlers/MethodHandler.swift - macOS VPN manager → Packet tunnel provider: starts tunnel
- Go mobile API → Lantern core: delegates to core
- Lantern core → Update relay: integrates update relay
- Android events → Android activity: delivers events
android/app/src/main/kotlin/org/getlantern/lantern/MainActivity.kt - Go mobile API → Log stream: streams logs