Components

Auriya is three runtime planes plus shared code. This page names each component, where it lives, and what it owns. For how they interact at runtime see Data flow; for the whole-system flow see Architecture overview.

Android manager — `android/app/`

The user-facing app (package dev.auriya.app). Renders the Compose UI, persists appearance/onboarding preferences, requests root, edits settings.toml / gamelist.toml, and displays live daemon status. It is a client of the daemon over the Unix socket — it does not itself apply tweaks. Installed by customize.sh via pm install (Installation).

Companion service — `android/service/`

A headless service (process AuriyaSysMon, launched via app_process, package identity dev.auriya.service). It bridges Android-only capabilities the root daemon cannot reach:

Sensors → writes the foreground app/PID, screen state, battery-saver, and Zen/DnD state to /data/adb/.config/auriya/system_status.
Actuators → replays daemon-requested DnD and refresh-rate changes through Android framework APIs, driven by the auriya_cmd file (System tweaks → CmdWriter).

Its liveness is tracked via companion.lock (see Architecture overview). Full internals — sensors, actuators, atomic file IO — are documented in Companion service.

Shared Kotlin — `android/shared/`

Models and codecs used by both the app and the companion: the Settings / GameProfile / SystemStatus data classes, the TOML parser/serializer (TomlParser.kt), and the command/status wire formats. This is where the app’s view of settings.toml is defined — and why config keys must stay in sync between here and the Rust Settings struct (settings reference).

Rust daemon — `src/main.rs` + `src/daemon/` + `src/core/`

The long-running root process (binary auriya). Loads config, runs the event/tick loop, serves the IPC socket, observes foreground/FPS/telemetry, selects a profile, and applies tweaks. Two binary targets are declared in Cargo.toml:

Binary	Entry	Role
`auriya`	`src/main.rs`	The daemon.
`auriyactl`	`src/ctl.rs`	The control CLI.

Core subsystems (src/core/): config/ (settings + game profiles), system_status/ (companion snapshot cache), pid_tracker.rs (foreground liveness), fps_meter/ (FPS telemetry), fas/ + daemon/fas.rs (frame-aware scheduling), telemetry/ (CPU/GPU/thermal), tweaks/ (kernel writes), cmd_writer/ (companion command file), display.rs (supported modes).

Control CLI — `src/ctl.rs` + `src/cli/`

auriyactl — a line-oriented client for the same Unix socket (Command reference). As of this revision it is a secondary control surface; the app is primary.

Kernel/device boundary — `src/core/tweaks/`, telemetry, eBPF

Best-effort reads and guarded writes to vendor-dependent /proc and /sys nodes, plus the eBPF frame probe. Missing nodes are skipped (System tweaks).

Architecture tree

flowchart TD
    root["Auriya Root Architecture"]
    
    subgraph android_plane ["Android Plane (android/)"]
        app["Manager App (android/app)<br/>Compose UI, root cmds, overlay"]
        comp["Companion Service (android/service)<br/>Sensors & actuators (app_process)"]
        shared["Shared Module (android/shared)<br/>Models, TOML parser, types"]
    end

    subgraph rust_plane ["Rust Plane (src/)"]
        daemon["auriya Daemon (src/main.rs, src/daemon, src/core)<br/>Event loop, watchers, scheduler"]
        fas["FAS & FPS Meter (src/core/fas, fps_meter)<br/>eBPF frame pacing & scaling"]
        tweaks["System Tweaks (src/core/tweaks)<br/>Governors, frequencies, memory, vendor"]
        ctl["auriyactl (src/ctl.rs, src/cli)<br/>Unix domain socket CLI client"]
    end

    subgraph module_plane ["Module Plane (module/)"]
        scripts["Root Lifecycle Scripts<br/>customize.sh, service.sh, uninstall.sh"]
    end

    subgraph doc_plane ["Documentation Plane (website/)"]
        wiki["Docusaurus Technical Wiki"]
    end

    root --> android_plane
    root --> rust_plane
    root --> module_plane
    root --> doc_plane

    daemon --> fas
    daemon --> tweaks

For the exact source-tree layout of files on disk, see Project structure.

Components

Android manager — android/app/

Companion service — android/service/

Shared Kotlin — android/shared/

Rust daemon — src/main.rs + src/daemon/ + src/core/

Control CLI — src/ctl.rs + src/cli/

Kernel/device boundary — src/core/tweaks/, telemetry, eBPF