# xposed-modules-repo/com.shitianyaa.nagramx.videotimer architecture

> Architecture diagram of the GitHub repository xposed-modules-repo/com.shitianyaa.nagramx.videotimer, 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/xposed-modules-repo/com.shitianyaa.nagramx.videotimer
- Repository: https://github.com/xposed-modules-repo/com.shitianyaa.nagramx.videotimer

## Overview

NagramX Video Timer is an LSPosed module that adds timed background video playback and playback controls to the NagramX host app. The main user flow is choosing a timer from the video menu, transferring the active player to background playback, tracking timer/session state, and controlling or returning to playback through the chat player and system media notification. README documentation supports the feature-level relationships; source excerpts show selected menu, playlist, and media-controller interactions. Kotlin and Java variants are both represented where named as core modules; their runtime wiring is not assumed to be identical.

Main entry points: [`module/src/com/shitianyaa/nagramx/videotimer/PhotoViewerAgent.java`](https://github.com/xposed-modules-repo/com.shitianyaa.nagramx.videotimer/blob/main/module/src/com/shitianyaa/nagramx/videotimer/PhotoViewerAgent.java) (Video menu), [`module/src/com/shitianyaa/nagramx/videotimer/NagramXHooks.java`](https://github.com/xposed-modules-repo/com.shitianyaa.nagramx.videotimer/blob/main/module/src/com/shitianyaa/nagramx/videotimer/NagramXHooks.java) (Host hooks), [`module/src/com/shitianyaa/nagramx/videotimer/MediaControllerAgent.java`](https://github.com/xposed-modules-repo/com.shitianyaa.nagramx.videotimer/blob/main/module/src/com/shitianyaa/nagramx/videotimer/MediaControllerAgent.java) (Media controller), [`module/src/com/shitianyaa/nagramx/videotimer/VideoBackgroundSession.java`](https://github.com/xposed-modules-repo/com.shitianyaa.nagramx.videotimer/blob/main/module/src/com/shitianyaa/nagramx/videotimer/VideoBackgroundSession.java) (Timer session)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Module entry"]
  node_module_entry["Module entry<br/>[ModuleMain.java]"]
  node_hook_runtime["Hook runtime<br/>[Xp.java]"]
end

subgraph group_host["Host integration"]
  node_hooks["Host hooks<br/>[NagramXHooks.java]"]
  node_host_profile["Host profile<br/>[HostProfile.java]"]
  node_host_bridge["Host bridge<br/>[HostBridge.java]"]
  node_identity_mask["Message identity"]
  node_app_hooks["Kotlin hooks<br/>[NagramXHooks.kt]"]
  node_app_host_profile["Kotlin host profile<br/>[HostProfile.kt]"]
end

subgraph group_playback["Playback and timer"]
  node_photo_agent["Video menu"]
  node_timer_sheet["Timer picker"]
  node_timer_session["Timer session"]
  node_timer_state["Timer state<br/>[TimerState.java]"]
  node_media_agent["Media controller"]
  node_playlist["Video playlist"]
  node_app_photo_agent["Kotlin video menu"]
  node_app_timer_sheet["Kotlin timer picker"]
  node_app_timer_session["Kotlin timer session"]
  node_app_media_agent["Kotlin media controller"]
end

subgraph group_controls["Playback controls"]
  node_player_ui["Mini player UI<br/>[PlayerUiAgent.java]"]
  node_notification["Media notification"]
  node_media_controls["Media controls"]
  node_app_player_ui["Kotlin player UI<br/>[PlayerUiAgent.kt]"]
end

subgraph group_status["Module status"]
  node_app_runtime["Xposed service app<br/>[App.kt]"]
  node_status_screen["Status screen<br/>[MainActivity.kt]"]
end

node_user(("NagramX user"))
node_nagramx["NagramX host"]
node_xposed["LSPosed"]

node_user -->|"opens video"| node_nagramx
node_nagramx -->|"loads hooks"| node_hooks
node_module_entry -->|"binds runtime"| node_hook_runtime
node_module_entry -->|"registers hooks"| node_hooks
node_hooks -->|"uses host profile"| node_host_profile
node_user -->|"chooses timer"| node_photo_agent
node_photo_agent -->|"opens picker"| node_timer_sheet
node_photo_agent -->|"arms timer"| node_timer_session
node_photo_agent -->|"transfers player"| node_media_agent
node_timer_session -.->|"probes playback"| node_media_agent
node_timer_session -->|"exposes state"| node_timer_state
node_media_agent -->|"controls playback"| node_nagramx
node_photo_agent -->|"opens list"| node_playlist
node_photo_agent -->|"selects video"| node_player_ui
node_player_ui -->|"returns to video"| node_nagramx
node_media_agent -->|"starts media service"| node_notification
node_user -->|"uses media actions"| node_notification
node_notification -->|"dispatches controls"| node_media_controls
node_media_controls -->|"changes playback"| node_nagramx
node_hooks -->|"uses reflection bridge"| node_host_bridge
node_app_runtime -->|"reports service state"| node_status_screen
node_user -->|"checks module status"| node_status_screen

click node_module_entry "https://github.com/xposed-modules-repo/com.shitianyaa.nagramx.videotimer/blob/main/module/src/com/shitianyaa/nagramx/videotimer/ModuleMain.java"
click node_hook_runtime "https://github.com/xposed-modules-repo/com.shitianyaa.nagramx.videotimer/blob/main/module/src/com/shitianyaa/nagramx/videotimer/core/Xp.java"
click node_hooks "https://github.com/xposed-modules-repo/com.shitianyaa.nagramx.videotimer/blob/main/module/src/com/shitianyaa/nagramx/videotimer/NagramXHooks.java"
click node_host_profile "https://github.com/xposed-modules-repo/com.shitianyaa.nagramx.videotimer/blob/main/module/src/com/shitianyaa/nagramx/videotimer/HostProfile.java"
click node_host_bridge "https://github.com/xposed-modules-repo/com.shitianyaa.nagramx.videotimer/blob/main/module/src/com/shitianyaa/nagramx/videotimer/HostBridge.java"
click node_photo_agent "https://github.com/xposed-modules-repo/com.shitianyaa.nagramx.videotimer/blob/main/module/src/com/shitianyaa/nagramx/videotimer/PhotoViewerAgent.java"
click node_timer_sheet "https://github.com/xposed-modules-repo/com.shitianyaa.nagramx.videotimer/blob/main/module/src/com/shitianyaa/nagramx/videotimer/VideoSleepTimerSheet.java"
click node_timer_session "https://github.com/xposed-modules-repo/com.shitianyaa.nagramx.videotimer/blob/main/module/src/com/shitianyaa/nagramx/videotimer/VideoBackgroundSession.java"
click node_timer_state "https://github.com/xposed-modules-repo/com.shitianyaa.nagramx.videotimer/blob/main/module/src/com/shitianyaa/nagramx/videotimer/TimerState.java"
click node_media_agent "https://github.com/xposed-modules-repo/com.shitianyaa.nagramx.videotimer/blob/main/module/src/com/shitianyaa/nagramx/videotimer/MediaControllerAgent.java"
click node_playlist "https://github.com/xposed-modules-repo/com.shitianyaa.nagramx.videotimer/blob/main/module/src/com/shitianyaa/nagramx/videotimer/VideoPlaylistSheet.java"
click node_player_ui "https://github.com/xposed-modules-repo/com.shitianyaa.nagramx.videotimer/blob/main/module/src/com/shitianyaa/nagramx/videotimer/PlayerUiAgent.java"
click node_notification "https://github.com/xposed-modules-repo/com.shitianyaa.nagramx.videotimer/blob/main/module/src/com/shitianyaa/nagramx/videotimer/NotificationDresser.java"
click node_media_controls "https://github.com/xposed-modules-repo/com.shitianyaa.nagramx.videotimer/blob/main/module/src/com/shitianyaa/nagramx/videotimer/MediaControllerAgent.java"
click node_identity_mask "https://github.com/xposed-modules-repo/com.shitianyaa.nagramx.videotimer/blob/main/module/src/com/shitianyaa/nagramx/videotimer/MessageIdentityMask.java"
click node_app_runtime "https://github.com/xposed-modules-repo/com.shitianyaa.nagramx.videotimer/blob/main/app/src/main/java/com/shitianyaa/nagramx/videotimer/App.kt"
click node_status_screen "https://github.com/xposed-modules-repo/com.shitianyaa.nagramx.videotimer/blob/main/app/src/main/java/com/shitianyaa/nagramx/videotimer/MainActivity.kt"
click node_app_hooks "https://github.com/xposed-modules-repo/com.shitianyaa.nagramx.videotimer/blob/main/app/src/main/java/com/shitianyaa/nagramx/videotimer/NagramXHooks.kt"
click node_app_host_profile "https://github.com/xposed-modules-repo/com.shitianyaa.nagramx.videotimer/blob/main/app/src/main/java/com/shitianyaa/nagramx/videotimer/HostProfile.kt"
click node_app_photo_agent "https://github.com/xposed-modules-repo/com.shitianyaa.nagramx.videotimer/blob/main/app/src/main/java/com/shitianyaa/nagramx/videotimer/PhotoViewerAgent.kt"
click node_app_player_ui "https://github.com/xposed-modules-repo/com.shitianyaa.nagramx.videotimer/blob/main/app/src/main/java/com/shitianyaa/nagramx/videotimer/PlayerUiAgent.kt"
click node_app_timer_sheet "https://github.com/xposed-modules-repo/com.shitianyaa.nagramx.videotimer/blob/main/app/src/main/java/com/shitianyaa/nagramx/videotimer/VideoSleepTimerSheet.kt"
click node_app_timer_session "https://github.com/xposed-modules-repo/com.shitianyaa.nagramx.videotimer/blob/main/app/src/main/java/com/shitianyaa/nagramx/videotimer/VideoBackgroundSession.kt"
click node_app_media_agent "https://github.com/xposed-modules-repo/com.shitianyaa.nagramx.videotimer/blob/main/app/src/main/java/com/shitianyaa/nagramx/videotimer/MediaControllerAgent.kt"

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_module_entry,node_hook_runtime,node_user toneBlue
class node_hooks,node_host_profile,node_host_bridge,node_identity_mask,node_app_hooks,node_app_host_profile toneAmber
class node_photo_agent,node_timer_sheet,node_timer_session,node_timer_state,node_media_agent,node_playlist,node_app_photo_agent,node_app_timer_sheet,node_app_timer_session,node_app_media_agent toneMint
class node_player_ui,node_notification,node_media_controls,node_app_player_ui toneRose
class node_app_runtime,node_status_screen,node_nagramx,node_xposed toneIndigo
```

## Components

### Module entry

- [Module entry](https://github.com/xposed-modules-repo/com.shitianyaa.nagramx.videotimer/blob/main/module/src/com/shitianyaa/nagramx/videotimer/ModuleMain.java): `module/src/com/shitianyaa/nagramx/videotimer/ModuleMain.java`
- [Hook runtime](https://github.com/xposed-modules-repo/com.shitianyaa.nagramx.videotimer/blob/main/module/src/com/shitianyaa/nagramx/videotimer/core/Xp.java): `module/src/com/shitianyaa/nagramx/videotimer/core/Xp.java`

### Host integration

- [Host hooks](https://github.com/xposed-modules-repo/com.shitianyaa.nagramx.videotimer/blob/main/module/src/com/shitianyaa/nagramx/videotimer/NagramXHooks.java): `module/src/com/shitianyaa/nagramx/videotimer/NagramXHooks.java`
- [Host profile](https://github.com/xposed-modules-repo/com.shitianyaa.nagramx.videotimer/blob/main/module/src/com/shitianyaa/nagramx/videotimer/HostProfile.java): `module/src/com/shitianyaa/nagramx/videotimer/HostProfile.java`
- [Host bridge](https://github.com/xposed-modules-repo/com.shitianyaa.nagramx.videotimer/blob/main/module/src/com/shitianyaa/nagramx/videotimer/HostBridge.java): `module/src/com/shitianyaa/nagramx/videotimer/HostBridge.java`
- [Message identity](https://github.com/xposed-modules-repo/com.shitianyaa.nagramx.videotimer/blob/main/module/src/com/shitianyaa/nagramx/videotimer/MessageIdentityMask.java): `module/src/com/shitianyaa/nagramx/videotimer/MessageIdentityMask.java`
- [Kotlin hooks](https://github.com/xposed-modules-repo/com.shitianyaa.nagramx.videotimer/blob/main/app/src/main/java/com/shitianyaa/nagramx/videotimer/NagramXHooks.kt): `app/src/main/java/com/shitianyaa/nagramx/videotimer/NagramXHooks.kt`
- [Kotlin host profile](https://github.com/xposed-modules-repo/com.shitianyaa.nagramx.videotimer/blob/main/app/src/main/java/com/shitianyaa/nagramx/videotimer/HostProfile.kt): `app/src/main/java/com/shitianyaa/nagramx/videotimer/HostProfile.kt`

### Playback and timer

- [Video menu](https://github.com/xposed-modules-repo/com.shitianyaa.nagramx.videotimer/blob/main/module/src/com/shitianyaa/nagramx/videotimer/PhotoViewerAgent.java): `module/src/com/shitianyaa/nagramx/videotimer/PhotoViewerAgent.java`
- [Timer picker](https://github.com/xposed-modules-repo/com.shitianyaa.nagramx.videotimer/blob/main/module/src/com/shitianyaa/nagramx/videotimer/VideoSleepTimerSheet.java): `module/src/com/shitianyaa/nagramx/videotimer/VideoSleepTimerSheet.java`
- [Timer session](https://github.com/xposed-modules-repo/com.shitianyaa.nagramx.videotimer/blob/main/module/src/com/shitianyaa/nagramx/videotimer/VideoBackgroundSession.java): `module/src/com/shitianyaa/nagramx/videotimer/VideoBackgroundSession.java`
- [Timer state](https://github.com/xposed-modules-repo/com.shitianyaa.nagramx.videotimer/blob/main/module/src/com/shitianyaa/nagramx/videotimer/TimerState.java): `module/src/com/shitianyaa/nagramx/videotimer/TimerState.java`
- [Media controller](https://github.com/xposed-modules-repo/com.shitianyaa.nagramx.videotimer/blob/main/module/src/com/shitianyaa/nagramx/videotimer/MediaControllerAgent.java): `module/src/com/shitianyaa/nagramx/videotimer/MediaControllerAgent.java`
- [Video playlist](https://github.com/xposed-modules-repo/com.shitianyaa.nagramx.videotimer/blob/main/module/src/com/shitianyaa/nagramx/videotimer/VideoPlaylistSheet.java): `module/src/com/shitianyaa/nagramx/videotimer/VideoPlaylistSheet.java`
- [Kotlin video menu](https://github.com/xposed-modules-repo/com.shitianyaa.nagramx.videotimer/blob/main/app/src/main/java/com/shitianyaa/nagramx/videotimer/PhotoViewerAgent.kt): `app/src/main/java/com/shitianyaa/nagramx/videotimer/PhotoViewerAgent.kt`
- [Kotlin timer picker](https://github.com/xposed-modules-repo/com.shitianyaa.nagramx.videotimer/blob/main/app/src/main/java/com/shitianyaa/nagramx/videotimer/VideoSleepTimerSheet.kt): `app/src/main/java/com/shitianyaa/nagramx/videotimer/VideoSleepTimerSheet.kt`
- [Kotlin timer session](https://github.com/xposed-modules-repo/com.shitianyaa.nagramx.videotimer/blob/main/app/src/main/java/com/shitianyaa/nagramx/videotimer/VideoBackgroundSession.kt): `app/src/main/java/com/shitianyaa/nagramx/videotimer/VideoBackgroundSession.kt`
- [Kotlin media controller](https://github.com/xposed-modules-repo/com.shitianyaa.nagramx.videotimer/blob/main/app/src/main/java/com/shitianyaa/nagramx/videotimer/MediaControllerAgent.kt): `app/src/main/java/com/shitianyaa/nagramx/videotimer/MediaControllerAgent.kt`

### Playback controls

- [Mini player UI](https://github.com/xposed-modules-repo/com.shitianyaa.nagramx.videotimer/blob/main/module/src/com/shitianyaa/nagramx/videotimer/PlayerUiAgent.java): `module/src/com/shitianyaa/nagramx/videotimer/PlayerUiAgent.java`
- [Media notification](https://github.com/xposed-modules-repo/com.shitianyaa.nagramx.videotimer/blob/main/module/src/com/shitianyaa/nagramx/videotimer/NotificationDresser.java): `module/src/com/shitianyaa/nagramx/videotimer/NotificationDresser.java`
- [Media controls](https://github.com/xposed-modules-repo/com.shitianyaa.nagramx.videotimer/blob/main/module/src/com/shitianyaa/nagramx/videotimer/MediaControllerAgent.java): `module/src/com/shitianyaa/nagramx/videotimer/MediaControllerAgent.java`
- [Kotlin player UI](https://github.com/xposed-modules-repo/com.shitianyaa.nagramx.videotimer/blob/main/app/src/main/java/com/shitianyaa/nagramx/videotimer/PlayerUiAgent.kt): `app/src/main/java/com/shitianyaa/nagramx/videotimer/PlayerUiAgent.kt`

### Module status

- [Xposed service app](https://github.com/xposed-modules-repo/com.shitianyaa.nagramx.videotimer/blob/main/app/src/main/java/com/shitianyaa/nagramx/videotimer/App.kt): `app/src/main/java/com/shitianyaa/nagramx/videotimer/App.kt`
- [Status screen](https://github.com/xposed-modules-repo/com.shitianyaa.nagramx.videotimer/blob/main/app/src/main/java/com/shitianyaa/nagramx/videotimer/MainActivity.kt): `app/src/main/java/com/shitianyaa/nagramx/videotimer/MainActivity.kt`

### Other components

- **NagramX user**
- **NagramX host**
- **LSPosed**

## Connections

- NagramX user → NagramX host: opens video (evidence: `README.md`)
- NagramX host → Host hooks: loads hooks (evidence: `README.md`)
- Module entry → Hook runtime: binds runtime (evidence: `module/src/com/shitianyaa/nagramx/videotimer/ModuleMain.java`)
- Module entry → Host hooks: registers hooks (evidence: `module/src/com/shitianyaa/nagramx/videotimer/ModuleMain.java`)
- Host hooks → Host profile: uses host profile (evidence: `module/src/com/shitianyaa/nagramx/videotimer/NagramXHooks.java`)
- NagramX user → Video menu: chooses timer (evidence: `README.md`)
- Video menu → Timer picker: opens picker (evidence: `module/src/com/shitianyaa/nagramx/videotimer/PhotoViewerAgent.java`)
- Video menu → Timer session: arms timer (evidence: `README.md`)
- Video menu → Media controller: transfers player (evidence: `README.md`)
- Timer session → Media controller: probes playback
- Timer session → Timer state: exposes state (evidence: `module/src/com/shitianyaa/nagramx/videotimer/VideoBackgroundSession.java`)
- Media controller → NagramX host: controls playback (evidence: `module/src/com/shitianyaa/nagramx/videotimer/MediaControllerAgent.java`)
- Video menu → Video playlist: opens list (evidence: `module/src/com/shitianyaa/nagramx/videotimer/PhotoViewerAgent.java`)
- Video menu → Mini player UI: selects video (evidence: `module/src/com/shitianyaa/nagramx/videotimer/PhotoViewerAgent.java`)
- Mini player UI → NagramX host: returns to video (evidence: `README.md`)
- Media controller → Media notification: starts media service (evidence: `module/src/com/shitianyaa/nagramx/videotimer/MediaControllerAgent.java`)
- NagramX user → Media notification: uses media actions (evidence: `README.md`)
- Media notification → Media controls: dispatches controls (evidence: `README.md`)
- Media controls → NagramX host: changes playback (evidence: `README.md`)
- Host hooks → Host bridge: uses reflection bridge (evidence: `module/src/com/shitianyaa/nagramx/videotimer/NagramXHooks.java`)
- Xposed service app → Status screen: reports service state (evidence: `app/src/main/java/com/shitianyaa/nagramx/videotimer/MainActivity.kt`)
- NagramX user → Status screen: checks module status (evidence: `README.md`)
