# siavash79/pixelxpert architecture

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

- Interactive diagram: https://gitdiagram.com/siavash79/pixelxpert
- Repository: https://github.com/siavash79/pixelxpert

## Overview

PixelXpert is an Android system-customization module combining Xposed hooks with Magisk/KSU installation. The documented user workflow is to install the module, reboot, open its app, and apply customizations; settings are shared with the Xposed runtime, which dispatches behavior into Android and SystemUI modifications. The README identifies major feature areas, while source excerpts show preference propagation, reflective hooking, and selected modifications. Many UI screens and feature implementations are unsampled, so their detailed runtime connections are not asserted.

Main entry points: [`app/src/main/java/sh/siava/pixelxpert/xposed/utils/reflection/ReflectedClass.java`](https://github.com/siavash79/pixelxpert/blob/canary/app/src/main/java/sh/siava/pixelxpert/xposed/utils/reflection/ReflectedClass.java) (Reflection hook API), [`app/src/main/java/sh/siava/pixelxpert/xposed/modpacks/android/PackageManager.java`](https://github.com/siavash79/pixelxpert/blob/canary/app/src/main/java/sh/siava/pixelxpert/xposed/modpacks/android/PackageManager.java) (Package manager hooks), [`app/src/main/java/sh/siava/pixelxpert/ui/fragments`](https://github.com/siavash79/pixelxpert/tree/canary/app/src/main/java/sh/siava/pixelxpert/ui/fragments) (Customization settings), [`app/src/main/java/sh/siava/pixelxpert/xposed/XPrefs.java`](https://github.com/siavash79/pixelxpert/blob/canary/app/src/main/java/sh/siava/pixelxpert/xposed/XPrefs.java) (Xposed preference bridge)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["PixelXpert app"]
  node_app["PixelXpert application<br/>[PixelXpert.java]"]
  node_settings["Customization settings"]
  node_search["Preference search"]
end

subgraph group_prefs["Preferences"]
  node_prefs[("App preferences<br/>[PXPreferences.java]")]
  node_shared[("Preference storage")]
  node_remote["Remote preferences"]
end

subgraph group_runtime["Xposed runtime"]
  node_xprefs["Xposed preference bridge<br/>[XPrefs.java]"]
  node_launcher["Hook launcher<br/>[XPLauncher.java]"]
  node_base["Mod pack base<br/>[XposedModPack.java]"]
  node_reflection["Reflection hook API"]
end

subgraph group_mods["System modifications"]
  node_framework["Framework modifications"]
  node_package["Package manager hooks"]
  node_window["Window manager hooks"]
  node_uihooks["SystemUI modifications"]
  node_screenshot["Screenshot behavior"]
  node_gestures["Gesture navigation"]
  node_launcherhooks["Launcher navigation"]
  node_features["Other customization packs"]
end

node_user(("Device owner"))
node_root["Magisk / KSU"]
node_lsposed["LSPosed"]
node_android["Android system"]
node_systemui["SystemUI"]

node_user -->|"installs module"| node_root
node_user -->|"enables hooks"| node_lsposed
node_user -->|"applies changes"| node_app
node_app -.->|"configures"| node_settings
node_settings -.->|"updates"| node_prefs
node_search -->|"opens result"| node_settings
node_prefs -->|"uses storage"| node_shared
node_xprefs -->|"creates bridge"| node_remote
node_xprefs -->|"notifies packs"| node_launcher
node_launcher -.->|"dispatches packs"| node_base
node_package -->|"extends"| node_base
node_package -->|"registers hooks"| node_reflection
node_window -->|"registers hooks"| node_reflection
node_screenshot -->|"registers hooks"| node_reflection
node_gestures -.->|"registers hooks"| node_reflection
node_launcherhooks -->|"registers hooks"| node_reflection
node_package -->|"modifies package rules"| node_android
node_window -->|"hooks framework"| node_android
node_screenshot -->|"hooks screenshots"| node_systemui
node_gestures -->|"customizes navigation"| node_systemui
node_features -.->|"adds system features"| node_systemui

click node_app "https://github.com/siavash79/pixelxpert/blob/canary/app/src/main/java/sh/siava/pixelxpert/PixelXpert.java"
click node_settings "https://github.com/siavash79/pixelxpert/tree/canary/app/src/main/java/sh/siava/pixelxpert/ui/fragments"
click node_search "https://github.com/siavash79/pixelxpert/blob/canary/app/src/main/java/sh/siava/pixelxpert/ui/preferences/preferencesearch/SearchPreferenceFragment.java"
click node_prefs "https://github.com/siavash79/pixelxpert/blob/canary/app/src/main/java/sh/siava/pixelxpert/utils/PXPreferences.java"
click node_shared "https://github.com/siavash79/pixelxpert/blob/canary/app/src/main/java/sh/siava/pixelxpert/utils/ExtendedSharedPreferences.java"
click node_remote "https://github.com/siavash79/pixelxpert/blob/canary/app/src/main/java/sh/siava/pixelxpert/xposed/utils/ExtendedRemotePreferences.java"
click node_xprefs "https://github.com/siavash79/pixelxpert/blob/canary/app/src/main/java/sh/siava/pixelxpert/xposed/XPrefs.java"
click node_launcher "https://github.com/siavash79/pixelxpert/blob/canary/app/src/main/java/sh/siava/pixelxpert/xposed/XPLauncher.java"
click node_base "https://github.com/siavash79/pixelxpert/blob/canary/app/src/main/java/sh/siava/pixelxpert/xposed/XposedModPack.java"
click node_reflection "https://github.com/siavash79/pixelxpert/blob/canary/app/src/main/java/sh/siava/pixelxpert/xposed/utils/reflection/ReflectedClass.java"
click node_framework "https://github.com/siavash79/pixelxpert/tree/canary/app/src/main/java/sh/siava/pixelxpert/xposed/modpacks/android"
click node_package "https://github.com/siavash79/pixelxpert/blob/canary/app/src/main/java/sh/siava/pixelxpert/xposed/modpacks/android/PackageManager.java"
click node_window "https://github.com/siavash79/pixelxpert/blob/canary/app/src/main/java/sh/siava/pixelxpert/xposed/modpacks/android/PhoneWindowManager.java"
click node_uihooks "https://github.com/siavash79/pixelxpert/tree/canary/app/src/main/java/sh/siava/pixelxpert/xposed/modpacks/systemui"
click node_screenshot "https://github.com/siavash79/pixelxpert/blob/canary/app/src/main/java/sh/siava/pixelxpert/xposed/modpacks/systemui/ScreenshotManager.java"
click node_gestures "https://github.com/siavash79/pixelxpert/blob/canary/app/src/main/java/sh/siava/pixelxpert/xposed/modpacks/systemui/GestureNavbarManager.java"
click node_launcherhooks "https://github.com/siavash79/pixelxpert/blob/canary/app/src/main/java/sh/siava/pixelxpert/xposed/modpacks/launcher/LauncherGestureNavbarManager.java"
click node_features "https://github.com/siavash79/pixelxpert/tree/canary/app/src/main/java/sh/siava/pixelxpert/xposed/modpacks"

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_app,node_settings,node_search,node_systemui toneBlue
class node_prefs,node_shared,node_remote toneAmber
class node_xprefs,node_launcher,node_base,node_reflection toneMint
class node_framework,node_package,node_window,node_uihooks,node_screenshot,node_gestures,node_launcherhooks,node_features toneRose
class node_user,node_root,node_lsposed,node_android toneIndigo
```

## Components

### PixelXpert app

- [PixelXpert application](https://github.com/siavash79/pixelxpert/blob/canary/app/src/main/java/sh/siava/pixelxpert/PixelXpert.java): `app/src/main/java/sh/siava/pixelxpert/PixelXpert.java`
- [Customization settings](https://github.com/siavash79/pixelxpert/tree/canary/app/src/main/java/sh/siava/pixelxpert/ui/fragments): `app/src/main/java/sh/siava/pixelxpert/ui/fragments`
- [Preference search](https://github.com/siavash79/pixelxpert/blob/canary/app/src/main/java/sh/siava/pixelxpert/ui/preferences/preferencesearch/SearchPreferenceFragment.java): `app/src/main/java/sh/siava/pixelxpert/ui/preferences/preferencesearch/SearchPreferenceFragment.java`

### Preferences

- [App preferences](https://github.com/siavash79/pixelxpert/blob/canary/app/src/main/java/sh/siava/pixelxpert/utils/PXPreferences.java): `app/src/main/java/sh/siava/pixelxpert/utils/PXPreferences.java`
- [Preference storage](https://github.com/siavash79/pixelxpert/blob/canary/app/src/main/java/sh/siava/pixelxpert/utils/ExtendedSharedPreferences.java): `app/src/main/java/sh/siava/pixelxpert/utils/ExtendedSharedPreferences.java`
- [Remote preferences](https://github.com/siavash79/pixelxpert/blob/canary/app/src/main/java/sh/siava/pixelxpert/xposed/utils/ExtendedRemotePreferences.java): `app/src/main/java/sh/siava/pixelxpert/xposed/utils/ExtendedRemotePreferences.java`

### Xposed runtime

- [Xposed preference bridge](https://github.com/siavash79/pixelxpert/blob/canary/app/src/main/java/sh/siava/pixelxpert/xposed/XPrefs.java): `app/src/main/java/sh/siava/pixelxpert/xposed/XPrefs.java`
- [Hook launcher](https://github.com/siavash79/pixelxpert/blob/canary/app/src/main/java/sh/siava/pixelxpert/xposed/XPLauncher.java): `app/src/main/java/sh/siava/pixelxpert/xposed/XPLauncher.java`
- [Mod pack base](https://github.com/siavash79/pixelxpert/blob/canary/app/src/main/java/sh/siava/pixelxpert/xposed/XposedModPack.java): `app/src/main/java/sh/siava/pixelxpert/xposed/XposedModPack.java`
- [Reflection hook API](https://github.com/siavash79/pixelxpert/blob/canary/app/src/main/java/sh/siava/pixelxpert/xposed/utils/reflection/ReflectedClass.java): `app/src/main/java/sh/siava/pixelxpert/xposed/utils/reflection/ReflectedClass.java`

### System modifications

- [Framework modifications](https://github.com/siavash79/pixelxpert/tree/canary/app/src/main/java/sh/siava/pixelxpert/xposed/modpacks/android): `app/src/main/java/sh/siava/pixelxpert/xposed/modpacks/android`
- [Package manager hooks](https://github.com/siavash79/pixelxpert/blob/canary/app/src/main/java/sh/siava/pixelxpert/xposed/modpacks/android/PackageManager.java): `app/src/main/java/sh/siava/pixelxpert/xposed/modpacks/android/PackageManager.java`
- [Window manager hooks](https://github.com/siavash79/pixelxpert/blob/canary/app/src/main/java/sh/siava/pixelxpert/xposed/modpacks/android/PhoneWindowManager.java): `app/src/main/java/sh/siava/pixelxpert/xposed/modpacks/android/PhoneWindowManager.java`
- [SystemUI modifications](https://github.com/siavash79/pixelxpert/tree/canary/app/src/main/java/sh/siava/pixelxpert/xposed/modpacks/systemui): `app/src/main/java/sh/siava/pixelxpert/xposed/modpacks/systemui`
- [Screenshot behavior](https://github.com/siavash79/pixelxpert/blob/canary/app/src/main/java/sh/siava/pixelxpert/xposed/modpacks/systemui/ScreenshotManager.java): `app/src/main/java/sh/siava/pixelxpert/xposed/modpacks/systemui/ScreenshotManager.java`
- [Gesture navigation](https://github.com/siavash79/pixelxpert/blob/canary/app/src/main/java/sh/siava/pixelxpert/xposed/modpacks/systemui/GestureNavbarManager.java): `app/src/main/java/sh/siava/pixelxpert/xposed/modpacks/systemui/GestureNavbarManager.java`
- [Launcher navigation](https://github.com/siavash79/pixelxpert/blob/canary/app/src/main/java/sh/siava/pixelxpert/xposed/modpacks/launcher/LauncherGestureNavbarManager.java): `app/src/main/java/sh/siava/pixelxpert/xposed/modpacks/launcher/LauncherGestureNavbarManager.java`
- [Other customization packs](https://github.com/siavash79/pixelxpert/tree/canary/app/src/main/java/sh/siava/pixelxpert/xposed/modpacks): `app/src/main/java/sh/siava/pixelxpert/xposed/modpacks`

### Other components

- **Device owner**
- **Magisk / KSU**
- **LSPosed**
- **Android system**
- **SystemUI**

## Connections

- Device owner → Magisk / KSU: installs module
- Device owner → LSPosed: enables hooks
- Device owner → PixelXpert application: applies changes
- PixelXpert application → Customization settings: configures
- Customization settings → App preferences: updates
- Preference search → Customization settings: opens result (evidence: `app/src/main/java/sh/siava/pixelxpert/ui/preferences/preferencesearch/SearchPreferenceFragment.java`)
- App preferences → Preference storage: uses storage (evidence: `app/src/main/java/sh/siava/pixelxpert/utils/PXPreferences.java`)
- Xposed preference bridge → Remote preferences: creates bridge (evidence: `app/src/main/java/sh/siava/pixelxpert/xposed/XPrefs.java`)
- Xposed preference bridge → Hook launcher: notifies packs (evidence: `app/src/main/java/sh/siava/pixelxpert/xposed/XPrefs.java`)
- Hook launcher → Mod pack base: dispatches packs
- Package manager hooks → Mod pack base: extends (evidence: `app/src/main/java/sh/siava/pixelxpert/xposed/modpacks/android/PackageManager.java`)
- Package manager hooks → Reflection hook API: registers hooks (evidence: `app/src/main/java/sh/siava/pixelxpert/xposed/modpacks/android/PackageManager.java`)
- Window manager hooks → Reflection hook API: registers hooks (evidence: `app/src/main/java/sh/siava/pixelxpert/xposed/modpacks/android/PhoneWindowManager.java`)
- Screenshot behavior → Reflection hook API: registers hooks (evidence: `app/src/main/java/sh/siava/pixelxpert/xposed/modpacks/systemui/ScreenshotManager.java`)
- Gesture navigation → Reflection hook API: registers hooks (evidence: `app/src/main/java/sh/siava/pixelxpert/xposed/modpacks/systemui/GestureNavbarManager.java`)
- Launcher navigation → Reflection hook API: registers hooks (evidence: `app/src/main/java/sh/siava/pixelxpert/xposed/modpacks/launcher/LauncherGestureNavbarManager.java`)
- Package manager hooks → Android system: modifies package rules
- Window manager hooks → Android system: hooks framework
- Screenshot behavior → SystemUI: hooks screenshots
- Gesture navigation → SystemUI: customizes navigation
- Other customization packs → SystemUI: adds system features
