# j8-diablo/hcef architecture

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

- Interactive diagram: https://gitdiagram.com/j8-diablo/hcef
- Repository: https://github.com/j8-diablo/hcef

## Overview

HCEF installs a separate CEF host on player request, then lets Horizon mods manage browsers through a local authenticated IPC link. Browser images return through shared memory, while the host captures and mixes browser audio according to scenes from the game. The graph includes the documented install, browser-control, frame-sharing, and audio paths, plus the principal audio-processing layers. Some host and API internals were not excerpted; edges based on the source index or README reflect only the relationships those sources establish.

Main entry points: [`host/src/audio/player.rs`](https://github.com/j8-diablo/hcef/blob/main/host/src/audio/player.rs) (Audio Player), [`native/api/src/ipc/host.rs`](https://github.com/j8-diablo/hcef/blob/main/native/api/src/ipc/host.rs) (Host Lifecycle), [`host/src/browsers.rs`](https://github.com/j8-diablo/hcef/blob/main/host/src/browsers.rs) (Browser Runtime), [`host/src/audio/mixer.rs`](https://github.com/j8-diablo/hcef/blob/main/host/src/audio/mixer.rs) (Audio Mixer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_mod["Horizon Mod API"]
  node_settings["Install Settings<br/>[lib.rs]"]
  node_installer["Host Installer<br/>[install.rs]"]
  node_host_api["Host Lifecycle<br/>[host.rs]"]
  node_browser_set["Browser Set<br/>[browsers.rs]"]
end

subgraph group_protocol["IPC and Media Protocol"]
  node_link["Socket Link<br/>[link.rs]"]
  node_control["Control Protocol<br/>[ctl.rs]"]
  node_mapping["Shared Mapping<br/>[shm.rs]"]
  node_frames["Frame Reader<br/>[frame.rs]"]
  node_audio_wire["Audio Protocol<br/>[audio.rs]"]
  node_wire["Wire Encoding<br/>[wire.rs]"]
end

subgraph group_host["CEF Host"]
  node_host_main["Host Runtime<br/>[main.rs]"]
  node_browser_runtime["Browser Runtime<br/>[browsers.rs]"]
end

subgraph group_audio["Host Audio"]
  node_audio_entry["Audio Capture<br/>[capture.rs]"]
  node_audio_player["Audio Player<br/>[player.rs]"]
  node_mixer["Audio Mixer<br/>[mixer.rs]"]
  node_voice["Voice Processing<br/>[voice.rs]"]
  node_dsp["DSP Primitives<br/>[dsp.rs]"]
  node_limiter["Audio Limiter<br/>[limiter.rs]"]
  node_reverb["Room Reverb<br/>[reverb.rs]"]
  node_audio_output["Audio Output<br/>[output.rs]"]
  node_audio_share["Audio Sharing<br/>[share.rs]"]
  node_audio_ring["Audio Ring Buffer<br/>[ring.rs]"]
  node_audio_place["Audio Placement<br/>[place.rs]"]
  node_audio_wav["WAV Recording<br/>[wav.rs]"]
end

node_player(("Player"))
node_mod_author(("Mod Author"))
node_horizon["Horizon Game"]
node_release["Release Archive"]

node_player -->|"requests install"| node_settings
node_settings -->|"starts download"| node_installer
node_installer -->|"fetches archive"| node_release
node_mod_author -->|"requests browsers"| node_browser_set
node_browser_set -->|"encodes commands"| node_control
node_browser_set -->|"uses host"| node_host_api
node_host_api -->|"manages connection"| node_link
node_host_api -->|"sends commands"| node_control
node_host_api -->|"checks installation"| node_installer
node_horizon -->|"starts host"| node_host_api
node_host_main -->|"connects socket"| node_link
node_host_main -->|"serves commands"| node_browser_runtime
node_browser_runtime -->|"handles messages"| node_control
node_browser_runtime -->|"attaches audio"| node_audio_entry
node_mapping -->|"backs reader"| node_frames
node_browser_runtime -->|"shares pictures"| node_mapping
node_frames -->|"provides pictures"| node_horizon
node_audio_wire -->|"uses encoding"| node_wire
node_control -->|"carries scenes"| node_audio_wire
node_audio_entry -->|"feeds player"| node_audio_player
node_audio_player -->|"mixes blocks"| node_mixer
node_audio_player -->|"reads feeds"| node_audio_share
node_audio_player -->|"reads packets"| node_audio_ring
node_mixer -->|"processes voices"| node_voice
node_mixer -->|"limits mix"| node_limiter
node_mixer -->|"applies reverb"| node_reverb
node_voice -->|"uses filters"| node_dsp
node_voice -->|"positions sound"| node_audio_place
node_limiter -->|"uses primitives"| node_dsp
node_reverb -->|"uses primitives"| node_dsp
node_audio_output -->|"plays mix"| node_audio_player
node_audio_wav -.->|"records mix"| node_audio_player
node_audio_wire -->|"describes scene"| node_audio_player

click node_settings "https://github.com/j8-diablo/hcef/blob/main/native/api/src/lib.rs"
click node_installer "https://github.com/j8-diablo/hcef/blob/main/native/api/src/install.rs"
click node_host_api "https://github.com/j8-diablo/hcef/blob/main/native/api/src/ipc/host.rs"
click node_browser_set "https://github.com/j8-diablo/hcef/blob/main/native/api/src/browsers.rs"
click node_link "https://github.com/j8-diablo/hcef/blob/main/native/api/src/ipc/link.rs"
click node_control "https://github.com/j8-diablo/hcef/blob/main/native/api/src/proto/ctl.rs"
click node_mapping "https://github.com/j8-diablo/hcef/blob/main/native/api/src/ipc/shm.rs"
click node_frames "https://github.com/j8-diablo/hcef/blob/main/native/api/src/proto/frame.rs"
click node_host_main "https://github.com/j8-diablo/hcef/blob/main/host/src/main.rs"
click node_browser_runtime "https://github.com/j8-diablo/hcef/blob/main/host/src/browsers.rs"
click node_audio_entry "https://github.com/j8-diablo/hcef/blob/main/host/src/audio/capture.rs"
click node_audio_player "https://github.com/j8-diablo/hcef/blob/main/host/src/audio/player.rs"
click node_mixer "https://github.com/j8-diablo/hcef/blob/main/host/src/audio/mixer.rs"
click node_voice "https://github.com/j8-diablo/hcef/blob/main/host/src/audio/voice.rs"
click node_dsp "https://github.com/j8-diablo/hcef/blob/main/host/src/audio/dsp.rs"
click node_limiter "https://github.com/j8-diablo/hcef/blob/main/host/src/audio/limiter.rs"
click node_reverb "https://github.com/j8-diablo/hcef/blob/main/host/src/audio/reverb.rs"
click node_audio_output "https://github.com/j8-diablo/hcef/blob/main/host/src/audio/output.rs"
click node_audio_share "https://github.com/j8-diablo/hcef/blob/main/host/src/audio/share.rs"
click node_audio_ring "https://github.com/j8-diablo/hcef/blob/main/host/src/audio/ring.rs"
click node_audio_place "https://github.com/j8-diablo/hcef/blob/main/host/src/audio/place.rs"
click node_audio_wav "https://github.com/j8-diablo/hcef/blob/main/host/src/audio/wav.rs"
click node_audio_wire "https://github.com/j8-diablo/hcef/blob/main/native/api/src/proto/audio.rs"
click node_wire "https://github.com/j8-diablo/hcef/blob/main/native/api/src/proto/wire.rs"

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_settings,node_installer,node_host_api,node_browser_set toneBlue
class node_link,node_control,node_mapping,node_frames,node_audio_wire,node_wire toneAmber
class node_host_main,node_browser_runtime toneMint
class node_audio_entry,node_audio_player,node_mixer,node_voice,node_dsp,node_limiter,node_reverb,node_audio_output,node_audio_share,node_audio_ring,node_audio_place,node_audio_wav toneRose
class node_player,node_mod_author,node_horizon,node_release toneIndigo
```

## Components

### Horizon Mod API

- [Install Settings](https://github.com/j8-diablo/hcef/blob/main/native/api/src/lib.rs): `native/api/src/lib.rs`
- [Host Installer](https://github.com/j8-diablo/hcef/blob/main/native/api/src/install.rs): `native/api/src/install.rs`
- [Host Lifecycle](https://github.com/j8-diablo/hcef/blob/main/native/api/src/ipc/host.rs): `native/api/src/ipc/host.rs`
- [Browser Set](https://github.com/j8-diablo/hcef/blob/main/native/api/src/browsers.rs): `native/api/src/browsers.rs`

### IPC and Media Protocol

- [Socket Link](https://github.com/j8-diablo/hcef/blob/main/native/api/src/ipc/link.rs): `native/api/src/ipc/link.rs`
- [Control Protocol](https://github.com/j8-diablo/hcef/blob/main/native/api/src/proto/ctl.rs): `native/api/src/proto/ctl.rs`
- [Shared Mapping](https://github.com/j8-diablo/hcef/blob/main/native/api/src/ipc/shm.rs): `native/api/src/ipc/shm.rs`
- [Frame Reader](https://github.com/j8-diablo/hcef/blob/main/native/api/src/proto/frame.rs): `native/api/src/proto/frame.rs`
- [Audio Protocol](https://github.com/j8-diablo/hcef/blob/main/native/api/src/proto/audio.rs): `native/api/src/proto/audio.rs`
- [Wire Encoding](https://github.com/j8-diablo/hcef/blob/main/native/api/src/proto/wire.rs): `native/api/src/proto/wire.rs`

### CEF Host

- [Host Runtime](https://github.com/j8-diablo/hcef/blob/main/host/src/main.rs): `host/src/main.rs`
- [Browser Runtime](https://github.com/j8-diablo/hcef/blob/main/host/src/browsers.rs): `host/src/browsers.rs`

### Host Audio

- [Audio Capture](https://github.com/j8-diablo/hcef/blob/main/host/src/audio/capture.rs): `host/src/audio/capture.rs`
- [Audio Player](https://github.com/j8-diablo/hcef/blob/main/host/src/audio/player.rs): `host/src/audio/player.rs`
- [Audio Mixer](https://github.com/j8-diablo/hcef/blob/main/host/src/audio/mixer.rs): `host/src/audio/mixer.rs`
- [Voice Processing](https://github.com/j8-diablo/hcef/blob/main/host/src/audio/voice.rs): `host/src/audio/voice.rs`
- [DSP Primitives](https://github.com/j8-diablo/hcef/blob/main/host/src/audio/dsp.rs): `host/src/audio/dsp.rs`
- [Audio Limiter](https://github.com/j8-diablo/hcef/blob/main/host/src/audio/limiter.rs): `host/src/audio/limiter.rs`
- [Room Reverb](https://github.com/j8-diablo/hcef/blob/main/host/src/audio/reverb.rs): `host/src/audio/reverb.rs`
- [Audio Output](https://github.com/j8-diablo/hcef/blob/main/host/src/audio/output.rs): `host/src/audio/output.rs`
- [Audio Sharing](https://github.com/j8-diablo/hcef/blob/main/host/src/audio/share.rs): `host/src/audio/share.rs`
- [Audio Ring Buffer](https://github.com/j8-diablo/hcef/blob/main/host/src/audio/ring.rs): `host/src/audio/ring.rs`
- [Audio Placement](https://github.com/j8-diablo/hcef/blob/main/host/src/audio/place.rs): `host/src/audio/place.rs`
- [WAV Recording](https://github.com/j8-diablo/hcef/blob/main/host/src/audio/wav.rs): `host/src/audio/wav.rs`

### Other components

- **Player**
- **Mod Author**
- **Horizon Game**
- **Release Archive**

## Connections

- Player → Install Settings: requests install (evidence: `native/api/src/lib.rs`)
- Install Settings → Host Installer: starts download (evidence: `native/api/src/lib.rs`)
- Host Installer → Release Archive: fetches archive (evidence: `native/api/src/install.rs`)
- Mod Author → Browser Set: requests browsers
- Browser Set → Control Protocol: encodes commands (evidence: `native/api/src/browsers.rs`)
- Browser Set → Host Lifecycle: uses host
- Host Lifecycle → Socket Link: manages connection (evidence: `native/api/src/ipc/host.rs`)
- Host Lifecycle → Control Protocol: sends commands (evidence: `native/api/src/ipc/host.rs`)
- Host Lifecycle → Host Installer: checks installation (evidence: `native/api/src/ipc/host.rs`)
- Horizon Game → Host Lifecycle: starts host (evidence: `README.md`)
- Host Runtime → Socket Link: connects socket (evidence: `host/src/main.rs`)
- Host Runtime → Browser Runtime: serves commands (evidence: `host/src/main.rs`)
- Browser Runtime → Control Protocol: handles messages
- Browser Runtime → Audio Capture: attaches audio
- Shared Mapping → Frame Reader: backs reader (evidence: `native/api/src/ipc/shm.rs`)
- Browser Runtime → Shared Mapping: shares pictures (evidence: `README.md`)
- Frame Reader → Horizon Game: provides pictures (evidence: `README.md`)
- Audio Protocol → Wire Encoding: uses encoding (evidence: `native/api/src/proto/audio.rs`)
- Control Protocol → Audio Protocol: carries scenes (evidence: `native/api/src/proto/ctl.rs`)
- Audio Capture → Audio Player: feeds player (evidence: `host/src/audio/mod.rs`)
- Audio Player → Audio Mixer: mixes blocks (evidence: `host/src/audio/player.rs`)
- Audio Player → Audio Sharing: reads feeds (evidence: `host/src/audio/player.rs`)
- Audio Player → Audio Ring Buffer: reads packets (evidence: `host/src/audio/player.rs`)
- Audio Mixer → Voice Processing: processes voices (evidence: `host/src/audio/mixer.rs`)
- Audio Mixer → Audio Limiter: limits mix (evidence: `host/src/audio/mixer.rs`)
- Audio Mixer → Room Reverb: applies reverb (evidence: `host/src/audio/mixer.rs`)
- Voice Processing → DSP Primitives: uses filters (evidence: `host/src/audio/voice.rs`)
- Voice Processing → Audio Placement: positions sound (evidence: `host/src/audio/voice.rs`)
- Audio Limiter → DSP Primitives: uses primitives (evidence: `host/src/audio/limiter.rs`)
- Room Reverb → DSP Primitives: uses primitives (evidence: `host/src/audio/reverb.rs`)
- Audio Output → Audio Player: plays mix (evidence: `host/src/audio/output.rs`)
- WAV Recording → Audio Player: records mix (evidence: `host/src/audio/mod.rs`)
- Audio Protocol → Audio Player: describes scene (evidence: `README.md`)
