# ozmartian/vidcutter architecture

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

- Interactive diagram: https://gitdiagram.com/ozmartian/vidcutter
- Repository: https://github.com/ozmartian/vidcutter

## Overview

VidCutter is a desktop video cutter and joiner. Users launch the app, open or preload media, play and mark clip regions, then cut or join selected clips. The main window initializes the cutter UI; media processing is handled by a service that uses FFmpeg. The README also documents project-file opening, media information, and frame-accurate SmartCut. Several subsystems are represented from the README or module references because their implementation excerpts were not provided; those links are marked unverified where appropriate.

Main entry points: [`vidcutter/videocutter.py`](https://github.com/ozmartian/vidcutter/blob/master/vidcutter/videocutter.py) (Main editor), [`vidcutter/libs/videoservice.py`](https://github.com/ozmartian/vidcutter/blob/master/vidcutter/libs/videoservice.py) (Cut and join), [`vidcutter/__main__.py`](https://github.com/ozmartian/vidcutter/blob/master/vidcutter/__main__.py) (App entry), [`vidcutter/mediastream.py`](https://github.com/ozmartian/vidcutter/blob/master/vidcutter/mediastream.py) (Stream details)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application UI"]
  node_main["App entry<br/>[__main__.py]"]
  node_editor["Main editor<br/>[videocutter.py]"]
  node_player["Media player<br/>[mpvwidget.py]"]
end

subgraph group_editing["Editing workflow"]
  node_cliplist["Clip list<br/>[videolist.py]"]
  node_timeline["Clip timeline<br/>[videoslider.py]"]
  node_timeline_widget["Timeline widget"]
  node_project["Project files<br/>[videocutter.py]"]
end

subgraph group_media["Media services"]
  node_cut_join["Cut and join<br/>[videoservice.py]"]
  node_stream_info["Stream details<br/>[mediastream.py]"]
  node_media_info["Media information<br/>[mediainfo.py]"]
end

subgraph group_support["App support"]
  node_settings["Settings<br/>[settings.py]"]
  node_config["Configuration<br/>[config.py]"]
  node_notifications["Notifications<br/>[notifications.py]"]
  node_updater["Updater<br/>[updater.py]"]
end

node_user(("Video editor"))
node_ffmpeg["FFmpeg"]

node_user -->|"launches"| node_main
node_main -->|"initializes"| node_editor
node_editor -->|"uses"| node_player
node_editor -->|"uses"| node_cliplist
node_editor -->|"uses"| node_timeline
node_timeline_widget -->|"wraps"| node_timeline
node_editor -.->|"requests edits"| node_cut_join
node_cut_join -.->|"runs commands"| node_ffmpeg
node_editor -->|"shows streams"| node_stream_info
node_stream_info -->|"uses service"| node_cut_join
node_editor -->|"opens details"| node_media_info
node_user -->|"opens"| node_project
node_editor -->|"opens preferences"| node_settings
node_settings -->|"configures tools"| node_cut_join
node_cut_join -->|"reads settings"| node_config
node_editor -.->|"uses"| node_notifications
node_editor -->|"offers updates"| node_updater

click node_main "https://github.com/ozmartian/vidcutter/blob/master/vidcutter/__main__.py"
click node_editor "https://github.com/ozmartian/vidcutter/blob/master/vidcutter/videocutter.py"
click node_player "https://github.com/ozmartian/vidcutter/blob/master/vidcutter/libs/mpvwidget.py"
click node_cliplist "https://github.com/ozmartian/vidcutter/blob/master/vidcutter/videolist.py"
click node_timeline "https://github.com/ozmartian/vidcutter/blob/master/vidcutter/videoslider.py"
click node_timeline_widget "https://github.com/ozmartian/vidcutter/blob/master/vidcutter/videosliderwidget.py"
click node_cut_join "https://github.com/ozmartian/vidcutter/blob/master/vidcutter/libs/videoservice.py"
click node_stream_info "https://github.com/ozmartian/vidcutter/blob/master/vidcutter/mediastream.py"
click node_media_info "https://github.com/ozmartian/vidcutter/blob/master/vidcutter/mediainfo.py"
click node_project "https://github.com/ozmartian/vidcutter/blob/master/vidcutter/videocutter.py"
click node_settings "https://github.com/ozmartian/vidcutter/blob/master/vidcutter/settings.py"
click node_config "https://github.com/ozmartian/vidcutter/blob/master/vidcutter/libs/config.py"
click node_notifications "https://github.com/ozmartian/vidcutter/blob/master/vidcutter/libs/notifications.py"
click node_updater "https://github.com/ozmartian/vidcutter/blob/master/vidcutter/updater.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_main,node_editor,node_player toneBlue
class node_cliplist,node_timeline,node_timeline_widget,node_project toneAmber
class node_cut_join,node_stream_info,node_media_info toneMint
class node_settings,node_config,node_notifications,node_updater toneRose
class node_user,node_ffmpeg toneIndigo
```

## Components

### Application UI

- [App entry](https://github.com/ozmartian/vidcutter/blob/master/vidcutter/__main__.py): `vidcutter/__main__.py`
- [Main editor](https://github.com/ozmartian/vidcutter/blob/master/vidcutter/videocutter.py): `vidcutter/videocutter.py`
- [Media player](https://github.com/ozmartian/vidcutter/blob/master/vidcutter/libs/mpvwidget.py): `vidcutter/libs/mpvwidget.py`

### Editing workflow

- [Clip list](https://github.com/ozmartian/vidcutter/blob/master/vidcutter/videolist.py): `vidcutter/videolist.py`
- [Clip timeline](https://github.com/ozmartian/vidcutter/blob/master/vidcutter/videoslider.py): `vidcutter/videoslider.py`
- [Timeline widget](https://github.com/ozmartian/vidcutter/blob/master/vidcutter/videosliderwidget.py): `vidcutter/videosliderwidget.py`
- [Project files](https://github.com/ozmartian/vidcutter/blob/master/vidcutter/videocutter.py): `vidcutter/videocutter.py`

### Media services

- [Cut and join](https://github.com/ozmartian/vidcutter/blob/master/vidcutter/libs/videoservice.py): `vidcutter/libs/videoservice.py`
- [Stream details](https://github.com/ozmartian/vidcutter/blob/master/vidcutter/mediastream.py): `vidcutter/mediastream.py`
- [Media information](https://github.com/ozmartian/vidcutter/blob/master/vidcutter/mediainfo.py): `vidcutter/mediainfo.py`

### App support

- [Settings](https://github.com/ozmartian/vidcutter/blob/master/vidcutter/settings.py): `vidcutter/settings.py`
- [Configuration](https://github.com/ozmartian/vidcutter/blob/master/vidcutter/libs/config.py): `vidcutter/libs/config.py`
- [Notifications](https://github.com/ozmartian/vidcutter/blob/master/vidcutter/libs/notifications.py): `vidcutter/libs/notifications.py`
- [Updater](https://github.com/ozmartian/vidcutter/blob/master/vidcutter/updater.py): `vidcutter/updater.py`

### Other components

- **Video editor**
- **FFmpeg**

## Connections

- Video editor → App entry: launches (evidence: `vidcutter/__main__.py`)
- App entry → Main editor: initializes (evidence: `vidcutter/__main__.py`)
- Main editor → Media player: uses (evidence: `vidcutter/videocutter.py`)
- Main editor → Clip list: uses (evidence: `vidcutter/videocutter.py`)
- Main editor → Clip timeline: uses (evidence: `vidcutter/videocutter.py`)
- Timeline widget → Clip timeline: wraps (evidence: `vidcutter/videosliderwidget.py`)
- Main editor → Cut and join: requests edits (evidence: `vidcutter/videocutter.py`)
- Cut and join → FFmpeg: runs commands
- Main editor → Stream details: shows streams (evidence: `vidcutter/videocutter.py`)
- Stream details → Cut and join: uses service (evidence: `vidcutter/mediastream.py`)
- Main editor → Media information: opens details (evidence: `vidcutter/videocutter.py`)
- Video editor → Project files: opens (evidence: `README.md`)
- Main editor → Settings: opens preferences (evidence: `vidcutter/videocutter.py`)
- Settings → Cut and join: configures tools (evidence: `vidcutter/settings.py`)
- Cut and join → Configuration: reads settings (evidence: `vidcutter/libs/videoservice.py`)
- Main editor → Notifications: uses (evidence: `vidcutter/videocutter.py`)
- Main editor → Updater: offers updates (evidence: `vidcutter/videocutter.py`)
