# yundatafw/mio-injector architecture

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

- Interactive diagram: https://gitdiagram.com/yundatafw/mio-injector
- Repository: https://github.com/yundatafw/mio-injector

## Overview

This is an Android key- and text-injection component. An application selects an injection mode through the factory, then uses the resulting injector to send input through either Mio’s IME or Shizuku’s shell service. SafeKeyInjector absorbs injection failures; CpsTracker decorates an injector with input-rate tracking. The excerpts show these runtime relationships, but do not reveal the wider application or the Shizuku service implementation.

Main entry points: [`io/takamiya/mio/injector/KeyInjectorFactory.java`](https://github.com/yundatafw/mio-injector/blob/main/io/takamiya/mio/injector/KeyInjectorFactory.java) (Injector factory), [`io/takamiya/mio/injector/ImeKeyInjector.java`](https://github.com/yundatafw/mio-injector/blob/main/io/takamiya/mio/injector/ImeKeyInjector.java) (IME injector), [`io/takamiya/mio/injector/ShizukuKeyInjector.java`](https://github.com/yundatafw/mio-injector/blob/main/io/takamiya/mio/injector/ShizukuKeyInjector.java) (Shizuku injector), [`io/takamiya/mio/injector/ImeAutoSwitchHelper.java`](https://github.com/yundatafw/mio-injector/blob/main/io/takamiya/mio/injector/ImeAutoSwitchHelper.java) (IME switch helper)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["Injector API"]
  node_factory["Injector factory"]
  node_contract["Injector contract<br/>[KeyInjector.java]"]
  node_safe["Safe wrapper"]
  node_cps["Rate tracker<br/>[CpsTracker.java]"]
  node_state["Service state<br/>[ServiceState.java]"]
  node_error["Injection error"]
  node_type["Backend type"]
end

subgraph group_backends["Injection backends"]
  node_imeinjector["IME injector"]
  node_shizuku["Shizuku injector"]
end

subgraph group_platform["Android services"]
  node_imeservice["Mio IME service<br/>[MioImeService.java]"]
  node_accessibility["Accessibility service"]
  node_switcher["IME switch helper"]
end

node_app(("Calling application"))
node_shell["Shizuku shell service"]

node_app -.->|"selects backend"| node_factory
node_factory -->|"creates"| node_shizuku
node_factory -->|"creates"| node_imeinjector
node_factory -->|"wraps result"| node_safe
node_safe -->|"delegates calls"| node_contract
node_cps -->|"delegates input"| node_contract
node_imeinjector -->|"sends input"| node_imeservice
node_accessibility -->|"queries IME"| node_imeinjector
node_shizuku -->|"injects via"| node_shell
node_shizuku -->|"switches IME"| node_switcher
node_switcher -->|"checks IME"| node_imeinjector
node_switcher -->|"uses service"| node_accessibility

click node_factory "https://github.com/yundatafw/mio-injector/blob/main/io/takamiya/mio/injector/KeyInjectorFactory.java"
click node_contract "https://github.com/yundatafw/mio-injector/blob/main/io/takamiya/mio/injector/KeyInjector.java"
click node_safe "https://github.com/yundatafw/mio-injector/blob/main/io/takamiya/mio/injector/SafeKeyInjector.java"
click node_cps "https://github.com/yundatafw/mio-injector/blob/main/io/takamiya/mio/injector/CpsTracker.java"
click node_state "https://github.com/yundatafw/mio-injector/blob/main/io/takamiya/mio/injector/ServiceState.java"
click node_error "https://github.com/yundatafw/mio-injector/blob/main/io/takamiya/mio/injector/InjectionException.java"
click node_type "https://github.com/yundatafw/mio-injector/blob/main/io/takamiya/mio/injector/KeyInjectorType.java"
click node_imeinjector "https://github.com/yundatafw/mio-injector/blob/main/io/takamiya/mio/injector/ImeKeyInjector.java"
click node_shizuku "https://github.com/yundatafw/mio-injector/blob/main/io/takamiya/mio/injector/ShizukuKeyInjector.java"
click node_imeservice "https://github.com/yundatafw/mio-injector/blob/main/io/takamiya/mio/injector/MioImeService.java"
click node_accessibility "https://github.com/yundatafw/mio-injector/blob/main/io/takamiya/mio/injector/MioAccessibilityService.java"
click node_switcher "https://github.com/yundatafw/mio-injector/blob/main/io/takamiya/mio/injector/ImeAutoSwitchHelper.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_factory,node_contract,node_safe,node_cps,node_state,node_error,node_type toneBlue
class node_imeinjector,node_shizuku toneAmber
class node_imeservice,node_accessibility,node_switcher toneMint
class node_app,node_shell toneIndigo
```

## Components

### Injector API

- [Injector factory](https://github.com/yundatafw/mio-injector/blob/main/io/takamiya/mio/injector/KeyInjectorFactory.java): `io/takamiya/mio/injector/KeyInjectorFactory.java`
- [Injector contract](https://github.com/yundatafw/mio-injector/blob/main/io/takamiya/mio/injector/KeyInjector.java): `io/takamiya/mio/injector/KeyInjector.java`
- [Safe wrapper](https://github.com/yundatafw/mio-injector/blob/main/io/takamiya/mio/injector/SafeKeyInjector.java): `io/takamiya/mio/injector/SafeKeyInjector.java`
- [Rate tracker](https://github.com/yundatafw/mio-injector/blob/main/io/takamiya/mio/injector/CpsTracker.java): `io/takamiya/mio/injector/CpsTracker.java`
- [Service state](https://github.com/yundatafw/mio-injector/blob/main/io/takamiya/mio/injector/ServiceState.java): `io/takamiya/mio/injector/ServiceState.java`
- [Injection error](https://github.com/yundatafw/mio-injector/blob/main/io/takamiya/mio/injector/InjectionException.java): `io/takamiya/mio/injector/InjectionException.java`
- [Backend type](https://github.com/yundatafw/mio-injector/blob/main/io/takamiya/mio/injector/KeyInjectorType.java): `io/takamiya/mio/injector/KeyInjectorType.java`

### Injection backends

- [IME injector](https://github.com/yundatafw/mio-injector/blob/main/io/takamiya/mio/injector/ImeKeyInjector.java): `io/takamiya/mio/injector/ImeKeyInjector.java`
- [Shizuku injector](https://github.com/yundatafw/mio-injector/blob/main/io/takamiya/mio/injector/ShizukuKeyInjector.java): `io/takamiya/mio/injector/ShizukuKeyInjector.java`

### Android services

- [Mio IME service](https://github.com/yundatafw/mio-injector/blob/main/io/takamiya/mio/injector/MioImeService.java): `io/takamiya/mio/injector/MioImeService.java`
- [Accessibility service](https://github.com/yundatafw/mio-injector/blob/main/io/takamiya/mio/injector/MioAccessibilityService.java): `io/takamiya/mio/injector/MioAccessibilityService.java`
- [IME switch helper](https://github.com/yundatafw/mio-injector/blob/main/io/takamiya/mio/injector/ImeAutoSwitchHelper.java): `io/takamiya/mio/injector/ImeAutoSwitchHelper.java`

### Other components

- **Calling application**
- **Shizuku shell service**

## Connections

- Calling application → Injector factory: selects backend
- Injector factory → Shizuku injector: creates (evidence: `io/takamiya/mio/injector/KeyInjectorFactory.java`)
- Injector factory → IME injector: creates (evidence: `io/takamiya/mio/injector/KeyInjectorFactory.java`)
- Injector factory → Safe wrapper: wraps result (evidence: `io/takamiya/mio/injector/KeyInjectorFactory.java`)
- Safe wrapper → Injector contract: delegates calls (evidence: `io/takamiya/mio/injector/SafeKeyInjector.java`)
- Rate tracker → Injector contract: delegates input (evidence: `io/takamiya/mio/injector/CpsTracker.java`)
- IME injector → Mio IME service: sends input (evidence: `io/takamiya/mio/injector/ImeKeyInjector.java`)
- Accessibility service → IME injector: queries IME (evidence: `io/takamiya/mio/injector/MioAccessibilityService.java`)
- Shizuku injector → Shizuku shell service: injects via (evidence: `io/takamiya/mio/injector/ShizukuKeyInjector.java`)
- Shizuku injector → IME switch helper: switches IME (evidence: `io/takamiya/mio/injector/ShizukuKeyInjector.java`)
- IME switch helper → IME injector: checks IME (evidence: `io/takamiya/mio/injector/ImeAutoSwitchHelper.java`)
- IME switch helper → Accessibility service: uses service (evidence: `io/takamiya/mio/injector/ImeAutoSwitchHelper.java`)
