Clashgram

Clashgram is a highly optimized, privacy-focused hybrid web and native client for Telegram. Architected on top of the official Telegram Web A client, Clashgram introduces rigorous privacy controls, client-side message retention, multi-account routing, dynamic glassmorphism interface layers, and local machine learning audio transcription.

The application is structured to run as a highly performant static web application and is packaged within a custom native Android container optimized for modern display cutouts and responsive safe area constraints.

Architectural Deep Dive and Implementation

Unlike simple interface wraps, Clashgram introduces state modifications, network interception, and local storage overrides directly within the Web client runtime.

1. Network-Level Privacy and Stealth Architecture

The privacy module operates at the boundary of the MTProto network client and local state selectors to restrict outbound data disclosure:

- Selective Read Acknowledgment: When a conversation is loaded, the client updates the local unread count to zero instantly for a clean user experience. However, outbound network packets for messages.readHistory are intercepted and discarded before serialization. - Typing State Suppression: Outgoing typing status updates, voice recording indicators, and document uploading states are intercepted at the action-handler level in src/global/actions/api/messages.ts and returned immediately, ensuring no status indicators are broadcast to target chats. - Presence Heartbeat Filtering: The application blocks outgoing status heartbeats (account.updateStatus). When the user's account configuration is set to public visibility for status tracking, Clashgram captures inbound presence streams for peer nodes while completely suppressing outgoing presence indicators. - Anonymized Story Consumption: Interactive story views are kept anonymous by suppressing the stories.readStories network calls, preventing the user's account identifier from registering in the author's viewed log.

2. Client-Side Data Retention (Anti-Deletion and Anti-Edition)

Clashgram maintains structural integrity of incoming communication by overriding server-directed deletion and modification commands:

- Message Retention (Anti-Delete): Server-side message retraction triggers (UpdateDeleteMessages) are intercepted inside src/global/reducers/messages.ts. Instead of purging target elements from the local state arrays, Clashgram flags the records with clashgramDeleted: true, halts active deletions, and persists the payload to an IndexedDB store via the saveClashgramMessage handler. Retained messages are rendered with an indicators to signify server retraction. - Revision History (Anti-Edit): Upon receiving message edit packets (UpdateEditMessage), Clashgram retrieves the cached content payload from local storage, assigns the historical text to the clashgramOriginalText field, and flags the message state. The UI displays the original revision beneath the edited message. - Automated Pruning: A toggleable retention scheduler allows users to configure database pruning intervals (1, 3, or 7 days, or until session close) to maintain local database performance.

3. Restriction Bypass Module

Channel and group protection flags (such as the no_forwards flag that limits copying, saving, and forwarding) are neutralized at the interface layer:

- The system strips the user-select: none CSS rules, overrides standard system right-click block actions in the document root, and forces media saving interfaces to remain active, enabling normal copying, selection, and forwarding.

4. Local Feature Emulation

Certain user configurations, premium features, and visual badges are unlocked via local state manipulation:

- Global state selectors (selectIsCurrentUserPremium and user info hooks) check the clashgramLocalPremium runtime parameter. - When active, the selectors inject simulated account flags into the current session. This enables localized interface badges, double-limit allocations, custom emoji sets, and reaction animations without modifying database records on the centralized servers.

5. On-Device Voice Transcription (Whisper AI)

Voice and audio message transcription is handled entirely client-side without relying on third-party cloud engines:

- Uses local Whisper models compiled to ONNX Runtime and executed directly within the web sandbox via WebGPU and WebAssembly. - Users can select between Tiny (optimized for speed and low memory profiles), Base (default performance threshold), and Small (highest accuracy). - Supports native language transcription and direct translation to English completely offline.

6. Hardware-Accelerated Glassmorphism Theme

The interface layer features a configurable depth theme:

- Renders translucent overlays using GPU-backed backdrop-filter: blur() configurations across panels, menus, and sidebars. - Utilizes a dynamic HSL styling engine to customize color Hue (0 to 360 degrees) and Opacity (0 to 100 percent) in real time.

7. Responsive Native Android Container

The mobile application is compiled into an Android wrapper using the Capacitor engine, featuring specialized configurations:

- Viewport Management: Binds layout parameters using standard CSS environment variables (env(safe-area-inset-top), env(safe-area-inset-bottom)). This ensures system taskbars and display camera cutouts do not overlap interactable components, maintaining layout consistency across diverse device orientations. - Adaptive Asset Assets: Native launchers use custom adaptive icon assets, compiled and rendered across multiple mipmap density levels (mdpi, hdpi, xhdpi, xxhdpi, xxxhdpi).

Licenses and Attributions

Clashgram is an independent modification based on the open-source Telegram Web A client. All original Telegram design assets, stylesheets, animations, and core algorithms are the properties of Telegram FZ-LLC. Modified and distributed under the GNU General Public License v3.0.