# neotecos/obs-macos-videotoolbox-encoders architecture

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

- Interactive diagram: https://gitdiagram.com/neotecos/obs-macos-videotoolbox-encoders
- Repository: https://github.com/neotecos/obs-macos-videotoolbox-encoders

## Overview

This OBS plugin adds customizable Apple VideoToolbox H.264 and HEVC encoders. Users tune codec settings in the Tools dialog; settings are saved for the Mac and applied by the encoder. For supported Multitrack Video streams, an optional integration replaces compatible native encoders while preserving fallback behavior. Source excerpts show the settings/configuration calls and encoder behavior; some integration wiring is documented in the README but not fully visible in the sampled source.

Main entry points: [`src/enhanced-broadcasting.cpp`](https://github.com/neotecos/obs-macos-videotoolbox-encoders/blob/master/src/enhanced-broadcasting.cpp) (Encoder replacement), [`src/encoder.c`](https://github.com/neotecos/obs-macos-videotoolbox-encoders/blob/master/src/encoder.c) (Custom H.264), [`src/plugin-config.c`](https://github.com/neotecos/obs-macos-videotoolbox-encoders/blob/master/src/plugin-config.c) (Plugin configuration), [`src/settings-dialog.cpp`](https://github.com/neotecos/obs-macos-videotoolbox-encoders/blob/master/src/settings-dialog.cpp) (Settings dialog)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_configuration["Settings"]
  node_dialog["Settings dialog"]
  node_config[("Plugin configuration<br/>[plugin-config.c]")]
end

subgraph group_encoding["Encoding"]
  node_h264["Custom H.264<br/>[encoder.c]"]
  node_hevc["Custom HEVC<br/>[encoder.c]"]
  node_videotoolbox["Apple VideoToolbox"]
end

subgraph group_multitrack["Multitrack"]
  node_multitrack["Encoder replacement"]
end

node_user(("OBS user"))
node_obs["OBS Studio"]
node_stream["Multitrack output"]

node_user -->|"opens tools"| node_obs
node_obs -->|"opens settings"| node_dialog
node_dialog -->|"saves settings"| node_config
node_config -.->|"tunes codec"| node_h264
node_config -.->|"tunes codec"| node_hevc
node_obs -->|"selects encoder"| node_h264
node_obs -->|"selects encoder"| node_hevc
node_h264 -->|"encodes frames"| node_videotoolbox
node_hevc -->|"encodes frames"| node_videotoolbox
node_obs -->|"notifies streaming"| node_multitrack
node_multitrack -->|"replaces encoders"| node_stream
node_multitrack -.->|"selects replacement"| node_h264
node_multitrack -.->|"selects replacement"| node_hevc

click node_dialog "https://github.com/neotecos/obs-macos-videotoolbox-encoders/blob/master/src/settings-dialog.cpp"
click node_config "https://github.com/neotecos/obs-macos-videotoolbox-encoders/blob/master/src/plugin-config.c"
click node_h264 "https://github.com/neotecos/obs-macos-videotoolbox-encoders/blob/master/src/encoder.c"
click node_hevc "https://github.com/neotecos/obs-macos-videotoolbox-encoders/blob/master/src/encoder.c"
click node_multitrack "https://github.com/neotecos/obs-macos-videotoolbox-encoders/blob/master/src/enhanced-broadcasting.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_dialog,node_config,node_user toneBlue
class node_h264,node_hevc,node_videotoolbox toneAmber
class node_multitrack toneMint
class node_obs,node_stream toneIndigo
```

## Components

### Settings

- [Settings dialog](https://github.com/neotecos/obs-macos-videotoolbox-encoders/blob/master/src/settings-dialog.cpp): `src/settings-dialog.cpp`
- [Plugin configuration](https://github.com/neotecos/obs-macos-videotoolbox-encoders/blob/master/src/plugin-config.c): `src/plugin-config.c`

### Encoding

- [Custom H.264](https://github.com/neotecos/obs-macos-videotoolbox-encoders/blob/master/src/encoder.c): `src/encoder.c`
- [Custom HEVC](https://github.com/neotecos/obs-macos-videotoolbox-encoders/blob/master/src/encoder.c): `src/encoder.c`
- **Apple VideoToolbox**

### Multitrack

- [Encoder replacement](https://github.com/neotecos/obs-macos-videotoolbox-encoders/blob/master/src/enhanced-broadcasting.cpp): `src/enhanced-broadcasting.cpp`

### Other components

- **OBS user**
- **OBS Studio**
- **Multitrack output**

## Connections

- OBS user → OBS Studio: opens tools (evidence: `README.md`)
- OBS Studio → Settings dialog: opens settings (evidence: `README.md`)
- Settings dialog → Plugin configuration: saves settings (evidence: `src/settings-dialog.cpp`)
- Plugin configuration → Custom H.264: tunes codec (evidence: `README.md`)
- Plugin configuration → Custom HEVC: tunes codec (evidence: `README.md`)
- OBS Studio → Custom H.264: selects encoder (evidence: `README.md`)
- OBS Studio → Custom HEVC: selects encoder (evidence: `README.md`)
- Custom H.264 → Apple VideoToolbox: encodes frames (evidence: `src/encoder.c`)
- Custom HEVC → Apple VideoToolbox: encodes frames (evidence: `src/encoder.c`)
- OBS Studio → Encoder replacement: notifies streaming (evidence: `src/enhanced-broadcasting.cpp`)
- Encoder replacement → Multitrack output: replaces encoders (evidence: `src/enhanced-broadcasting.cpp`)
- Encoder replacement → Custom H.264: selects replacement (evidence: `README.md`)
- Encoder replacement → Custom HEVC: selects replacement (evidence: `README.md`)
