Superior Chat
Superior Chat solves a unique privacy challenge: chatting securely without maintaining a dedicated server or exposing a visible messaging app icon on your phone. It uses the Telegram Bot API as a serverless relay, leaving zero server footprint while incorporating advanced local camouflage options.
Launcher Discretion
Support for launcher icon concealment and camouflage as fully functional utility applications.
Serverless Transport
Powered entirely by Telegram Bot API long-polling. Zero hosting costs, 99.9% uptime, no third-party analytics.
Rich Media & Files
In-app camera, animated voice notes, smart media picker, and integrated hierarchical file explorer.
Security & Privacy
Discreet alerts, secure access codes, and Keystore-backed AES-256-GCM encryption for stored configuration credentials.
Technical Documentation
Core messaging, media capabilities, profile management, and flavor disguises.
Core Messaging
- Formatted Text: Send text with rich markdown styling.
- Quick Reactions: Double-tap any message to instantly react with emojis.
- Message Editing: Edit sent messages on the fly or bulk delete.
- Status Indicators: Real-time delivery updates (Sending, Sent, Failed).
Rich Media & Files
- Voice Messages: Record voice notes featuring dynamic waveform visualizations.
- File Sharing: Send any file type up to 50MB and download up to 20MB.
- File Explorer: Built-in hierarchical file browser with recent items.
- Smart Media Picker: Custom gallery grid neatly organized by albums.
Discreet Operation
- Custom Dialer Entry: Open the application interface via dialer code (*#*#9131#*#*).
- Discreet Alerts: Configurable alerts that mimic standard system or carrier telemetry notifications.
- Privacy Redirects: Redirects unauthorized attempts to open notifications directly to system settings.
- Screen Protection: Enforce system flags to block screenshots and screen recordings.
App Flavors & UI
- Weather Camouflage: Optional design disguise as a fully functional weather application.
- Network Camouflage: Disguise as standard captive portal system alerts.
- Material Design 3: Modern dark theme tailored for low-light visual comfort.
- Fluid Animations: Smooth responsive transitions for message bubbles.
Topology, Component layout, and Initialization flows.
System Topology
- Serverless Relay: Both users chat via a shared Telegram bot. The bot is just a relay—it stores nothing.
- Two-App Setup: `:setupapp` configures the device, passes encrypted credentials to `:app` via IPC, and asks to be uninstalled.
Component Architecture
- UI Layer: Built entirely with Jetpack Compose using MVVM and StateFlow.
- Service Layer: BotService runs in the foreground, with WorkManager fallback for Android 12+.
- Data Layer: Uses Room DB for storage and EncryptedSharedPreferences for credentials.
Polling loops, concurrent media transfers, and resilience mechanisms.
BotSync Engine
- Long-Polling: Continuous getUpdates to Telegram API with 80s timeouts.
- Intruder Filter: Silently drops updates where `chat_id` does not match the configured target.
- Network Awareness: Backs off exponentially on failure, suspends totally when offline via ConnectivityManager.
MediaSync Transfers
- Concurrent Safety: Uses Mutex to prevent duplicate transfers.
- Status Tracking: Real-time progress (0.0 to 1.0) computation via global StatusFlow for the UI.
- Efficient Processing: Uses BitmapRegionDecoder for minimal memory footprint and OOM prevention.
Developer's Note
This application was entirely developed with the assistance of Google's Antigravity AI. I am not a professional software developer and do not have formal training in Kotlin or other programming languages. This project is the result of a vision and a strong drive to make ideas work.
While every effort has been made to polish the codebase, there may still be undiscovered bugs. Use this application carefully.