# csemerg-star/ctremoteplus architecture

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

- Interactive diagram: https://gitdiagram.com/csemerg-star/ctremoteplus
- Repository: https://github.com/csemerg-star/ctremoteplus

## Overview

CTRemotePlus is an Android remote-control app. Users select a device type, choose a brand or scan for an IR profile, then issue remote commands from the main screen. The sampled runtime shows that workflow through IR code lookup, protocol encoding, and device transmission, with saved preferences for device and brand settings. The tree also includes network controllers for LG, Samsung, Android TV, and Wake-on-LAN; their integration into the UI is not shown, so their links are left unverified.

Main entry points: [`app/src/main/java/com/ctremoteplus/app/MainActivity.kt`](https://github.com/csemerg-star/ctremoteplus/blob/main/app/src/main/java/com/ctremoteplus/app/MainActivity.kt) (Remote screen), [`app/src/main/java/com/ctremoteplus/app/ir/IrController.kt`](https://github.com/csemerg-star/ctremoteplus/blob/main/app/src/main/java/com/ctremoteplus/app/ir/IrController.kt) (IR transmitter), [`app/src/main/java/com/ctremoteplus/app/DeviceSelectionActivity.kt`](https://github.com/csemerg-star/ctremoteplus/blob/main/app/src/main/java/com/ctremoteplus/app/DeviceSelectionActivity.kt) (Device selection), [`app/src/main/java/com/ctremoteplus/app/Prefs.kt`](https://github.com/csemerg-star/ctremoteplus/blob/main/app/src/main/java/com/ctremoteplus/app/Prefs.kt) (Saved preferences)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_appflow["App workflow"]
  node_device_selection["Device selection"]
  node_main_activity["Remote screen<br/>[MainActivity.kt]"]
  node_prefs[("Saved preferences<br/>[Prefs.kt]")]
end

subgraph group_ir["Infrared control"]
  node_code_database["IR code sets<br/>[IrCodeDatabase.kt]"]
  node_scanner["Code scanner<br/>[IrScanner.kt]"]
  node_ir_controller["IR transmitter<br/>[IrController.kt]"]
  node_protocols["IR encoders<br/>[IrProtocols.kt]"]
end

subgraph group_network["Network control"]
  node_lg_controller["LG controller<br/>[LgTvController.kt]"]
  node_samsung_controller["Samsung controller"]
  node_android_tv_controller["Android TV controller"]
  node_wol["Wake-on-LAN<br/>[WakeOnLan.kt]"]
end

node_user(("User"))
node_ir_emitter(("IR emitter"))
node_target_tv(("Television"))

node_user -->|"chooses device"| node_device_selection
node_device_selection -->|"saves type"| node_prefs
node_device_selection -->|"opens screen"| node_main_activity
node_main_activity -->|"reads settings"| node_prefs
node_main_activity -->|"saves brand"| node_prefs
node_main_activity -->|"resolves codes"| node_code_database
node_main_activity -->|"sends commands"| node_ir_controller
node_main_activity -->|"starts scan"| node_scanner
node_main_activity -->|"reads scan values"| node_code_database
node_scanner -->|"tests raw codes"| node_ir_controller
node_ir_controller -->|"encodes signals"| node_protocols
node_ir_controller -->|"transmits IR"| node_ir_emitter
node_lg_controller -.->|"controls WebSocket"| node_target_tv
node_samsung_controller -.->|"controls WebSocket"| node_target_tv
node_android_tv_controller -.->|"sends key events"| node_target_tv
node_wol -.->|"sends wake packet"| node_target_tv

click node_device_selection "https://github.com/csemerg-star/ctremoteplus/blob/main/app/src/main/java/com/ctremoteplus/app/DeviceSelectionActivity.kt"
click node_main_activity "https://github.com/csemerg-star/ctremoteplus/blob/main/app/src/main/java/com/ctremoteplus/app/MainActivity.kt"
click node_prefs "https://github.com/csemerg-star/ctremoteplus/blob/main/app/src/main/java/com/ctremoteplus/app/Prefs.kt"
click node_code_database "https://github.com/csemerg-star/ctremoteplus/blob/main/app/src/main/java/com/ctremoteplus/app/ir/IrCodeDatabase.kt"
click node_scanner "https://github.com/csemerg-star/ctremoteplus/blob/main/app/src/main/java/com/ctremoteplus/app/ir/IrScanner.kt"
click node_ir_controller "https://github.com/csemerg-star/ctremoteplus/blob/main/app/src/main/java/com/ctremoteplus/app/ir/IrController.kt"
click node_protocols "https://github.com/csemerg-star/ctremoteplus/blob/main/app/src/main/java/com/ctremoteplus/app/ir/IrProtocols.kt"
click node_lg_controller "https://github.com/csemerg-star/ctremoteplus/blob/main/app/src/main/java/com/ctremoteplus/app/net/LgTvController.kt"
click node_samsung_controller "https://github.com/csemerg-star/ctremoteplus/blob/main/app/src/main/java/com/ctremoteplus/app/net/SamsungTvController.kt"
click node_android_tv_controller "https://github.com/csemerg-star/ctremoteplus/blob/main/app/src/main/java/com/ctremoteplus/app/net/AndroidTvAdbController.kt"
click node_wol "https://github.com/csemerg-star/ctremoteplus/blob/main/app/src/main/java/com/ctremoteplus/app/net/WakeOnLan.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_device_selection,node_main_activity,node_prefs,node_user toneBlue
class node_code_database,node_scanner,node_ir_controller,node_protocols toneAmber
class node_lg_controller,node_samsung_controller,node_android_tv_controller,node_wol toneMint
class node_ir_emitter,node_target_tv toneIndigo
```

## Components

### App workflow

- [Device selection](https://github.com/csemerg-star/ctremoteplus/blob/main/app/src/main/java/com/ctremoteplus/app/DeviceSelectionActivity.kt): `app/src/main/java/com/ctremoteplus/app/DeviceSelectionActivity.kt`
- [Remote screen](https://github.com/csemerg-star/ctremoteplus/blob/main/app/src/main/java/com/ctremoteplus/app/MainActivity.kt): `app/src/main/java/com/ctremoteplus/app/MainActivity.kt`
- [Saved preferences](https://github.com/csemerg-star/ctremoteplus/blob/main/app/src/main/java/com/ctremoteplus/app/Prefs.kt): `app/src/main/java/com/ctremoteplus/app/Prefs.kt`

### Infrared control

- [IR code sets](https://github.com/csemerg-star/ctremoteplus/blob/main/app/src/main/java/com/ctremoteplus/app/ir/IrCodeDatabase.kt): `app/src/main/java/com/ctremoteplus/app/ir/IrCodeDatabase.kt`
- [Code scanner](https://github.com/csemerg-star/ctremoteplus/blob/main/app/src/main/java/com/ctremoteplus/app/ir/IrScanner.kt): `app/src/main/java/com/ctremoteplus/app/ir/IrScanner.kt`
- [IR transmitter](https://github.com/csemerg-star/ctremoteplus/blob/main/app/src/main/java/com/ctremoteplus/app/ir/IrController.kt): `app/src/main/java/com/ctremoteplus/app/ir/IrController.kt`
- [IR encoders](https://github.com/csemerg-star/ctremoteplus/blob/main/app/src/main/java/com/ctremoteplus/app/ir/IrProtocols.kt): `app/src/main/java/com/ctremoteplus/app/ir/IrProtocols.kt`

### Network control

- [LG controller](https://github.com/csemerg-star/ctremoteplus/blob/main/app/src/main/java/com/ctremoteplus/app/net/LgTvController.kt): `app/src/main/java/com/ctremoteplus/app/net/LgTvController.kt`
- [Samsung controller](https://github.com/csemerg-star/ctremoteplus/blob/main/app/src/main/java/com/ctremoteplus/app/net/SamsungTvController.kt): `app/src/main/java/com/ctremoteplus/app/net/SamsungTvController.kt`
- [Android TV controller](https://github.com/csemerg-star/ctremoteplus/blob/main/app/src/main/java/com/ctremoteplus/app/net/AndroidTvAdbController.kt): `app/src/main/java/com/ctremoteplus/app/net/AndroidTvAdbController.kt`
- [Wake-on-LAN](https://github.com/csemerg-star/ctremoteplus/blob/main/app/src/main/java/com/ctremoteplus/app/net/WakeOnLan.kt): `app/src/main/java/com/ctremoteplus/app/net/WakeOnLan.kt`

### Other components

- **User**
- **IR emitter**
- **Television**

## Connections

- User → Device selection: chooses device (evidence: `app/src/main/java/com/ctremoteplus/app/DeviceSelectionActivity.kt`)
- Device selection → Saved preferences: saves type (evidence: `app/src/main/java/com/ctremoteplus/app/DeviceSelectionActivity.kt`)
- Device selection → Remote screen: opens screen (evidence: `app/src/main/java/com/ctremoteplus/app/DeviceSelectionActivity.kt`)
- Remote screen → Saved preferences: reads settings (evidence: `app/src/main/java/com/ctremoteplus/app/MainActivity.kt`)
- Remote screen → Saved preferences: saves brand (evidence: `app/src/main/java/com/ctremoteplus/app/MainActivity.kt`)
- Remote screen → IR code sets: resolves codes (evidence: `app/src/main/java/com/ctremoteplus/app/MainActivity.kt`)
- Remote screen → IR transmitter: sends commands (evidence: `app/src/main/java/com/ctremoteplus/app/MainActivity.kt`)
- Remote screen → Code scanner: starts scan (evidence: `app/src/main/java/com/ctremoteplus/app/MainActivity.kt`)
- Remote screen → IR code sets: reads scan values (evidence: `app/src/main/java/com/ctremoteplus/app/MainActivity.kt`)
- Code scanner → IR transmitter: tests raw codes (evidence: `app/src/main/java/com/ctremoteplus/app/ir/IrScanner.kt`)
- IR transmitter → IR encoders: encodes signals (evidence: `app/src/main/java/com/ctremoteplus/app/ir/IrController.kt`)
- IR transmitter → IR emitter: transmits IR (evidence: `app/src/main/java/com/ctremoteplus/app/ir/IrController.kt`)
- LG controller → Television: controls WebSocket
- Samsung controller → Television: controls WebSocket
- Android TV controller → Television: sends key events
- Wake-on-LAN → Television: sends wake packet
