Billing & Virtualization Management Client for Android
Full-featured Android client for the Aetheris platform. Manage servers, monitor resources, handle billing, and receive real-time alerts -- all from your mobile device.
- Server Discovery -- Automatic LAN discovery via UDP broadcast and manual WAN connection
- Dashboard -- Real-time stats, revenue, uptime, system health at a glance
- Server Management -- Start, stop, restart, suspend servers with resource monitoring
- Console -- Built-in terminal, VNC viewer, and file manager via WebView
- Billing -- Invoices, services, payment methods, and transaction history
- Alerts -- Severity-based alerts with acknowledgment and filtering
- Settings -- Dark/light theme, notifications, LAN discovery, language preferences
- Offline Support -- Room database for caching server data
- Responsive Design -- Material3 dynamic color and responsive layouts
com.aetheris.android/
AetherisApp.kt -- Application class (Hilt, notification channels)
MainActivity.kt -- Entry point with edge-to-edge theming
navigation/
NavGraph.kt -- Navigation routes and bottom nav
ui/
theme/
Theme.kt -- Material3 dark/light theme
Type.kt -- Typography system
screens/
auth/
ConnectScreen.kt -- Server discovery (LAN + manual)
LoginScreen.kt -- Email/password + social auth
dashboard/
DashboardScreen.kt -- Stats, health, quick actions
servers/
ServerListScreen.kt -- Server list with search/filter
ServerDetailScreen.kt -- Server detail with actions
console/
ConsoleScreen.kx -- Terminal, VNC, file manager
billing/
BillingScreen.kt -- Invoices, services overview
InvoiceDetailScreen.kt -- Invoice with line items
alerts/
AlertsScreen.kt -- Alert list with severity filtering
settings/
SettingsScreen.kt -- App configuration
data/
api/
AetherisApi.kt -- Retrofit API interface
model/
Server.kt -- Server data models
Billing.kt -- Invoice, Service, Payment models
Models.kt -- Node, Alert, Auth, Dashboard models
repository/
AetherisRepository.kt -- API wrapper with error handling
local/
PreferencesManager.kt -- DataStore preferences
AetherisDatabase.kt -- Room offline cache
dao/
CachedServerDao.kt -- Server cache DAO
di/
NetworkModule.kt -- Hilt DI for networking
service/
DiscoveryService.kt -- LAN discovery background service
NotificationService.kt -- Server status monitoring
util/
LanDiscovery.kt -- UDP broadcast LAN discovery
| Layer | Technology |
|---|---|
| Language | Kotlin 2.1 |
| UI | Jetpack Compose + Material3 |
| DI | Hilt (Dagger) |
| Networking | Retrofit + OkHttp + Kotlinx Serialization |
| Storage | DataStore + Room |
| Navigation | Navigation Compose |
| Image | Coil |
| WebView | AndroidX WebKit |
| Background | WorkManager + Foreground Services |
| Min SDK | 26 (Android 8.0) |
| Target SDK | 35 (Android 15) |
- Android Studio Hedgehog (2023.1) or later
- JDK 17
- Android SDK 35
git clone https://github.com/aetheris-project/aetheris-android.git
cd aetheris-android
# Debug build
./gradlew assembleDebug
# Release build (requires signing config)
./gradlew assembleReleaseadb install app/build/outputs/apk/debug/app-debug.apkThe app connects to any Aetheris panel instance. Configure the server URL:
- Open the app
- Tap Connect Manually
- Enter your panel URL (e.g.,
https://panel.example.com) - Sign in with your credentials
The app can automatically discover Aetheris panels on your local network:
- Ensure your device is on the same network as the panel
- Tap Discover on LAN
- Select a discovered panel from the list
The Android client communicates with the Aetheris panel via its REST API. Ensure your panel has:
- API access enabled
- CORS configured for mobile clients
- Authentication endpoints active
| Connect | Dashboard | Servers | Console |
|---|---|---|---|
| Server discovery with LAN scan | Stats, health, quick actions | Server list with resource bars | Terminal and VNC viewer |
| Repository | Description | URL |
|---|---|---|
| aetheris-app | Main web panel | GitHub |
| aetheris-website | Marketing site | GitHub |
| aetheris-docs | Documentation wiki | GitHub |
| aetheris-addons | Panel extensions | GitHub |
| aetheris-themes | Theme presets | GitHub |
| aetheris-game-eggs | Pterodactyl game eggs | GitHub |
| aetheris-windows-installer | Windows installer | GitHub |
| aetheris-installer | Linux installer | GitHub |
| aetheris-ops | Infrastructure | GitHub |
| aetheris-status | Status page | GitHub |
| aetheris-community | Community & workflows | GitHub |
| Resource | URL |
|---|---|
| Website | aetheris-web.vercel.app |
| Panel | aetheris-panel.vercel.app |
| Documentation | aetheris-docs.vercel.app |
| Status | aetheris-status.vercel.app |
| Discord | discord.gg/6GcfebuT2A |
| Contact | hello@another-horizon.eu |
All contributions require a Pull Request with automated CI checks (lint, typecheck, build) before manual review. See CONTRIBUTING.md for guidelines.
Contact: hello@another-horizon.eu
Copyright (C) 2026 Leonardo Galli (Leo-Galli), Aetheris Project -- AGPL-3.0