# marufallammahim/rgb-remote architecture

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

- Interactive diagram: https://gitdiagram.com/marufallammahim/rgb-remote
- Repository: https://github.com/marufallammahim/rgb-remote

## Overview

RGB-LED-REMOTE is an Android Flutter app for controlling compatible RGB LED devices over infrared. A user selects a remote command or preset; Flutter sends a request through the MethodChannel to Kotlin, which validates and queues IR transmission to the phone emitter. Separate settings and Android home-screen/Device Controls integrations extend the app. The README documents the main workflow; source excerpts show the native queue and smart-control paths. Unexcerpted Dart implementations are represented by their tree paths, so internal Dart call relationships are omitted where not evidenced.

Main entry points: [`lib/presentation/screens/components/remote_ui.dart`](https://github.com/marufallammahim/rgb-remote/blob/main/lib/presentation/screens/components/remote_ui.dart) (Remote controls), [`android/app/src/main/kotlin/com/marufallammahim/rgbremote/MainActivity.kt`](https://github.com/marufallammahim/rgb-remote/blob/main/android/app/src/main/kotlin/com/marufallammahim/rgbremote/MainActivity.kt) (Native channel handler), [`android/app/src/main/kotlin/com/marufallammahim/rgbremote/IrTransmissionEngine.kt`](https://github.com/marufallammahim/rgb-remote/blob/main/android/app/src/main/kotlin/com/marufallammahim/rgbremote/IrTransmissionEngine.kt) (IR transmission queue), [`android/app/src/main/kotlin/com/marufallammahim/rgbremote/SmartControlsProviderService.kt`](https://github.com/marufallammahim/rgb-remote/blob/main/android/app/src/main/kotlin/com/marufallammahim/rgbremote/SmartControlsProviderService.kt) (Android Device Controls)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_flutter["Flutter app"]
  node_remote_screen["Remote screen<br/>[remote_screen.dart]"]
  node_remote_controls["Remote controls<br/>[remote_ui.dart]"]
  node_remote_button["Remote button<br/>[remote_button.dart]"]
  node_presets["IR presets<br/>[pronto_data.dart]"]
  node_preset_one["Preset one"]
  node_preset_two["Preset two"]
  node_ir_plugin["IR platform bridge"]
end

subgraph group_settings["Settings and data"]
  node_settings_screen["Settings screen"]
  node_settings_service["Settings service"]
  node_settings_repository["Settings repository"]
  node_settings_source["Settings data source"]
  node_settings_entity["App settings<br/>[app_settings.dart]"]
end

subgraph group_native["Android IR runtime"]
  node_native_activity["Native channel handler<br/>[MainActivity.kt]"]
  node_ir_engine["IR transmission queue"]
  node_sound_feedback["Sound and vibration<br/>[MainActivity.kt]"]
end

subgraph group_smart["Android smart controls"]
  node_smart_preferences[("Smart command storage")]
  node_home_widgets["Home-screen widgets"]
  node_widget_provider["Basic widget"]
  node_widget_receiver["Widget action receiver"]
  node_device_controls["Android Device Controls"]
end

node_user(("App user"))
node_ir_emitter{{"Phone IR emitter"}}

node_user -->|"selects command"| node_remote_screen
node_remote_screen -.->|"shows controls"| node_remote_controls
node_remote_controls -.->|"offers buttons"| node_remote_button
node_remote_controls -->|"selects preset"| node_presets
node_presets -.->|"includes"| node_preset_one
node_presets -.->|"includes"| node_preset_two
node_remote_controls -->|"requests transmission"| node_ir_plugin
node_ir_plugin -->|"calls MethodChannel"| node_native_activity
node_native_activity -->|"queues transmission"| node_ir_engine
node_ir_engine -->|"transmits signal"| node_ir_emitter
node_native_activity -->|"provides feedback"| node_sound_feedback
node_user -.->|"changes preferences"| node_settings_screen
node_settings_screen -.->|"uses settings"| node_settings_service
node_settings_service -.->|"delegates settings"| node_settings_repository
node_settings_repository -.->|"accesses data"| node_settings_source
node_settings_repository -.->|"handles settings"| node_settings_entity
node_home_widgets -->|"dispatches actions"| node_widget_receiver
node_widget_provider -.->|"uses widget binder"| node_home_widgets
node_widget_receiver -->|"reads command"| node_smart_preferences
node_widget_receiver -->|"submits transmission"| node_ir_engine
node_device_controls -->|"reads command"| node_smart_preferences
node_device_controls -->|"submits transmission"| node_ir_engine
node_device_controls -->|"opens app"| node_native_activity

click node_remote_screen "https://github.com/marufallammahim/rgb-remote/blob/main/lib/presentation/screens/remote_screen.dart"
click node_remote_controls "https://github.com/marufallammahim/rgb-remote/blob/main/lib/presentation/screens/components/remote_ui.dart"
click node_remote_button "https://github.com/marufallammahim/rgb-remote/blob/main/lib/presentation/widgets/remote_button.dart"
click node_presets "https://github.com/marufallammahim/rgb-remote/blob/main/lib/resources/pronto_data.dart"
click node_preset_one "https://github.com/marufallammahim/rgb-remote/blob/main/lib/resources/pronto_data_type1.dart"
click node_preset_two "https://github.com/marufallammahim/rgb-remote/blob/main/lib/resources/pronto_data_type2.dart"
click node_ir_plugin "https://github.com/marufallammahim/rgb-remote/blob/main/lib/plugins/ir_sensor_plugin.dart"
click node_settings_screen "https://github.com/marufallammahim/rgb-remote/blob/main/lib/presentation/screens/settings_screen.dart"
click node_settings_service "https://github.com/marufallammahim/rgb-remote/blob/main/lib/application/services/settings_service.dart"
click node_settings_repository "https://github.com/marufallammahim/rgb-remote/blob/main/lib/data/repositories/settings_repository_impl.dart"
click node_settings_source "https://github.com/marufallammahim/rgb-remote/blob/main/lib/data/datasources/settings_data_source.dart"
click node_settings_entity "https://github.com/marufallammahim/rgb-remote/blob/main/lib/domain/entities/app_settings.dart"
click node_native_activity "https://github.com/marufallammahim/rgb-remote/blob/main/android/app/src/main/kotlin/com/marufallammahim/rgbremote/MainActivity.kt"
click node_ir_engine "https://github.com/marufallammahim/rgb-remote/blob/main/android/app/src/main/kotlin/com/marufallammahim/rgbremote/IrTransmissionEngine.kt"
click node_sound_feedback "https://github.com/marufallammahim/rgb-remote/blob/main/android/app/src/main/kotlin/com/marufallammahim/rgbremote/MainActivity.kt"
click node_smart_preferences "https://github.com/marufallammahim/rgb-remote/blob/main/android/app/src/main/kotlin/com/marufallammahim/rgbremote/SmartControlPreferences.kt"
click node_home_widgets "https://github.com/marufallammahim/rgb-remote/blob/main/android/app/src/main/kotlin/com/marufallammahim/rgbremote/SmartHomeWidgetProviders.kt"
click node_widget_provider "https://github.com/marufallammahim/rgb-remote/blob/main/android/app/src/main/kotlin/com/marufallammahim/rgbremote/SmartControlWidgetProvider.kt"
click node_widget_receiver "https://github.com/marufallammahim/rgb-remote/blob/main/android/app/src/main/kotlin/com/marufallammahim/rgbremote/SmartControlReceiver.kt"
click node_device_controls "https://github.com/marufallammahim/rgb-remote/blob/main/android/app/src/main/kotlin/com/marufallammahim/rgbremote/SmartControlsProviderService.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_remote_screen,node_remote_controls,node_remote_button,node_presets,node_preset_one,node_preset_two,node_ir_plugin,node_user toneBlue
class node_settings_screen,node_settings_service,node_settings_repository,node_settings_source,node_settings_entity toneAmber
class node_native_activity,node_ir_engine,node_sound_feedback toneMint
class node_smart_preferences,node_home_widgets,node_widget_provider,node_widget_receiver,node_device_controls toneRose
class node_ir_emitter toneIndigo
```

## Components

### Flutter app

- [Remote screen](https://github.com/marufallammahim/rgb-remote/blob/main/lib/presentation/screens/remote_screen.dart): `lib/presentation/screens/remote_screen.dart`
- [Remote controls](https://github.com/marufallammahim/rgb-remote/blob/main/lib/presentation/screens/components/remote_ui.dart): `lib/presentation/screens/components/remote_ui.dart`
- [Remote button](https://github.com/marufallammahim/rgb-remote/blob/main/lib/presentation/widgets/remote_button.dart): `lib/presentation/widgets/remote_button.dart`
- [IR presets](https://github.com/marufallammahim/rgb-remote/blob/main/lib/resources/pronto_data.dart): `lib/resources/pronto_data.dart`
- [Preset one](https://github.com/marufallammahim/rgb-remote/blob/main/lib/resources/pronto_data_type1.dart): `lib/resources/pronto_data_type1.dart`
- [Preset two](https://github.com/marufallammahim/rgb-remote/blob/main/lib/resources/pronto_data_type2.dart): `lib/resources/pronto_data_type2.dart`
- [IR platform bridge](https://github.com/marufallammahim/rgb-remote/blob/main/lib/plugins/ir_sensor_plugin.dart): `lib/plugins/ir_sensor_plugin.dart`

### Settings and data

- [Settings screen](https://github.com/marufallammahim/rgb-remote/blob/main/lib/presentation/screens/settings_screen.dart): `lib/presentation/screens/settings_screen.dart`
- [Settings service](https://github.com/marufallammahim/rgb-remote/blob/main/lib/application/services/settings_service.dart): `lib/application/services/settings_service.dart`
- [Settings repository](https://github.com/marufallammahim/rgb-remote/blob/main/lib/data/repositories/settings_repository_impl.dart): `lib/data/repositories/settings_repository_impl.dart`
- [Settings data source](https://github.com/marufallammahim/rgb-remote/blob/main/lib/data/datasources/settings_data_source.dart): `lib/data/datasources/settings_data_source.dart`
- [App settings](https://github.com/marufallammahim/rgb-remote/blob/main/lib/domain/entities/app_settings.dart): `lib/domain/entities/app_settings.dart`

### Android IR runtime

- [Native channel handler](https://github.com/marufallammahim/rgb-remote/blob/main/android/app/src/main/kotlin/com/marufallammahim/rgbremote/MainActivity.kt): `android/app/src/main/kotlin/com/marufallammahim/rgbremote/MainActivity.kt`
- [IR transmission queue](https://github.com/marufallammahim/rgb-remote/blob/main/android/app/src/main/kotlin/com/marufallammahim/rgbremote/IrTransmissionEngine.kt): `android/app/src/main/kotlin/com/marufallammahim/rgbremote/IrTransmissionEngine.kt`
- [Sound and vibration](https://github.com/marufallammahim/rgb-remote/blob/main/android/app/src/main/kotlin/com/marufallammahim/rgbremote/MainActivity.kt): `android/app/src/main/kotlin/com/marufallammahim/rgbremote/MainActivity.kt`

### Android smart controls

- [Smart command storage](https://github.com/marufallammahim/rgb-remote/blob/main/android/app/src/main/kotlin/com/marufallammahim/rgbremote/SmartControlPreferences.kt): `android/app/src/main/kotlin/com/marufallammahim/rgbremote/SmartControlPreferences.kt`
- [Home-screen widgets](https://github.com/marufallammahim/rgb-remote/blob/main/android/app/src/main/kotlin/com/marufallammahim/rgbremote/SmartHomeWidgetProviders.kt): `android/app/src/main/kotlin/com/marufallammahim/rgbremote/SmartHomeWidgetProviders.kt`
- [Basic widget](https://github.com/marufallammahim/rgb-remote/blob/main/android/app/src/main/kotlin/com/marufallammahim/rgbremote/SmartControlWidgetProvider.kt): `android/app/src/main/kotlin/com/marufallammahim/rgbremote/SmartControlWidgetProvider.kt`
- [Widget action receiver](https://github.com/marufallammahim/rgb-remote/blob/main/android/app/src/main/kotlin/com/marufallammahim/rgbremote/SmartControlReceiver.kt): `android/app/src/main/kotlin/com/marufallammahim/rgbremote/SmartControlReceiver.kt`
- [Android Device Controls](https://github.com/marufallammahim/rgb-remote/blob/main/android/app/src/main/kotlin/com/marufallammahim/rgbremote/SmartControlsProviderService.kt): `android/app/src/main/kotlin/com/marufallammahim/rgbremote/SmartControlsProviderService.kt`

### Other components

- **App user**
- **Phone IR emitter**

## Connections

- App user → Remote screen: selects command (evidence: `README.md`)
- Remote screen → Remote controls: shows controls
- Remote controls → Remote button: offers buttons
- Remote controls → IR presets: selects preset (evidence: `README.md`)
- IR presets → Preset one: includes
- IR presets → Preset two: includes
- Remote controls → IR platform bridge: requests transmission (evidence: `README.md`)
- IR platform bridge → Native channel handler: calls MethodChannel (evidence: `README.md`)
- Native channel handler → IR transmission queue: queues transmission (evidence: `android/app/src/main/kotlin/com/marufallammahim/rgbremote/MainActivity.kt`)
- IR transmission queue → Phone IR emitter: transmits signal (evidence: `android/app/src/main/kotlin/com/marufallammahim/rgbremote/IrTransmissionEngine.kt`)
- Native channel handler → Sound and vibration: provides feedback (evidence: `android/app/src/main/kotlin/com/marufallammahim/rgbremote/MainActivity.kt`)
- App user → Settings screen: changes preferences
- Settings screen → Settings service: uses settings
- Settings service → Settings repository: delegates settings
- Settings repository → Settings data source: accesses data
- Settings repository → App settings: handles settings
- Home-screen widgets → Widget action receiver: dispatches actions (evidence: `android/app/src/main/kotlin/com/marufallammahim/rgbremote/SmartHomeWidgetProviders.kt`)
- Basic widget → Home-screen widgets: uses widget binder
- Widget action receiver → Smart command storage: reads command (evidence: `android/app/src/main/kotlin/com/marufallammahim/rgbremote/SmartControlReceiver.kt`)
- Widget action receiver → IR transmission queue: submits transmission (evidence: `android/app/src/main/kotlin/com/marufallammahim/rgbremote/SmartControlReceiver.kt`)
- Android Device Controls → Smart command storage: reads command (evidence: `android/app/src/main/kotlin/com/marufallammahim/rgbremote/SmartControlsProviderService.kt`)
- Android Device Controls → IR transmission queue: submits transmission (evidence: `android/app/src/main/kotlin/com/marufallammahim/rgbremote/SmartControlsProviderService.kt`)
- Android Device Controls → Native channel handler: opens app (evidence: `android/app/src/main/kotlin/com/marufallammahim/rgbremote/SmartControlsProviderService.kt`)
