# keeperorowner/nagramxf architecture

> Architecture diagram of the GitHub repository keeperorowner/nagramxf, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/keeperorowner/nagramxf
- Repository: https://github.com/keeperorowner/nagramxf

## Overview

Nagram XF is an Android Telegram client fork, combining Telegram’s messaging application with additions from related clients. The principal user journey is app launch into the client UI, followed by messaging actions handled by account and message services, persisted locally and exchanged over Telegram’s network; the sampled material does not expose enough call sites to verify that full sequence. Distinct documented or indexed branches include localization, search, bookmarks, group-call messaging, and Elyx plugins. Dashed links mark workflow relationships not verified in the excerpts.

Main entry points: [`TMessagesProj/src/main/java/org/telegram/messenger/MessagesController.java`](https://github.com/keeperorowner/nagramxf/blob/dev/TMessagesProj/src/main/java/org/telegram/messenger/MessagesController.java) (Message services), [`TMessagesProj/src/main/java/org/telegram/messenger/voip/GroupCallMessagesController.java`](https://github.com/keeperorowner/nagramxf/blob/dev/TMessagesProj/src/main/java/org/telegram/messenger/voip/GroupCallMessagesController.java) (Call messages), [`TMessagesProj/src/main/java/org/telegram/ui/LaunchActivity.java`](https://github.com/keeperorowner/nagramxf/blob/dev/TMessagesProj/src/main/java/org/telegram/ui/LaunchActivity.java) (App launch), [`TMessagesProj/src/main/java/tw/nekomimi/nekogram/ui/BookmarkManagerActivity.java`](https://github.com/keeperorowner/nagramxf/blob/dev/TMessagesProj/src/main/java/tw/nekomimi/nekogram/ui/BookmarkManagerActivity.java) (Bookmark manager)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_shell["App and interface"]
  node_launch["App launch"]
  node_fragments["Fragment UI<br/>[BaseFragment.java]"]
  node_actionbar["Action bar<br/>[ActionBar.java]"]
  node_alerts["Dialogs<br/>[AlertDialog.java]"]
  node_recycler["List UI<br/>[RecyclerView.java]"]
end

subgraph group_messaging["Messaging services"]
  node_messages["Message services"]
  node_media["Media data"]
  node_events["Notifications"]
  node_account["Account state<br/>[UserConfig.java]"]
end

subgraph group_transport["Data and transport"]
  node_storage[("Message storage")]
  node_network["Telegram network"]
  node_protocol["TL protocol<br/>[TLRPC.java]"]
  node_appconfig[("App configuration<br/>[SharedConfig.java]")]
end

subgraph group_features["Client features"]
  node_locale["Localization"]
  node_androidutils["Android utilities"]
  node_theme["Theme system<br/>[Theme.java]"]
  node_bookmarks["Bookmark manager"]
  node_search["Web search<br/>[SearchEngine.java]"]
  node_groupcall["Call messages"]
  node_voip["VoIP service<br/>[VoIPService.java]"]
end

subgraph group_extensions["Plugin runtime"]
  node_engine["Elyx engine<br/>[_engine.py]"]
  node_pluginengine["Plugin lifecycle<br/>[_plugin_engine.py]"]
  node_importer["Plugin importer<br/>[_importer.py]"]
end

node_user(("User"))

node_user -.->|"opens"| node_launch
node_launch -.->|"shows UI"| node_fragments
node_fragments -.->|"requests messaging"| node_messages
node_messages -.->|"stores messages"| node_storage
node_messages -.->|"exchanges updates"| node_network
node_network -.->|"uses TL types"| node_protocol
node_bookmarks -->|"reads dialogs"| node_messages
node_bookmarks -->|"queries storage"| node_storage
node_search -->|"uses strings"| node_locale
node_search -->|"reads settings"| node_appconfig
node_groupcall -->|"uses call service"| node_voip
node_groupcall -->|"serializes updates"| node_protocol
node_groupcall -->|"dispatches UI work"| node_androidutils
node_androidutils -->|"uses app context"| node_launch
node_engine -->|"delegates lifecycle"| node_pluginengine
node_engine -->|"uses importer"| node_importer
node_pluginengine -->|"loads plugins"| node_importer

click node_launch "https://github.com/keeperorowner/nagramxf/blob/dev/TMessagesProj/src/main/java/org/telegram/ui/LaunchActivity.java"
click node_fragments "https://github.com/keeperorowner/nagramxf/blob/dev/TMessagesProj/src/main/java/org/telegram/ui/ActionBar/BaseFragment.java"
click node_actionbar "https://github.com/keeperorowner/nagramxf/blob/dev/TMessagesProj/src/main/java/org/telegram/ui/ActionBar/ActionBar.java"
click node_alerts "https://github.com/keeperorowner/nagramxf/blob/dev/TMessagesProj/src/main/java/org/telegram/ui/ActionBar/AlertDialog.java"
click node_recycler "https://github.com/keeperorowner/nagramxf/blob/dev/TMessagesProj/src/main/java/androidx/recyclerview/widget/RecyclerView.java"
click node_messages "https://github.com/keeperorowner/nagramxf/blob/dev/TMessagesProj/src/main/java/org/telegram/messenger/MessagesController.java"
click node_media "https://github.com/keeperorowner/nagramxf/blob/dev/TMessagesProj/src/main/java/org/telegram/messenger/MediaDataController.java"
click node_events "https://github.com/keeperorowner/nagramxf/blob/dev/TMessagesProj/src/main/java/org/telegram/messenger/NotificationCenter.java"
click node_account "https://github.com/keeperorowner/nagramxf/blob/dev/TMessagesProj/src/main/java/org/telegram/messenger/UserConfig.java"
click node_storage "https://github.com/keeperorowner/nagramxf/blob/dev/TMessagesProj/src/main/java/org/telegram/messenger/MessagesStorage.java"
click node_network "https://github.com/keeperorowner/nagramxf/blob/dev/TMessagesProj/src/main/java/org/telegram/tgnet/ConnectionsManager.java"
click node_protocol "https://github.com/keeperorowner/nagramxf/blob/dev/TMessagesProj/src/main/java/org/telegram/tgnet/TLRPC.java"
click node_appconfig "https://github.com/keeperorowner/nagramxf/blob/dev/TMessagesProj/src/main/java/org/telegram/messenger/SharedConfig.java"
click node_locale "https://github.com/keeperorowner/nagramxf/blob/dev/TMessagesProj/src/main/java/org/telegram/messenger/LocaleController.java"
click node_androidutils "https://github.com/keeperorowner/nagramxf/blob/dev/TMessagesProj/src/main/java/org/telegram/messenger/AndroidUtilities.java"
click node_theme "https://github.com/keeperorowner/nagramxf/blob/dev/TMessagesProj/src/main/java/org/telegram/ui/ActionBar/Theme.java"
click node_bookmarks "https://github.com/keeperorowner/nagramxf/blob/dev/TMessagesProj/src/main/java/tw/nekomimi/nekogram/ui/BookmarkManagerActivity.java"
click node_search "https://github.com/keeperorowner/nagramxf/blob/dev/TMessagesProj/src/main/java/org/telegram/ui/web/SearchEngine.java"
click node_groupcall "https://github.com/keeperorowner/nagramxf/blob/dev/TMessagesProj/src/main/java/org/telegram/messenger/voip/GroupCallMessagesController.java"
click node_voip "https://github.com/keeperorowner/nagramxf/blob/dev/TMessagesProj/src/main/java/org/telegram/messenger/voip/VoIPService.java"
click node_engine "https://github.com/keeperorowner/nagramxf/blob/dev/sdk_pysrc/elyxcore/_engine.py"
click node_pluginengine "https://github.com/keeperorowner/nagramxf/blob/dev/sdk_pysrc/elyxcore/_plugin_engine.py"
click node_importer "https://github.com/keeperorowner/nagramxf/blob/dev/sdk_pysrc/elyxcore/_importer.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_launch,node_fragments,node_actionbar,node_alerts,node_recycler,node_user toneBlue
class node_messages,node_media,node_events,node_account toneAmber
class node_storage,node_network,node_protocol,node_appconfig toneMint
class node_locale,node_androidutils,node_theme,node_bookmarks,node_search,node_groupcall,node_voip toneRose
class node_engine,node_pluginengine,node_importer toneIndigo
```

## Components

### App and interface

- [App launch](https://github.com/keeperorowner/nagramxf/blob/dev/TMessagesProj/src/main/java/org/telegram/ui/LaunchActivity.java): `TMessagesProj/src/main/java/org/telegram/ui/LaunchActivity.java`
- [Fragment UI](https://github.com/keeperorowner/nagramxf/blob/dev/TMessagesProj/src/main/java/org/telegram/ui/ActionBar/BaseFragment.java): `TMessagesProj/src/main/java/org/telegram/ui/ActionBar/BaseFragment.java`
- [Action bar](https://github.com/keeperorowner/nagramxf/blob/dev/TMessagesProj/src/main/java/org/telegram/ui/ActionBar/ActionBar.java): `TMessagesProj/src/main/java/org/telegram/ui/ActionBar/ActionBar.java`
- [Dialogs](https://github.com/keeperorowner/nagramxf/blob/dev/TMessagesProj/src/main/java/org/telegram/ui/ActionBar/AlertDialog.java): `TMessagesProj/src/main/java/org/telegram/ui/ActionBar/AlertDialog.java`
- [List UI](https://github.com/keeperorowner/nagramxf/blob/dev/TMessagesProj/src/main/java/androidx/recyclerview/widget/RecyclerView.java): `TMessagesProj/src/main/java/androidx/recyclerview/widget/RecyclerView.java`

### Messaging services

- [Message services](https://github.com/keeperorowner/nagramxf/blob/dev/TMessagesProj/src/main/java/org/telegram/messenger/MessagesController.java): `TMessagesProj/src/main/java/org/telegram/messenger/MessagesController.java`
- [Media data](https://github.com/keeperorowner/nagramxf/blob/dev/TMessagesProj/src/main/java/org/telegram/messenger/MediaDataController.java): `TMessagesProj/src/main/java/org/telegram/messenger/MediaDataController.java`
- [Notifications](https://github.com/keeperorowner/nagramxf/blob/dev/TMessagesProj/src/main/java/org/telegram/messenger/NotificationCenter.java): `TMessagesProj/src/main/java/org/telegram/messenger/NotificationCenter.java`
- [Account state](https://github.com/keeperorowner/nagramxf/blob/dev/TMessagesProj/src/main/java/org/telegram/messenger/UserConfig.java): `TMessagesProj/src/main/java/org/telegram/messenger/UserConfig.java`

### Data and transport

- [Message storage](https://github.com/keeperorowner/nagramxf/blob/dev/TMessagesProj/src/main/java/org/telegram/messenger/MessagesStorage.java): `TMessagesProj/src/main/java/org/telegram/messenger/MessagesStorage.java`
- [Telegram network](https://github.com/keeperorowner/nagramxf/blob/dev/TMessagesProj/src/main/java/org/telegram/tgnet/ConnectionsManager.java): `TMessagesProj/src/main/java/org/telegram/tgnet/ConnectionsManager.java`
- [TL protocol](https://github.com/keeperorowner/nagramxf/blob/dev/TMessagesProj/src/main/java/org/telegram/tgnet/TLRPC.java): `TMessagesProj/src/main/java/org/telegram/tgnet/TLRPC.java`
- [App configuration](https://github.com/keeperorowner/nagramxf/blob/dev/TMessagesProj/src/main/java/org/telegram/messenger/SharedConfig.java): `TMessagesProj/src/main/java/org/telegram/messenger/SharedConfig.java`

### Client features

- [Localization](https://github.com/keeperorowner/nagramxf/blob/dev/TMessagesProj/src/main/java/org/telegram/messenger/LocaleController.java): `TMessagesProj/src/main/java/org/telegram/messenger/LocaleController.java`
- [Android utilities](https://github.com/keeperorowner/nagramxf/blob/dev/TMessagesProj/src/main/java/org/telegram/messenger/AndroidUtilities.java): `TMessagesProj/src/main/java/org/telegram/messenger/AndroidUtilities.java`
- [Theme system](https://github.com/keeperorowner/nagramxf/blob/dev/TMessagesProj/src/main/java/org/telegram/ui/ActionBar/Theme.java): `TMessagesProj/src/main/java/org/telegram/ui/ActionBar/Theme.java`
- [Bookmark manager](https://github.com/keeperorowner/nagramxf/blob/dev/TMessagesProj/src/main/java/tw/nekomimi/nekogram/ui/BookmarkManagerActivity.java): `TMessagesProj/src/main/java/tw/nekomimi/nekogram/ui/BookmarkManagerActivity.java`
- [Web search](https://github.com/keeperorowner/nagramxf/blob/dev/TMessagesProj/src/main/java/org/telegram/ui/web/SearchEngine.java): `TMessagesProj/src/main/java/org/telegram/ui/web/SearchEngine.java`
- [Call messages](https://github.com/keeperorowner/nagramxf/blob/dev/TMessagesProj/src/main/java/org/telegram/messenger/voip/GroupCallMessagesController.java): `TMessagesProj/src/main/java/org/telegram/messenger/voip/GroupCallMessagesController.java`
- [VoIP service](https://github.com/keeperorowner/nagramxf/blob/dev/TMessagesProj/src/main/java/org/telegram/messenger/voip/VoIPService.java): `TMessagesProj/src/main/java/org/telegram/messenger/voip/VoIPService.java`

### Plugin runtime

- [Elyx engine](https://github.com/keeperorowner/nagramxf/blob/dev/sdk_pysrc/elyxcore/_engine.py): `sdk_pysrc/elyxcore/_engine.py`
- [Plugin lifecycle](https://github.com/keeperorowner/nagramxf/blob/dev/sdk_pysrc/elyxcore/_plugin_engine.py): `sdk_pysrc/elyxcore/_plugin_engine.py`
- [Plugin importer](https://github.com/keeperorowner/nagramxf/blob/dev/sdk_pysrc/elyxcore/_importer.py): `sdk_pysrc/elyxcore/_importer.py`

### Other components

- **User**

## Connections

- User → App launch: opens
- App launch → Fragment UI: shows UI (evidence: `TMessagesProj/src/main/java/org/telegram/ui/ActionBar/BaseFragment.java`)
- Fragment UI → Message services: requests messaging (evidence: `TMessagesProj/src/main/java/org/telegram/ui/ActionBar/BaseFragment.java`)
- Message services → Message storage: stores messages
- Message services → Telegram network: exchanges updates
- Telegram network → TL protocol: uses TL types
- Bookmark manager → Message services: reads dialogs (evidence: `TMessagesProj/src/main/java/tw/nekomimi/nekogram/ui/BookmarkManagerActivity.java`)
- Bookmark manager → Message storage: queries storage (evidence: `TMessagesProj/src/main/java/tw/nekomimi/nekogram/ui/BookmarkManagerActivity.java`)
- Web search → Localization: uses strings (evidence: `TMessagesProj/src/main/java/org/telegram/ui/web/SearchEngine.java`)
- Web search → App configuration: reads settings (evidence: `TMessagesProj/src/main/java/org/telegram/ui/web/SearchEngine.java`)
- Call messages → VoIP service: uses call service (evidence: `TMessagesProj/src/main/java/org/telegram/messenger/voip/GroupCallMessagesController.java`)
- Call messages → TL protocol: serializes updates (evidence: `TMessagesProj/src/main/java/org/telegram/messenger/voip/GroupCallMessagesController.java`)
- Call messages → Android utilities: dispatches UI work (evidence: `TMessagesProj/src/main/java/org/telegram/messenger/voip/GroupCallMessagesController.java`)
- Android utilities → App launch: uses app context (evidence: `TMessagesProj/src/main/java/org/telegram/messenger/AndroidUtilities.java`)
- Elyx engine → Plugin lifecycle: delegates lifecycle (evidence: `sdk_pysrc/elyxcore/_engine.py`)
- Elyx engine → Plugin importer: uses importer (evidence: `sdk_pysrc/elyxcore/_engine.py`)
- Plugin lifecycle → Plugin importer: loads plugins (evidence: `sdk_pysrc/elyxcore/_plugin_engine.py`)
