# aubree-lat/macoblox architecture

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

- Interactive diagram: https://gitdiagram.com/aubree-lat/macoblox
- Repository: https://github.com/aubree-lat/macoblox

## Overview

Mac O’ Blox launches the macOS Roblox client on Linux through Darling, with a GTK launcher for setup, configuration, updates, and runtime control. The principal path is user → launcher → Roblox under Darling; the launcher also configures graphics, GPU, display, DNS, and mods, while the compatibility shim supplies host-facing behavior such as graphics and audio support. Studio, embedded web sign-in, and Discord presence are distinct capabilities. Source excerpts and the index establish several Python module references; broader shim and runtime relationships are shown only where documented in the README.

Main entry points: [`launcher/macoblox/app.py`](https://github.com/aubree-lat/macoblox/blob/main/launcher/macoblox/app.py) (Launcher UI), [`launcher/macoblox/core.py`](https://github.com/aubree-lat/macoblox/blob/main/launcher/macoblox/core.py) (Client Backend), [`launcher/macoblox/graphics.py`](https://github.com/aubree-lat/macoblox/blob/main/launcher/macoblox/graphics.py) (Renderer Setup), [`launcher/macoblox/display.py`](https://github.com/aubree-lat/macoblox/blob/main/launcher/macoblox/display.py) (Display Backend)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_launcher["Launcher"]
  node_app["Launcher UI<br/>[app.py]"]
  node_core["Client Backend<br/>[core.py]"]
  node_setup["First-run Setup<br/>[setup.py]"]
  node_studio["Studio Support<br/>[studio.py]"]
  node_mods["Mods and Flags<br/>[mods.py]"]
  node_i18n["Localization<br/>[i18n.py]"]
  node_discord["Discord Presence<br/>[discord.py]"]
  node_web["Embedded Web<br/>[web.py]"]
end

subgraph group_runtime["Client Runtime"]
  node_darling["Darling Runtime"]
  node_roblox["Roblox Client"]
end

subgraph group_compat["Compatibility Shim"]
  node_shim["Darling Fixups<br/>[darling_fixes.c]"]
  node_audio["Audio Bridge<br/>[audio_hal.c]"]
  node_graphics_context["GL Context Bridge<br/>[graphics_context.c]"]
  node_dns_shim["DNS Override<br/>[dns_override.c]"]
  node_wayland["Wayland Host<br/>[wayland_host.cpp]"]
end

subgraph group_integrations["Host Integrations"]
  node_dns["Roblox DNS<br/>[dns.py]"]
  node_graphics["Renderer Setup<br/>[graphics.py]"]
  node_gpus["GPU Selection<br/>[gpus.py]"]
  node_display["Display Backend<br/>[display.py]"]
end

node_user(("Player"))
node_mangohud["MangoHud"]
node_discord_service["Discord"]
node_dns_service["DNS Provider"]
node_webkit["WebKitGTK"]

node_user -->|"operates"| node_app
node_app -->|"uses backend"| node_core
node_app -->|"opens setup"| node_setup
node_app -->|"uses Studio"| node_studio
node_app -->|"uses flags"| node_mods
node_app -->|"translates UI"| node_i18n
node_app -->|"uses presence"| node_discord
node_app -->|"opens web bridge"| node_web
node_app -->|"configures DNS"| node_dns
node_app -->|"configures renderer"| node_graphics
node_app -->|"selects GPU"| node_gpus
node_app -->|"selects display"| node_display
node_core -->|"uses mods"| node_mods
node_core -->|"uses DNS"| node_dns
node_core -->|"validates renderer"| node_graphics
node_core -->|"uses GPU config"| node_gpus
node_core -->|"uses display config"| node_display
node_core -->|"starts client in"| node_darling
node_darling -->|"runs"| node_roblox
node_darling -.->|"loads compatibility"| node_shim
node_roblox -.->|"uses audio"| node_audio
node_roblox -.->|"uses graphics"| node_graphics_context
node_roblox -.->|"uses Roblox DNS"| node_dns_shim
node_core -->|"forwards Roblox lookups"| node_dns_service
node_core -->|"forwards overlay settings"| node_mangohud
node_web -->|"renders embedded pages"| node_webkit
node_discord -.->|"updates status"| node_discord_service
node_graphics -->|"configures overlay"| node_mangohud
node_display -->|"loads Wayland helper"| node_wayland

click node_app "https://github.com/aubree-lat/macoblox/blob/main/launcher/macoblox/app.py"
click node_core "https://github.com/aubree-lat/macoblox/blob/main/launcher/macoblox/core.py"
click node_setup "https://github.com/aubree-lat/macoblox/blob/main/launcher/macoblox/setup.py"
click node_studio "https://github.com/aubree-lat/macoblox/blob/main/launcher/macoblox/studio.py"
click node_mods "https://github.com/aubree-lat/macoblox/blob/main/launcher/macoblox/mods.py"
click node_i18n "https://github.com/aubree-lat/macoblox/blob/main/launcher/macoblox/i18n.py"
click node_discord "https://github.com/aubree-lat/macoblox/blob/main/launcher/macoblox/discord.py"
click node_web "https://github.com/aubree-lat/macoblox/blob/main/launcher/macoblox/web.py"
click node_dns "https://github.com/aubree-lat/macoblox/blob/main/launcher/macoblox/dns.py"
click node_graphics "https://github.com/aubree-lat/macoblox/blob/main/launcher/macoblox/graphics.py"
click node_gpus "https://github.com/aubree-lat/macoblox/blob/main/launcher/macoblox/gpus.py"
click node_display "https://github.com/aubree-lat/macoblox/blob/main/launcher/macoblox/display.py"
click node_shim "https://github.com/aubree-lat/macoblox/blob/main/darling_fixes.c"
click node_audio "https://github.com/aubree-lat/macoblox/blob/main/audio_hal.c"
click node_graphics_context "https://github.com/aubree-lat/macoblox/blob/main/graphics_context.c"
click node_dns_shim "https://github.com/aubree-lat/macoblox/blob/main/dns_override.c"
click node_wayland "https://github.com/aubree-lat/macoblox/blob/main/wayland_host.cpp"

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_core,node_setup,node_studio,node_mods,node_i18n,node_discord,node_web toneBlue
class node_darling,node_roblox toneAmber
class node_shim,node_audio,node_graphics_context,node_dns_shim,node_wayland toneMint
class node_dns,node_graphics,node_gpus,node_display toneRose
class node_user,node_mangohud,node_discord_service,node_dns_service,node_webkit toneIndigo
```

## Components

### Launcher

- [Launcher UI](https://github.com/aubree-lat/macoblox/blob/main/launcher/macoblox/app.py): `launcher/macoblox/app.py`
- [Client Backend](https://github.com/aubree-lat/macoblox/blob/main/launcher/macoblox/core.py): `launcher/macoblox/core.py`
- [First-run Setup](https://github.com/aubree-lat/macoblox/blob/main/launcher/macoblox/setup.py): `launcher/macoblox/setup.py`
- [Studio Support](https://github.com/aubree-lat/macoblox/blob/main/launcher/macoblox/studio.py): `launcher/macoblox/studio.py`
- [Mods and Flags](https://github.com/aubree-lat/macoblox/blob/main/launcher/macoblox/mods.py): `launcher/macoblox/mods.py`
- [Localization](https://github.com/aubree-lat/macoblox/blob/main/launcher/macoblox/i18n.py): `launcher/macoblox/i18n.py`
- [Discord Presence](https://github.com/aubree-lat/macoblox/blob/main/launcher/macoblox/discord.py): `launcher/macoblox/discord.py`
- [Embedded Web](https://github.com/aubree-lat/macoblox/blob/main/launcher/macoblox/web.py): `launcher/macoblox/web.py`

### Client Runtime

- **Darling Runtime**
- **Roblox Client**

### Compatibility Shim

- [Darling Fixups](https://github.com/aubree-lat/macoblox/blob/main/darling_fixes.c): `darling_fixes.c`
- [Audio Bridge](https://github.com/aubree-lat/macoblox/blob/main/audio_hal.c): `audio_hal.c`
- [GL Context Bridge](https://github.com/aubree-lat/macoblox/blob/main/graphics_context.c): `graphics_context.c`
- [DNS Override](https://github.com/aubree-lat/macoblox/blob/main/dns_override.c): `dns_override.c`
- [Wayland Host](https://github.com/aubree-lat/macoblox/blob/main/wayland_host.cpp): `wayland_host.cpp`

### Host Integrations

- [Roblox DNS](https://github.com/aubree-lat/macoblox/blob/main/launcher/macoblox/dns.py): `launcher/macoblox/dns.py`
- [Renderer Setup](https://github.com/aubree-lat/macoblox/blob/main/launcher/macoblox/graphics.py): `launcher/macoblox/graphics.py`
- [GPU Selection](https://github.com/aubree-lat/macoblox/blob/main/launcher/macoblox/gpus.py): `launcher/macoblox/gpus.py`
- [Display Backend](https://github.com/aubree-lat/macoblox/blob/main/launcher/macoblox/display.py): `launcher/macoblox/display.py`

### Other components

- **Player**
- **MangoHud**
- **Discord**
- **DNS Provider**
- **WebKitGTK**

## Connections

- Player → Launcher UI: operates (evidence: `README.md`)
- Launcher UI → Client Backend: uses backend (evidence: `launcher/macoblox/app.py`)
- Launcher UI → First-run Setup: opens setup (evidence: `launcher/macoblox/app.py`)
- Launcher UI → Studio Support: uses Studio (evidence: `launcher/macoblox/app.py`)
- Launcher UI → Mods and Flags: uses flags (evidence: `launcher/macoblox/app.py`)
- Launcher UI → Localization: translates UI (evidence: `launcher/macoblox/app.py`)
- Launcher UI → Discord Presence: uses presence (evidence: `launcher/macoblox/app.py`)
- Launcher UI → Embedded Web: opens web bridge (evidence: `launcher/macoblox/app.py`)
- Launcher UI → Roblox DNS: configures DNS (evidence: `launcher/macoblox/app.py`)
- Launcher UI → Renderer Setup: configures renderer (evidence: `launcher/macoblox/app.py`)
- Launcher UI → GPU Selection: selects GPU (evidence: `launcher/macoblox/app.py`)
- Launcher UI → Display Backend: selects display (evidence: `launcher/macoblox/app.py`)
- Client Backend → Mods and Flags: uses mods (evidence: `launcher/macoblox/core.py`)
- Client Backend → Roblox DNS: uses DNS (evidence: `launcher/macoblox/core.py`)
- Client Backend → Renderer Setup: validates renderer (evidence: `launcher/macoblox/core.py`)
- Client Backend → GPU Selection: uses GPU config (evidence: `launcher/macoblox/core.py`)
- Client Backend → Display Backend: uses display config (evidence: `launcher/macoblox/core.py`)
- Client Backend → Darling Runtime: starts client in (evidence: `README.md`)
- Darling Runtime → Roblox Client: runs (evidence: `README.md`)
- Darling Runtime → Darling Fixups: loads compatibility
- Roblox Client → Audio Bridge: uses audio (evidence: `README.md`)
- Roblox Client → GL Context Bridge: uses graphics
- Roblox Client → DNS Override: uses Roblox DNS
- Client Backend → DNS Provider: forwards Roblox lookups
- Client Backend → MangoHud: forwards overlay settings (evidence: `README.md`)
- Embedded Web → WebKitGTK: renders embedded pages (evidence: `launcher/macoblox/web.py`)
- Discord Presence → Discord: updates status (evidence: `README.md`)
- Renderer Setup → MangoHud: configures overlay (evidence: `launcher/macoblox/graphics.py`)
- Display Backend → Wayland Host: loads Wayland helper (evidence: `launcher/macoblox/display.py`)
