# moutazelissawi/clipnest architecture

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

- Interactive diagram: https://gitdiagram.com/moutazelissawi/clipnest
- Repository: https://github.com/moutazelissawi/clipnest

## Overview

ClipNest is a Windows recording and clip-management desktop application. The primary workflow is to configure capture, save a replay or manual recording, then browse, play, edit, combine, or export clips. Its runtime separates the Qt interface, recorder/replay services, and clip-management tools. The README documents the user-facing capabilities; source excerpts are partial, so some internal links are omitted where invocation is not visible.

Main entry points: [`clipnest/ui.py`](https://github.com/moutazelissawi/clipnest/blob/main/clipnest/ui.py) (Main interface), [`clipnest/engine.py`](https://github.com/moutazelissawi/clipnest/blob/main/clipnest/engine.py) (Recorder engine), [`clipnest/editor.py`](https://github.com/moutazelissawi/clipnest/blob/main/clipnest/editor.py) (Clip editor), [`clipnest/gallery.py`](https://github.com/moutazelissawi/clipnest/blob/main/clipnest/gallery.py) (Recent gallery)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Desktop app"]
  node_entry["Application entry<br/>[main.py]"]
  node_shell["Main interface<br/>[ui.py]"]
  node_settings[("Settings<br/>[config.py]")]
  node_hotkeys["Shortcuts<br/>[hotkeys.py]"]
  node_notifications["Notifications<br/>[notifications.py]"]
  node_system["System events<br/>[system_events.py]"]
end

subgraph group_capture["Capture runtime"]
  node_engine["Recorder engine<br/>[engine.py]"]
  node_nativeclient["Recorder client<br/>[native_client.py]"]
  node_nativehost["Native recorder host<br/>[native_host.py]"]
  node_libobs["libobs bindings<br/>[libobs.py]"]
  node_replay["Continuous replay<br/>[replay.py]"]
  node_catalog["Game detection<br/>[catalog.py]"]
end

subgraph group_clips["Clip workflows"]
  node_gallery["Recent gallery<br/>[gallery.py]"]
  node_browser["Clip browser<br/>[clip_browser.py]"]
  node_library[("Clip metadata<br/>[library.py]")]
  node_editor["Clip editor<br/>[editor.py]"]
  node_media["Media processing<br/>[media.py]"]
  node_preview["Editor preview<br/>[preview.py]"]
  node_assets["Clip analysis<br/>[editor_assets.py]"]
  node_combine["Clip combining<br/>[join.py]"]
  node_combineui["Combine dialog<br/>[join_dialog.py]"]
  node_storage["Storage display<br/>[storage_widget.py]"]
end

subgraph group_presentation["Shared presentation"]
  node_theme["Theme and glass<br/>[theme.py]"]
  node_frame["Window frame<br/>[window_frame.py]"]
  node_desktop["Desktop interactions<br/>[desktop.py]"]
end

node_user(("ClipNest user"))

node_user -->|"launches"| node_entry
node_entry -->|"starts"| node_shell
node_shell -->|"loads settings"| node_settings
node_shell -->|"controls capture"| node_engine
node_shell -->|"registers shortcuts"| node_hotkeys
node_shell -->|"shows notices"| node_notifications
node_shell -->|"handles events"| node_system
node_engine -->|"sends commands"| node_nativeclient
node_nativeclient -->|"controls recorder"| node_nativehost
node_nativehost -->|"uses bindings"| node_libobs
node_engine -->|"polls game"| node_catalog
node_engine -->|"manages replay"| node_replay
node_engine -->|"reads preferences"| node_settings
node_shell -->|"opens gallery"| node_gallery
node_shell -->|"opens browser"| node_browser
node_shell -->|"opens editor"| node_editor
node_shell -->|"opens combine"| node_combineui
node_gallery -->|"reads clip metadata"| node_library
node_browser -->|"reads clip metadata"| node_library
node_gallery -->|"shows usage"| node_storage
node_browser -->|"selects clips"| node_combineui
node_combineui -->|"combines clips"| node_combine
node_combineui -->|"probes clips"| node_media
node_editor -->|"exports edits"| node_media
node_editor -->|"renders preview"| node_preview
node_editor -->|"analyzes audio"| node_assets
node_gallery -->|"opens for editing"| node_editor
node_shell -->|"applies appearance"| node_theme
node_shell -->|"uses window chrome"| node_frame
node_shell -->|"uses desktop helpers"| node_desktop
node_user -.->|"saves replay"| node_replay

click node_entry "https://github.com/moutazelissawi/clipnest/blob/main/main.py"
click node_shell "https://github.com/moutazelissawi/clipnest/blob/main/clipnest/ui.py"
click node_settings "https://github.com/moutazelissawi/clipnest/blob/main/clipnest/config.py"
click node_hotkeys "https://github.com/moutazelissawi/clipnest/blob/main/clipnest/hotkeys.py"
click node_notifications "https://github.com/moutazelissawi/clipnest/blob/main/clipnest/notifications.py"
click node_system "https://github.com/moutazelissawi/clipnest/blob/main/clipnest/system_events.py"
click node_engine "https://github.com/moutazelissawi/clipnest/blob/main/clipnest/engine.py"
click node_nativeclient "https://github.com/moutazelissawi/clipnest/blob/main/clipnest/native_client.py"
click node_nativehost "https://github.com/moutazelissawi/clipnest/blob/main/clipnest/native_host.py"
click node_libobs "https://github.com/moutazelissawi/clipnest/blob/main/clipnest/libobs.py"
click node_replay "https://github.com/moutazelissawi/clipnest/blob/main/clipnest/replay.py"
click node_catalog "https://github.com/moutazelissawi/clipnest/blob/main/clipnest/catalog.py"
click node_gallery "https://github.com/moutazelissawi/clipnest/blob/main/clipnest/gallery.py"
click node_browser "https://github.com/moutazelissawi/clipnest/blob/main/clipnest/clip_browser.py"
click node_library "https://github.com/moutazelissawi/clipnest/blob/main/clipnest/library.py"
click node_editor "https://github.com/moutazelissawi/clipnest/blob/main/clipnest/editor.py"
click node_media "https://github.com/moutazelissawi/clipnest/blob/main/clipnest/media.py"
click node_preview "https://github.com/moutazelissawi/clipnest/blob/main/clipnest/preview.py"
click node_assets "https://github.com/moutazelissawi/clipnest/blob/main/clipnest/editor_assets.py"
click node_combine "https://github.com/moutazelissawi/clipnest/blob/main/clipnest/join.py"
click node_combineui "https://github.com/moutazelissawi/clipnest/blob/main/clipnest/join_dialog.py"
click node_storage "https://github.com/moutazelissawi/clipnest/blob/main/clipnest/storage_widget.py"
click node_theme "https://github.com/moutazelissawi/clipnest/blob/main/clipnest/theme.py"
click node_frame "https://github.com/moutazelissawi/clipnest/blob/main/clipnest/window_frame.py"
click node_desktop "https://github.com/moutazelissawi/clipnest/blob/main/clipnest/desktop.py"

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_entry,node_shell,node_settings,node_hotkeys,node_notifications,node_system,node_user toneBlue
class node_engine,node_nativeclient,node_nativehost,node_libobs,node_replay,node_catalog toneAmber
class node_gallery,node_browser,node_library,node_editor,node_media,node_preview,node_assets,node_combine,node_combineui,node_storage toneMint
class node_theme,node_frame,node_desktop toneRose
```

## Components

### Desktop app

- [Application entry](https://github.com/moutazelissawi/clipnest/blob/main/main.py): `main.py`
- [Main interface](https://github.com/moutazelissawi/clipnest/blob/main/clipnest/ui.py): `clipnest/ui.py`
- [Settings](https://github.com/moutazelissawi/clipnest/blob/main/clipnest/config.py): `clipnest/config.py`
- [Shortcuts](https://github.com/moutazelissawi/clipnest/blob/main/clipnest/hotkeys.py): `clipnest/hotkeys.py`
- [Notifications](https://github.com/moutazelissawi/clipnest/blob/main/clipnest/notifications.py): `clipnest/notifications.py`
- [System events](https://github.com/moutazelissawi/clipnest/blob/main/clipnest/system_events.py): `clipnest/system_events.py`

### Capture runtime

- [Recorder engine](https://github.com/moutazelissawi/clipnest/blob/main/clipnest/engine.py): `clipnest/engine.py`
- [Recorder client](https://github.com/moutazelissawi/clipnest/blob/main/clipnest/native_client.py): `clipnest/native_client.py`
- [Native recorder host](https://github.com/moutazelissawi/clipnest/blob/main/clipnest/native_host.py): `clipnest/native_host.py`
- [libobs bindings](https://github.com/moutazelissawi/clipnest/blob/main/clipnest/libobs.py): `clipnest/libobs.py`
- [Continuous replay](https://github.com/moutazelissawi/clipnest/blob/main/clipnest/replay.py): `clipnest/replay.py`
- [Game detection](https://github.com/moutazelissawi/clipnest/blob/main/clipnest/catalog.py): `clipnest/catalog.py`

### Clip workflows

- [Recent gallery](https://github.com/moutazelissawi/clipnest/blob/main/clipnest/gallery.py): `clipnest/gallery.py`
- [Clip browser](https://github.com/moutazelissawi/clipnest/blob/main/clipnest/clip_browser.py): `clipnest/clip_browser.py`
- [Clip metadata](https://github.com/moutazelissawi/clipnest/blob/main/clipnest/library.py): `clipnest/library.py`
- [Clip editor](https://github.com/moutazelissawi/clipnest/blob/main/clipnest/editor.py): `clipnest/editor.py`
- [Media processing](https://github.com/moutazelissawi/clipnest/blob/main/clipnest/media.py): `clipnest/media.py`
- [Editor preview](https://github.com/moutazelissawi/clipnest/blob/main/clipnest/preview.py): `clipnest/preview.py`
- [Clip analysis](https://github.com/moutazelissawi/clipnest/blob/main/clipnest/editor_assets.py): `clipnest/editor_assets.py`
- [Clip combining](https://github.com/moutazelissawi/clipnest/blob/main/clipnest/join.py): `clipnest/join.py`
- [Combine dialog](https://github.com/moutazelissawi/clipnest/blob/main/clipnest/join_dialog.py): `clipnest/join_dialog.py`
- [Storage display](https://github.com/moutazelissawi/clipnest/blob/main/clipnest/storage_widget.py): `clipnest/storage_widget.py`

### Shared presentation

- [Theme and glass](https://github.com/moutazelissawi/clipnest/blob/main/clipnest/theme.py): `clipnest/theme.py`
- [Window frame](https://github.com/moutazelissawi/clipnest/blob/main/clipnest/window_frame.py): `clipnest/window_frame.py`
- [Desktop interactions](https://github.com/moutazelissawi/clipnest/blob/main/clipnest/desktop.py): `clipnest/desktop.py`

### Other components

- **ClipNest user**

## Connections

- ClipNest user → Application entry: launches (evidence: `README.md`)
- Application entry → Main interface: starts (evidence: `main.py`)
- Main interface → Settings: loads settings (evidence: `clipnest/ui.py`)
- Main interface → Recorder engine: controls capture (evidence: `clipnest/ui.py`)
- Main interface → Shortcuts: registers shortcuts (evidence: `clipnest/ui.py`)
- Main interface → Notifications: shows notices (evidence: `clipnest/ui.py`)
- Main interface → System events: handles events (evidence: `clipnest/ui.py`)
- Recorder engine → Recorder client: sends commands (evidence: `clipnest/engine.py`)
- Recorder client → Native recorder host: controls recorder (evidence: `clipnest/native_client.py`)
- Native recorder host → libobs bindings: uses bindings (evidence: `clipnest/native_host.py`)
- Recorder engine → Game detection: polls game (evidence: `clipnest/engine.py`)
- Recorder engine → Continuous replay: manages replay (evidence: `clipnest/engine.py`)
- Recorder engine → Settings: reads preferences (evidence: `clipnest/engine.py`)
- Main interface → Recent gallery: opens gallery (evidence: `clipnest/ui.py`)
- Main interface → Clip browser: opens browser (evidence: `clipnest/ui.py`)
- Main interface → Clip editor: opens editor (evidence: `clipnest/ui.py`)
- Main interface → Combine dialog: opens combine (evidence: `clipnest/ui.py`)
- Recent gallery → Clip metadata: reads clip metadata (evidence: `clipnest/gallery.py`)
- Clip browser → Clip metadata: reads clip metadata (evidence: `clipnest/clip_browser.py`)
- Recent gallery → Storage display: shows usage (evidence: `clipnest/gallery.py`)
- Clip browser → Combine dialog: selects clips (evidence: `clipnest/clip_browser.py`)
- Combine dialog → Clip combining: combines clips (evidence: `clipnest/join_dialog.py`)
- Combine dialog → Media processing: probes clips (evidence: `clipnest/join_dialog.py`)
- Clip editor → Media processing: exports edits (evidence: `clipnest/editor.py`)
- Clip editor → Editor preview: renders preview (evidence: `clipnest/editor.py`)
- Clip editor → Clip analysis: analyzes audio (evidence: `clipnest/editor.py`)
- Recent gallery → Clip editor: opens for editing (evidence: `README.md`)
- Main interface → Theme and glass: applies appearance (evidence: `clipnest/ui.py`)
- Main interface → Window frame: uses window chrome (evidence: `clipnest/ui.py`)
- Main interface → Desktop interactions: uses desktop helpers (evidence: `clipnest/ui.py`)
- ClipNest user → Continuous replay: saves replay (evidence: `README.md`)
