# ferdinp/aetheris-ram architecture

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

- Interactive diagram: https://gitdiagram.com/ferdinp/aetheris-ram
- Repository: https://github.com/ferdinp/aetheris-ram

## Overview

Aetheris is an Electron desktop client for managing Roblox accounts and related activity. The visible workflow begins in the React application, reaches desktop-facing functionality through the main process, and uses Roblox services for account and platform operations; persistent configuration is handled separately. The tree also shows substantial avatar, game, installation, watcher, and other feature areas, which are represented as product capabilities. Some wiring is not shown in the excerpts, so the graph omits those connections rather than assuming a conventional IPC or initialization flow.

Main entry points: [`src/main/modules/core/RobloxController.ts`](https://github.com/ferdinp/aetheris-ram/blob/main/src/main/modules/core/RobloxController.ts) (Roblox handlers), [`src/main/modules/games/GameController.ts`](https://github.com/ferdinp/aetheris-ram/blob/main/src/main/modules/games/GameController.ts) (Game handlers), [`src/main/modules/system/StorageService.ts`](https://github.com/ferdinp/aetheris-ram/blob/main/src/main/modules/system/StorageService.ts) (Local configuration), [`src/main/modules/avatar/AvatarController.ts`](https://github.com/ferdinp/aetheris-ram/blob/main/src/main/modules/avatar/AvatarController.ts) (Avatar handlers)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_desktop["Desktop application"]
  node_app["React application<br/>[App.tsx]"]
  node_preload["Preload bridge<br/>[index.ts]"]
  node_main["Electron main<br/>[index.ts]"]
end

subgraph group_accounts["Accounts and storage"]
  node_authui["Account UI<br/>[AccountsTab.tsx]"]
  node_authcontroller["Authentication"]
  node_cookie["Cookie refresh"]
  node_storagecontroller["Storage handlers"]
  node_storage[("Local configuration<br/>[StorageService.ts]")]
end

subgraph group_roblox["Roblox operations"]
  node_robloxcontroller["Roblox handlers"]
  node_ipcguard["IPC validation<br/>[handle.ts]"]
  node_moderation["Moderation checks<br/>[moderation.ts]"]
end

subgraph group_features["Product capabilities"]
  node_avatarcontroller["Avatar handlers"]
  node_assetservice["Asset operations<br/>[AssetService.ts]"]
  node_gamecontroller["Game handlers<br/>[GameController.ts]"]
  node_gameservice["Game services<br/>[GameService.ts]"]
  node_installcontroller["Install handlers"]
  node_installservice["Install management<br/>[InstallService.ts]"]
  node_launcher["Game launcher<br/>[LauncherService.ts]"]
  node_watcher["Process monitoring<br/>[ProcessMonitor.ts]"]
  node_watchercontroller["Watcher controls"]
  node_updater["Automatic updates<br/>[UpdaterService.ts]"]
  node_browser["Embedded browser<br/>[BrowserService.ts]"]
  node_macro["Macro recording<br/>[MacroService.ts]"]
  node_proxy["Proxy management<br/>[ProxyManager.ts]"]
  node_sniper["Username sniper<br/>[UsernameSniper.ts]"]
end

node_user(("Desktop user"))

node_user -->|"uses"| node_app
node_app -->|"renders"| node_authui
node_robloxcontroller -->|"registers handlers"| node_ipcguard
node_ipcguard -->|"checks moderation"| node_moderation
node_robloxcontroller -->|"uses authentication"| node_authcontroller
node_robloxcontroller -->|"reads accounts"| node_storage
node_storagecontroller -->|"reads and writes"| node_storage
node_avatarcontroller -->|"calls"| node_assetservice
node_avatarcontroller -->|"extracts cookies"| node_authcontroller
node_gamecontroller -->|"calls"| node_gameservice
node_gamecontroller -->|"launches games"| node_launcher
node_gamecontroller -->|"checks processes"| node_watcher
node_installcontroller -->|"manages installations"| node_installservice
node_launcher -->|"uses installations"| node_installservice
node_watchercontroller -->|"controls watcher"| node_watcher
node_cookie -->|"persists preferences"| node_storage

click node_app "https://github.com/ferdinp/aetheris-ram/blob/main/src/renderer/src/App.tsx"
click node_preload "https://github.com/ferdinp/aetheris-ram/blob/main/src/preload/index.ts"
click node_main "https://github.com/ferdinp/aetheris-ram/blob/main/src/main/index.ts"
click node_authui "https://github.com/ferdinp/aetheris-ram/blob/main/src/renderer/src/features/auth/AccountsTab.tsx"
click node_authcontroller "https://github.com/ferdinp/aetheris-ram/blob/main/src/main/modules/auth/RobloxAuthService.ts"
click node_cookie "https://github.com/ferdinp/aetheris-ram/blob/main/src/main/modules/auth/CookieRefreshService.ts"
click node_storagecontroller "https://github.com/ferdinp/aetheris-ram/blob/main/src/main/modules/system/StorageController.ts"
click node_storage "https://github.com/ferdinp/aetheris-ram/blob/main/src/main/modules/system/StorageService.ts"
click node_robloxcontroller "https://github.com/ferdinp/aetheris-ram/blob/main/src/main/modules/core/RobloxController.ts"
click node_ipcguard "https://github.com/ferdinp/aetheris-ram/blob/main/src/main/modules/core/utils/handle.ts"
click node_moderation "https://github.com/ferdinp/aetheris-ram/blob/main/src/main/modules/core/utils/moderation.ts"
click node_avatarcontroller "https://github.com/ferdinp/aetheris-ram/blob/main/src/main/modules/avatar/AvatarController.ts"
click node_assetservice "https://github.com/ferdinp/aetheris-ram/blob/main/src/main/modules/avatar/AssetService.ts"
click node_gamecontroller "https://github.com/ferdinp/aetheris-ram/blob/main/src/main/modules/games/GameController.ts"
click node_gameservice "https://github.com/ferdinp/aetheris-ram/blob/main/src/main/modules/games/GameService.ts"
click node_installcontroller "https://github.com/ferdinp/aetheris-ram/blob/main/src/main/modules/install/InstallController.ts"
click node_installservice "https://github.com/ferdinp/aetheris-ram/blob/main/src/main/modules/install/InstallService.ts"
click node_launcher "https://github.com/ferdinp/aetheris-ram/blob/main/src/main/modules/install/LauncherService.ts"
click node_watcher "https://github.com/ferdinp/aetheris-ram/blob/main/src/main/modules/watcher/ProcessMonitor.ts"
click node_watchercontroller "https://github.com/ferdinp/aetheris-ram/blob/main/src/main/modules/watcher/WatcherController.ts"
click node_updater "https://github.com/ferdinp/aetheris-ram/blob/main/src/main/modules/updater/UpdaterService.ts"
click node_browser "https://github.com/ferdinp/aetheris-ram/blob/main/src/main/modules/browser/services/BrowserService.ts"
click node_macro "https://github.com/ferdinp/aetheris-ram/blob/main/src/main/modules/macro/services/MacroService.ts"
click node_proxy "https://github.com/ferdinp/aetheris-ram/blob/main/src/main/modules/proxy/services/ProxyManager.ts"
click node_sniper "https://github.com/ferdinp/aetheris-ram/blob/main/src/main/modules/sniper/UsernameSniper.ts"

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_app,node_preload,node_main,node_user toneBlue
class node_authui,node_authcontroller,node_cookie,node_storagecontroller,node_storage toneAmber
class node_robloxcontroller,node_ipcguard,node_moderation toneMint
class node_avatarcontroller,node_assetservice,node_gamecontroller,node_gameservice,node_installcontroller,node_installservice,node_launcher,node_watcher,node_watchercontroller,node_updater,node_browser,node_macro,node_proxy,node_sniper toneRose
```

## Components

### Desktop application

- [React application](https://github.com/ferdinp/aetheris-ram/blob/main/src/renderer/src/App.tsx): `src/renderer/src/App.tsx`
- [Preload bridge](https://github.com/ferdinp/aetheris-ram/blob/main/src/preload/index.ts): `src/preload/index.ts`
- [Electron main](https://github.com/ferdinp/aetheris-ram/blob/main/src/main/index.ts): `src/main/index.ts`

### Accounts and storage

- [Account UI](https://github.com/ferdinp/aetheris-ram/blob/main/src/renderer/src/features/auth/AccountsTab.tsx): `src/renderer/src/features/auth/AccountsTab.tsx`
- [Authentication](https://github.com/ferdinp/aetheris-ram/blob/main/src/main/modules/auth/RobloxAuthService.ts): `src/main/modules/auth/RobloxAuthService.ts`
- [Cookie refresh](https://github.com/ferdinp/aetheris-ram/blob/main/src/main/modules/auth/CookieRefreshService.ts): `src/main/modules/auth/CookieRefreshService.ts`
- [Storage handlers](https://github.com/ferdinp/aetheris-ram/blob/main/src/main/modules/system/StorageController.ts): `src/main/modules/system/StorageController.ts`
- [Local configuration](https://github.com/ferdinp/aetheris-ram/blob/main/src/main/modules/system/StorageService.ts): `src/main/modules/system/StorageService.ts`

### Roblox operations

- [Roblox handlers](https://github.com/ferdinp/aetheris-ram/blob/main/src/main/modules/core/RobloxController.ts): `src/main/modules/core/RobloxController.ts`
- [IPC validation](https://github.com/ferdinp/aetheris-ram/blob/main/src/main/modules/core/utils/handle.ts): `src/main/modules/core/utils/handle.ts`
- [Moderation checks](https://github.com/ferdinp/aetheris-ram/blob/main/src/main/modules/core/utils/moderation.ts): `src/main/modules/core/utils/moderation.ts`

### Product capabilities

- [Avatar handlers](https://github.com/ferdinp/aetheris-ram/blob/main/src/main/modules/avatar/AvatarController.ts): `src/main/modules/avatar/AvatarController.ts`
- [Asset operations](https://github.com/ferdinp/aetheris-ram/blob/main/src/main/modules/avatar/AssetService.ts): `src/main/modules/avatar/AssetService.ts`
- [Game handlers](https://github.com/ferdinp/aetheris-ram/blob/main/src/main/modules/games/GameController.ts): `src/main/modules/games/GameController.ts`
- [Game services](https://github.com/ferdinp/aetheris-ram/blob/main/src/main/modules/games/GameService.ts): `src/main/modules/games/GameService.ts`
- [Install handlers](https://github.com/ferdinp/aetheris-ram/blob/main/src/main/modules/install/InstallController.ts): `src/main/modules/install/InstallController.ts`
- [Install management](https://github.com/ferdinp/aetheris-ram/blob/main/src/main/modules/install/InstallService.ts): `src/main/modules/install/InstallService.ts`
- [Game launcher](https://github.com/ferdinp/aetheris-ram/blob/main/src/main/modules/install/LauncherService.ts): `src/main/modules/install/LauncherService.ts`
- [Process monitoring](https://github.com/ferdinp/aetheris-ram/blob/main/src/main/modules/watcher/ProcessMonitor.ts): `src/main/modules/watcher/ProcessMonitor.ts`
- [Watcher controls](https://github.com/ferdinp/aetheris-ram/blob/main/src/main/modules/watcher/WatcherController.ts): `src/main/modules/watcher/WatcherController.ts`
- [Automatic updates](https://github.com/ferdinp/aetheris-ram/blob/main/src/main/modules/updater/UpdaterService.ts): `src/main/modules/updater/UpdaterService.ts`
- [Embedded browser](https://github.com/ferdinp/aetheris-ram/blob/main/src/main/modules/browser/services/BrowserService.ts): `src/main/modules/browser/services/BrowserService.ts`
- [Macro recording](https://github.com/ferdinp/aetheris-ram/blob/main/src/main/modules/macro/services/MacroService.ts): `src/main/modules/macro/services/MacroService.ts`
- [Proxy management](https://github.com/ferdinp/aetheris-ram/blob/main/src/main/modules/proxy/services/ProxyManager.ts): `src/main/modules/proxy/services/ProxyManager.ts`
- [Username sniper](https://github.com/ferdinp/aetheris-ram/blob/main/src/main/modules/sniper/UsernameSniper.ts): `src/main/modules/sniper/UsernameSniper.ts`

### Other components

- **Desktop user**

## Connections

- Desktop user → React application: uses (evidence: `README.md`)
- React application → Account UI: renders (evidence: `src/renderer/src/App.tsx`)
- Roblox handlers → IPC validation: registers handlers (evidence: `src/main/modules/core/RobloxController.ts`)
- IPC validation → Moderation checks: checks moderation (evidence: `src/main/modules/core/utils/handle.ts`)
- Roblox handlers → Authentication: uses authentication (evidence: `src/main/modules/core/RobloxController.ts`)
- Roblox handlers → Local configuration: reads accounts (evidence: `src/main/modules/core/RobloxController.ts`)
- Storage handlers → Local configuration: reads and writes (evidence: `src/main/modules/system/StorageController.ts`)
- Avatar handlers → Asset operations: calls (evidence: `src/main/modules/avatar/AvatarController.ts`)
- Avatar handlers → Authentication: extracts cookies (evidence: `src/main/modules/avatar/AvatarController.ts`)
- Game handlers → Game services: calls (evidence: `src/main/modules/games/GameController.ts`)
- Game handlers → Game launcher: launches games (evidence: `src/main/modules/games/GameController.ts`)
- Game handlers → Process monitoring: checks processes (evidence: `src/main/modules/games/GameController.ts`)
- Install handlers → Install management: manages installations (evidence: `src/main/modules/install/InstallController.ts`)
- Game launcher → Install management: uses installations (evidence: `src/main/modules/install/LauncherService.ts`)
- Watcher controls → Process monitoring: controls watcher (evidence: `src/main/modules/watcher/WatcherController.ts`)
- Cookie refresh → Local configuration: persists preferences
