# dotsrival/dpiswitcher architecture

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

- Interactive diagram: https://gitdiagram.com/dotsrival/dpiswitcher
- Repository: https://github.com/dotsrival/dpiswitcher

## Overview

DPI Switcher is an Android app for changing display density (SmallestWidth) without rebooting. The main workflow is: a user selects a value in the app, the app validates and applies it through privileged shell access, then verifies and saves the result. Users can also save and cycle presets from a Quick Settings tile, and use a timed safety apply with auto-revert. The graph preserves these documented capabilities; some MainActivity relationships rely on the SOURCE INDEX because its excerpt is partial.

Main entry points: [`app/src/main/java/com/dpi/switcher/MainActivity.java`](https://github.com/dotsrival/dpiswitcher/blob/main/app/src/main/java/com/dpi/switcher/MainActivity.java) (Main UI), [`app/src/main/java/com/dpi/switcher/RootManager.java`](https://github.com/dotsrival/dpiswitcher/blob/main/app/src/main/java/com/dpi/switcher/RootManager.java) (Command runner), [`app/src/main/java/com/dpi/switcher/DpiTileService.java`](https://github.com/dotsrival/dpiswitcher/blob/main/app/src/main/java/com/dpi/switcher/DpiTileService.java) (Quick Settings tile), [`app/src/main/java/com/dpi/switcher/DpiController.java`](https://github.com/dotsrival/dpiswitcher/blob/main/app/src/main/java/com/dpi/switcher/DpiController.java) (DPI controller)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App experience"]
  node_main["Main UI<br/>[MainActivity.java]"]
  node_splash["Launch screen"]
  node_tilelaunch["Tile tap handler"]
  node_tilehelper["Tile setup<br/>[TileHelper.java]"]
  node_tile["Quick Settings tile"]
end

subgraph group_dpi["Density management"]
  node_dpi["DPI controller<br/>[DpiController.java]"]
  node_safety["Safety apply<br/>[DpiController.java]"]
  node_device["Device info and limits<br/>[DpiController.java]"]
end

subgraph group_access["Privileged access"]
  node_root["Command runner<br/>[RootManager.java]"]
end

subgraph group_state["Persistence"]
  node_state[("Preset and DPI state<br/>[StateManager.java]")]
end

node_user(("User"))
node_android["Android system"]
node_shizuku["Shizuku service"]

node_user -->|"launches"| node_splash
node_splash -->|"opens"| node_main
node_user -->|"selects DPI"| node_main
node_main -->|"requests changes"| node_dpi
node_main -->|"reads and saves"| node_state
node_main -->|"checks access"| node_root
node_main -.->|"offers tile setup"| node_tilehelper
node_tilehelper -->|"requests tile"| node_tile
node_user -->|"taps tile"| node_tile
node_tile -->|"cycles presets"| node_dpi
node_tile -->|"reads and saves"| node_state
node_tilelaunch -->|"opens"| node_main
node_dpi -->|"uses limits"| node_device
node_dpi -->|"runs density commands"| node_root
node_safety -->|"schedules revert"| node_root
node_root -->|"executes shell commands"| node_android
node_root -.->|"optionally dispatches"| node_shizuku

click node_main "https://github.com/dotsrival/dpiswitcher/blob/main/app/src/main/java/com/dpi/switcher/MainActivity.java"
click node_splash "https://github.com/dotsrival/dpiswitcher/blob/main/app/src/main/java/com/dpi/switcher/SplashActivity.java"
click node_tilelaunch "https://github.com/dotsrival/dpiswitcher/blob/main/app/src/main/java/com/dpi/switcher/TileLaunchActivity.java"
click node_tilehelper "https://github.com/dotsrival/dpiswitcher/blob/main/app/src/main/java/com/dpi/switcher/TileHelper.java"
click node_tile "https://github.com/dotsrival/dpiswitcher/blob/main/app/src/main/java/com/dpi/switcher/DpiTileService.java"
click node_dpi "https://github.com/dotsrival/dpiswitcher/blob/main/app/src/main/java/com/dpi/switcher/DpiController.java"
click node_safety "https://github.com/dotsrival/dpiswitcher/blob/main/app/src/main/java/com/dpi/switcher/DpiController.java"
click node_device "https://github.com/dotsrival/dpiswitcher/blob/main/app/src/main/java/com/dpi/switcher/DpiController.java"
click node_state "https://github.com/dotsrival/dpiswitcher/blob/main/app/src/main/java/com/dpi/switcher/StateManager.java"
click node_root "https://github.com/dotsrival/dpiswitcher/blob/main/app/src/main/java/com/dpi/switcher/RootManager.java"

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_main,node_splash,node_tilelaunch,node_tilehelper,node_tile,node_user toneBlue
class node_dpi,node_safety,node_device toneAmber
class node_root toneMint
class node_state toneRose
class node_android,node_shizuku toneIndigo
```

## Components

### App experience

- [Main UI](https://github.com/dotsrival/dpiswitcher/blob/main/app/src/main/java/com/dpi/switcher/MainActivity.java): `app/src/main/java/com/dpi/switcher/MainActivity.java`
- [Launch screen](https://github.com/dotsrival/dpiswitcher/blob/main/app/src/main/java/com/dpi/switcher/SplashActivity.java): `app/src/main/java/com/dpi/switcher/SplashActivity.java`
- [Tile tap handler](https://github.com/dotsrival/dpiswitcher/blob/main/app/src/main/java/com/dpi/switcher/TileLaunchActivity.java): `app/src/main/java/com/dpi/switcher/TileLaunchActivity.java`
- [Tile setup](https://github.com/dotsrival/dpiswitcher/blob/main/app/src/main/java/com/dpi/switcher/TileHelper.java): `app/src/main/java/com/dpi/switcher/TileHelper.java`
- [Quick Settings tile](https://github.com/dotsrival/dpiswitcher/blob/main/app/src/main/java/com/dpi/switcher/DpiTileService.java): `app/src/main/java/com/dpi/switcher/DpiTileService.java`

### Density management

- [DPI controller](https://github.com/dotsrival/dpiswitcher/blob/main/app/src/main/java/com/dpi/switcher/DpiController.java): `app/src/main/java/com/dpi/switcher/DpiController.java`
- [Safety apply](https://github.com/dotsrival/dpiswitcher/blob/main/app/src/main/java/com/dpi/switcher/DpiController.java): `app/src/main/java/com/dpi/switcher/DpiController.java`
- [Device info and limits](https://github.com/dotsrival/dpiswitcher/blob/main/app/src/main/java/com/dpi/switcher/DpiController.java): `app/src/main/java/com/dpi/switcher/DpiController.java`

### Privileged access

- [Command runner](https://github.com/dotsrival/dpiswitcher/blob/main/app/src/main/java/com/dpi/switcher/RootManager.java): `app/src/main/java/com/dpi/switcher/RootManager.java`

### Persistence

- [Preset and DPI state](https://github.com/dotsrival/dpiswitcher/blob/main/app/src/main/java/com/dpi/switcher/StateManager.java): `app/src/main/java/com/dpi/switcher/StateManager.java`

### Other components

- **User**
- **Android system**
- **Shizuku service**

## Connections

- User → Launch screen: launches (evidence: `app/src/main/java/com/dpi/switcher/SplashActivity.java`)
- Launch screen → Main UI: opens (evidence: `app/src/main/java/com/dpi/switcher/SplashActivity.java`)
- User → Main UI: selects DPI (evidence: `README.md`)
- Main UI → DPI controller: requests changes (evidence: `app/src/main/java/com/dpi/switcher/MainActivity.java`)
- Main UI → Preset and DPI state: reads and saves (evidence: `app/src/main/java/com/dpi/switcher/MainActivity.java`)
- Main UI → Command runner: checks access (evidence: `app/src/main/java/com/dpi/switcher/MainActivity.java`)
- Main UI → Tile setup: offers tile setup
- Tile setup → Quick Settings tile: requests tile (evidence: `app/src/main/java/com/dpi/switcher/TileHelper.java`)
- User → Quick Settings tile: taps tile (evidence: `README.md`)
- Quick Settings tile → DPI controller: cycles presets (evidence: `app/src/main/java/com/dpi/switcher/DpiTileService.java`)
- Quick Settings tile → Preset and DPI state: reads and saves (evidence: `app/src/main/java/com/dpi/switcher/DpiTileService.java`)
- Tile tap handler → Main UI: opens (evidence: `app/src/main/java/com/dpi/switcher/TileLaunchActivity.java`)
- DPI controller → Device info and limits: uses limits (evidence: `app/src/main/java/com/dpi/switcher/DpiController.java`)
- DPI controller → Command runner: runs density commands (evidence: `app/src/main/java/com/dpi/switcher/DpiController.java`)
- Safety apply → Command runner: schedules revert (evidence: `app/src/main/java/com/dpi/switcher/DpiController.java`)
- Command runner → Android system: executes shell commands (evidence: `app/src/main/java/com/dpi/switcher/RootManager.java`)
- Command runner → Shizuku service: optionally dispatches (evidence: `app/src/main/java/com/dpi/switcher/RootManager.java`)
