# blixvip/easyedit architecture

> Architecture diagram of the GitHub repository blixvip/easyedit, 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/blixvip/easyedit
- Repository: https://github.com/blixvip/easyedit

## Overview

easyedit turns a movie title into a captioned speech-and-montage fan edit. The principal path is plan, source footage and music, transcribe and select a quote, analyze shots and beats, assemble a timed edit, then render the video. The local web UI starts the same command-line workflow and exposes job progress and finished edits. The README documents major capabilities whose implementation was not fully sampled; links based on those capabilities cite the README, and uncertain wiring is omitted.

Main entry points: [`easyedit/__main__.py`](https://github.com/blixvip/easyedit/blob/main/easyedit/__main__.py) (Edit runner), [`easyedit/assemble.py`](https://github.com/blixvip/easyedit/blob/main/easyedit/assemble.py) (Timeline assembly), [`easyedit/web.py`](https://github.com/blixvip/easyedit/blob/main/easyedit/web.py) (Local web UI), [`easyedit/plan.py`](https://github.com/blixvip/easyedit/blob/main/easyedit/plan.py) (Edit planner)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_orchestration["Job orchestration"]
  node_cli["Edit runner<br/>[__main__.py]"]
  node_doctor["Setup checker<br/>[doctor.py]"]
  node_storage[("Job files<br/>[util.py]")]
end

subgraph group_planning["Planning and sourcing"]
  node_plan["Edit planner<br/>[plan.py]"]
  node_llm["LLM access<br/>[llm.py]"]
  node_design["Edit design<br/>[design.py]"]
  node_fetch["Media sourcing<br/>[fetch.py]"]
end

subgraph group_analysis["Media analysis and edit"]
  node_transcribe["Word transcription<br/>[transcribe.py]"]
  node_quote["Quote and captions<br/>[quote.py]"]
  node_shots["Shot analysis<br/>[shots.py]"]
  node_sheet["Shot curation<br/>[sheet.py]"]
  node_vision["Frame and face vision<br/>[vision.py]"]
  node_beats["Beat analysis<br/>[beats.py]"]
  node_assemble["Timeline assembly<br/>[assemble.py]"]
end

subgraph group_delivery["Rendering and interface"]
  node_web["Local web UI<br/>[web.py]"]
  node_render["Video rendering<br/>[render.py]"]
  node_template["Visual composition<br/>[film.js]"]
end

node_user(("Movie editor"))
node_ai{{"Claude or Codex"}}
node_youtube{{"YouTube"}}
node_whisper{{"faster-whisper"}}
node_encoder{{"FFmpeg"}}

node_user -->|"names movie"| node_cli
node_user -->|"starts edit"| node_web
node_web -->|"launches job"| node_cli
node_cli -->|"requests plan"| node_plan
node_plan -->|"asks model"| node_llm
node_llm -->|"queries"| node_ai
node_plan -.->|"sets visual style"| node_design
node_cli -->|"resolves sources"| node_fetch
node_fetch -->|"searches and downloads"| node_youtube
node_cli -->|"transcribes speech"| node_transcribe
node_transcribe -->|"recognizes words"| node_whisper
node_cli -->|"chooses passage"| node_quote
node_quote -->|"requests selection"| node_llm
node_cli -->|"analyzes sources"| node_shots
node_shots -->|"samples and detects faces"| node_vision
node_cli -.->|"supports shot curation"| node_sheet
node_cli -->|"analyzes music"| node_beats
node_cli -->|"builds timeline"| node_assemble
node_assemble -->|"uses beat times"| node_beats
node_assemble -->|"selects footage"| node_shots
node_assemble -->|"tracks speaker"| node_vision
node_cli -->|"renders edit"| node_render
node_render -->|"uses composition"| node_template
node_render -->|"encodes video"| node_encoder
node_cli -->|"caches job data"| node_storage
node_web -->|"reads job outputs"| node_storage
node_web -->|"checks setup"| node_doctor
node_doctor -->|"checks account"| node_ai

click node_cli "https://github.com/blixvip/easyedit/blob/main/easyedit/__main__.py"
click node_web "https://github.com/blixvip/easyedit/blob/main/easyedit/web.py"
click node_doctor "https://github.com/blixvip/easyedit/blob/main/easyedit/doctor.py"
click node_plan "https://github.com/blixvip/easyedit/blob/main/easyedit/plan.py"
click node_llm "https://github.com/blixvip/easyedit/blob/main/easyedit/llm.py"
click node_design "https://github.com/blixvip/easyedit/blob/main/easyedit/design.py"
click node_fetch "https://github.com/blixvip/easyedit/blob/main/easyedit/fetch.py"
click node_transcribe "https://github.com/blixvip/easyedit/blob/main/easyedit/transcribe.py"
click node_quote "https://github.com/blixvip/easyedit/blob/main/easyedit/quote.py"
click node_shots "https://github.com/blixvip/easyedit/blob/main/easyedit/shots.py"
click node_sheet "https://github.com/blixvip/easyedit/blob/main/easyedit/sheet.py"
click node_vision "https://github.com/blixvip/easyedit/blob/main/easyedit/vision.py"
click node_beats "https://github.com/blixvip/easyedit/blob/main/easyedit/beats.py"
click node_assemble "https://github.com/blixvip/easyedit/blob/main/easyedit/assemble.py"
click node_render "https://github.com/blixvip/easyedit/blob/main/easyedit/render.py"
click node_template "https://github.com/blixvip/easyedit/blob/main/template/film.js"
click node_storage "https://github.com/blixvip/easyedit/blob/main/easyedit/util.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_cli,node_doctor,node_storage toneBlue
class node_plan,node_llm,node_design,node_fetch toneAmber
class node_transcribe,node_quote,node_shots,node_sheet,node_vision,node_beats,node_assemble toneMint
class node_web,node_render,node_template toneRose
class node_user,node_ai,node_youtube,node_whisper,node_encoder toneIndigo
```

## Components

### Job orchestration

- [Edit runner](https://github.com/blixvip/easyedit/blob/main/easyedit/__main__.py): `easyedit/__main__.py`
- [Setup checker](https://github.com/blixvip/easyedit/blob/main/easyedit/doctor.py): `easyedit/doctor.py`
- [Job files](https://github.com/blixvip/easyedit/blob/main/easyedit/util.py): `easyedit/util.py`

### Planning and sourcing

- [Edit planner](https://github.com/blixvip/easyedit/blob/main/easyedit/plan.py): `easyedit/plan.py`
- [LLM access](https://github.com/blixvip/easyedit/blob/main/easyedit/llm.py): `easyedit/llm.py`
- [Edit design](https://github.com/blixvip/easyedit/blob/main/easyedit/design.py): `easyedit/design.py`
- [Media sourcing](https://github.com/blixvip/easyedit/blob/main/easyedit/fetch.py): `easyedit/fetch.py`

### Media analysis and edit

- [Word transcription](https://github.com/blixvip/easyedit/blob/main/easyedit/transcribe.py): `easyedit/transcribe.py`
- [Quote and captions](https://github.com/blixvip/easyedit/blob/main/easyedit/quote.py): `easyedit/quote.py`
- [Shot analysis](https://github.com/blixvip/easyedit/blob/main/easyedit/shots.py): `easyedit/shots.py`
- [Shot curation](https://github.com/blixvip/easyedit/blob/main/easyedit/sheet.py): `easyedit/sheet.py`
- [Frame and face vision](https://github.com/blixvip/easyedit/blob/main/easyedit/vision.py): `easyedit/vision.py`
- [Beat analysis](https://github.com/blixvip/easyedit/blob/main/easyedit/beats.py): `easyedit/beats.py`
- [Timeline assembly](https://github.com/blixvip/easyedit/blob/main/easyedit/assemble.py): `easyedit/assemble.py`

### Rendering and interface

- [Local web UI](https://github.com/blixvip/easyedit/blob/main/easyedit/web.py): `easyedit/web.py`
- [Video rendering](https://github.com/blixvip/easyedit/blob/main/easyedit/render.py): `easyedit/render.py`
- [Visual composition](https://github.com/blixvip/easyedit/blob/main/template/film.js): `template/film.js`

### Other components

- **Movie editor**
- **Claude or Codex**
- **YouTube**
- **faster-whisper**
- **FFmpeg**

## Connections

- Movie editor → Edit runner: names movie (evidence: `README.md`)
- Movie editor → Local web UI: starts edit (evidence: `README.md`)
- Local web UI → Edit runner: launches job (evidence: `easyedit/web.py`)
- Edit runner → Edit planner: requests plan (evidence: `easyedit/__main__.py`)
- Edit planner → LLM access: asks model (evidence: `easyedit/plan.py`)
- LLM access → Claude or Codex: queries (evidence: `easyedit/llm.py`)
- Edit planner → Edit design: sets visual style
- Edit runner → Media sourcing: resolves sources (evidence: `easyedit/__main__.py`)
- Media sourcing → YouTube: searches and downloads (evidence: `easyedit/fetch.py`)
- Edit runner → Word transcription: transcribes speech (evidence: `easyedit/__main__.py`)
- Word transcription → faster-whisper: recognizes words (evidence: `README.md`)
- Edit runner → Quote and captions: chooses passage (evidence: `easyedit/__main__.py`)
- Quote and captions → LLM access: requests selection (evidence: `easyedit/quote.py`)
- Edit runner → Shot analysis: analyzes sources (evidence: `easyedit/__main__.py`)
- Shot analysis → Frame and face vision: samples and detects faces (evidence: `easyedit/shots.py`)
- Edit runner → Shot curation: supports shot curation
- Edit runner → Beat analysis: analyzes music (evidence: `README.md`)
- Edit runner → Timeline assembly: builds timeline (evidence: `README.md`)
- Timeline assembly → Beat analysis: uses beat times (evidence: `easyedit/assemble.py`)
- Timeline assembly → Shot analysis: selects footage (evidence: `easyedit/assemble.py`)
- Timeline assembly → Frame and face vision: tracks speaker (evidence: `easyedit/assemble.py`)
- Edit runner → Video rendering: renders edit (evidence: `README.md`)
- Video rendering → Visual composition: uses composition (evidence: `README.md`)
- Video rendering → FFmpeg: encodes video (evidence: `README.md`)
- Edit runner → Job files: caches job data (evidence: `easyedit/__main__.py`)
- Local web UI → Job files: reads job outputs (evidence: `easyedit/web.py`)
- Local web UI → Setup checker: checks setup (evidence: `easyedit/web.py`)
- Setup checker → Claude or Codex: checks account (evidence: `easyedit/doctor.py`)
