How keeperorowner/nagramxf works
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: MessagesController.java Message services · GroupCallMessagesController.java Call messages · LaunchActivity.java App launch · BookmarkManagerActivity.java Bookmark manager
Components 24
App and interface
- App launch
TMessagesProj/src/main/java/org/telegram/ui/LaunchActivity.java - Fragment UI
TMessagesProj/src/main/java/org/telegram/ui/ActionBar/BaseFragment.java - Action bar
TMessagesProj/src/main/java/org/telegram/ui/ActionBar/ActionBar.java - Dialogs
TMessagesProj/src/main/java/org/telegram/ui/ActionBar/AlertDialog.java - List UI
TMessagesProj/src/main/java/androidx/recyclerview/widget/RecyclerView.java
Messaging services
- Message services
TMessagesProj/src/main/java/org/telegram/messenger/MessagesController.java - Media data
TMessagesProj/src/main/java/org/telegram/messenger/MediaDataController.java - Notifications
TMessagesProj/src/main/java/org/telegram/messenger/NotificationCenter.java - Account state
TMessagesProj/src/main/java/org/telegram/messenger/UserConfig.java
Data and transport
- Message storage
TMessagesProj/src/main/java/org/telegram/messenger/MessagesStorage.java - Telegram network
TMessagesProj/src/main/java/org/telegram/tgnet/ConnectionsManager.java - TL protocol
TMessagesProj/src/main/java/org/telegram/tgnet/TLRPC.java - App configuration
TMessagesProj/src/main/java/org/telegram/messenger/SharedConfig.java
Client features
- Localization
TMessagesProj/src/main/java/org/telegram/messenger/LocaleController.java - Android utilities
TMessagesProj/src/main/java/org/telegram/messenger/AndroidUtilities.java - Theme system
TMessagesProj/src/main/java/org/telegram/ui/ActionBar/Theme.java - Bookmark manager
TMessagesProj/src/main/java/tw/nekomimi/nekogram/ui/BookmarkManagerActivity.java - Web search
TMessagesProj/src/main/java/org/telegram/ui/web/SearchEngine.java - Call messages
TMessagesProj/src/main/java/org/telegram/messenger/voip/GroupCallMessagesController.java - VoIP service
TMessagesProj/src/main/java/org/telegram/messenger/voip/VoIPService.java
Plugin runtime
- Elyx engine
sdk_pysrc/elyxcore/_engine.py - Plugin lifecycle
sdk_pysrc/elyxcore/_plugin_engine.py - Plugin importer
sdk_pysrc/elyxcore/_importer.py
Other components
- User
Connections 17
- User → App launch: opens
- App launch → Fragment UI: shows UI
TMessagesProj/src/main/java/org/telegram/ui/ActionBar/BaseFragment.java - Fragment UI → Message services: requests messaging
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
TMessagesProj/src/main/java/tw/nekomimi/nekogram/ui/BookmarkManagerActivity.java - Bookmark manager → Message storage: queries storage
TMessagesProj/src/main/java/tw/nekomimi/nekogram/ui/BookmarkManagerActivity.java - Web search → Localization: uses strings
TMessagesProj/src/main/java/org/telegram/ui/web/SearchEngine.java - Web search → App configuration: reads settings
TMessagesProj/src/main/java/org/telegram/ui/web/SearchEngine.java - Call messages → VoIP service: uses call service
TMessagesProj/src/main/java/org/telegram/messenger/voip/GroupCallMessagesController.java - Call messages → TL protocol: serializes updates
TMessagesProj/src/main/java/org/telegram/messenger/voip/GroupCallMessagesController.java - Call messages → Android utilities: dispatches UI work
TMessagesProj/src/main/java/org/telegram/messenger/voip/GroupCallMessagesController.java - Android utilities → App launch: uses app context
TMessagesProj/src/main/java/org/telegram/messenger/AndroidUtilities.java - Elyx engine → Plugin lifecycle: delegates lifecycle
sdk_pysrc/elyxcore/_engine.py - Elyx engine → Plugin importer: uses importer
sdk_pysrc/elyxcore/_engine.py - Plugin lifecycle → Plugin importer: loads plugins
sdk_pysrc/elyxcore/_plugin_engine.py