# nysernelson/vmg-video-manager- architecture

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

- Interactive diagram: https://gitdiagram.com/nysernelson/vmg-video-manager-
- Repository: https://github.com/nysernelson/vmg-video-manager-

## Overview

VMG is an Electron desktop video-trimming and management application. The main workflow is to choose a folder, preview and trim a clip, configure an export, and track the export while continuing other work. The renderer owns the editing interface, localization, and queue display; the Electron main process handles file operations and invokes FFmpeg. The README also documents renaming, recycle-bin deletion, and multilingual switching. Renderer excerpts are partial, so some feature-to-handler links are shown as unverified rather than asserted as direct calls.

Main entry points: [`renderer.js`](https://github.com/nysernelson/vmg-video-manager-/blob/main/renderer.js) (Editor UI), [`main.js`](https://github.com/nysernelson/vmg-video-manager-/blob/main/main.js) (Export handler), [`index.html`](https://github.com/nysernelson/vmg-video-manager-/blob/main/index.html) (Application view)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_editing["Editing interface"]
  node_renderer["Editor UI<br/>[renderer.js]"]
  node_preview["Playback and trim<br/>[renderer.js]"]
  node_languages["Localization<br/>[renderer.js]"]
end

subgraph group_exports["Export processing"]
  node_export_ui["Export settings<br/>[renderer.js]"]
  node_queue_ui["Export queue<br/>[renderer.js]"]
  node_export_handler["Export handler<br/>[main.js]"]
  node_ffmpeg["FFmpeg"]
  node_progress["Progress events<br/>[main.js]"]
end

subgraph group_files["Video management"]
  node_library["Video library<br/>[main.js]"]
  node_file_ops["Rename and delete<br/>[main.js]"]
  node_recycle_bin["System recycle bin"]
  node_filesystem[("Local video files")]
end

subgraph group_platform["Desktop platform"]
  node_electron["Electron window and IPC<br/>[main.js]"]
  node_html["Application view<br/>[index.html]"]
end

node_user(("User"))

node_user -->|"uses"| node_renderer
node_renderer -.->|"selects folder"| node_library
node_library -->|"lists videos"| node_filesystem
node_renderer -->|"sets trim points"| node_preview
node_renderer -->|"switches language"| node_languages
node_renderer -->|"configures export"| node_export_ui
node_renderer -->|"tracks tasks"| node_queue_ui
node_renderer -.->|"requests export"| node_export_handler
node_export_handler -->|"runs encoding"| node_ffmpeg
node_export_handler -->|"sends updates"| node_progress
node_progress -->|"updates progress"| node_queue_ui
node_renderer -.->|"requests file actions"| node_file_ops
node_file_ops -->|"renames files"| node_filesystem
node_file_ops -->|"moves deleted video"| node_recycle_bin
node_electron -->|"loads view"| node_html
node_renderer -->|"checks FFmpeg"| node_electron

click node_renderer "https://github.com/nysernelson/vmg-video-manager-/blob/main/renderer.js"
click node_library "https://github.com/nysernelson/vmg-video-manager-/blob/main/main.js"
click node_preview "https://github.com/nysernelson/vmg-video-manager-/blob/main/renderer.js"
click node_languages "https://github.com/nysernelson/vmg-video-manager-/blob/main/renderer.js"
click node_export_ui "https://github.com/nysernelson/vmg-video-manager-/blob/main/renderer.js"
click node_queue_ui "https://github.com/nysernelson/vmg-video-manager-/blob/main/renderer.js"
click node_export_handler "https://github.com/nysernelson/vmg-video-manager-/blob/main/main.js"
click node_progress "https://github.com/nysernelson/vmg-video-manager-/blob/main/main.js"
click node_file_ops "https://github.com/nysernelson/vmg-video-manager-/blob/main/main.js"
click node_electron "https://github.com/nysernelson/vmg-video-manager-/blob/main/main.js"
click node_html "https://github.com/nysernelson/vmg-video-manager-/blob/main/index.html"

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_renderer,node_preview,node_languages,node_user toneBlue
class node_export_ui,node_queue_ui,node_export_handler,node_ffmpeg,node_progress toneAmber
class node_library,node_file_ops,node_recycle_bin,node_filesystem toneMint
class node_electron,node_html toneRose
```

## Components

### Editing interface

- [Editor UI](https://github.com/nysernelson/vmg-video-manager-/blob/main/renderer.js): `renderer.js`
- [Playback and trim](https://github.com/nysernelson/vmg-video-manager-/blob/main/renderer.js): `renderer.js`
- [Localization](https://github.com/nysernelson/vmg-video-manager-/blob/main/renderer.js): `renderer.js`

### Export processing

- [Export settings](https://github.com/nysernelson/vmg-video-manager-/blob/main/renderer.js): `renderer.js`
- [Export queue](https://github.com/nysernelson/vmg-video-manager-/blob/main/renderer.js): `renderer.js`
- [Export handler](https://github.com/nysernelson/vmg-video-manager-/blob/main/main.js): `main.js`
- **FFmpeg**
- [Progress events](https://github.com/nysernelson/vmg-video-manager-/blob/main/main.js): `main.js`

### Video management

- [Video library](https://github.com/nysernelson/vmg-video-manager-/blob/main/main.js): `main.js`
- [Rename and delete](https://github.com/nysernelson/vmg-video-manager-/blob/main/main.js): `main.js`
- **System recycle bin**
- **Local video files**

### Desktop platform

- [Electron window and IPC](https://github.com/nysernelson/vmg-video-manager-/blob/main/main.js): `main.js`
- [Application view](https://github.com/nysernelson/vmg-video-manager-/blob/main/index.html): `index.html`

### Other components

- **User**

## Connections

- User → Editor UI: uses (evidence: `README.md`)
- Editor UI → Video library: selects folder
- Video library → Local video files: lists videos (evidence: `main.js`)
- Editor UI → Playback and trim: sets trim points (evidence: `renderer.js`)
- Editor UI → Localization: switches language (evidence: `renderer.js`)
- Editor UI → Export settings: configures export (evidence: `README.md`)
- Editor UI → Export queue: tracks tasks (evidence: `README.md`)
- Editor UI → Export handler: requests export
- Export handler → FFmpeg: runs encoding (evidence: `main.js`)
- Export handler → Progress events: sends updates (evidence: `main.js`)
- Progress events → Export queue: updates progress (evidence: `renderer.js`)
- Editor UI → Rename and delete: requests file actions
- Rename and delete → Local video files: renames files (evidence: `main.js`)
- Rename and delete → System recycle bin: moves deleted video (evidence: `main.js`)
- Electron window and IPC → Application view: loads view (evidence: `main.js`)
- Editor UI → Electron window and IPC: checks FFmpeg (evidence: `renderer.js`)
