# lmfrozza/autoclip architecture

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

- Interactive diagram: https://gitdiagram.com/lmfrozza/autoclip
- Repository: https://github.com/lmfrozza/autoclip

## Overview

Autoclip turns configured Twitch streamers’ clips into ranked, Reels-ready videos. The main workflow is collection, cleaning/scoring, ranking, capped download, word-timed transcription, then vertical editing with karaoke subtitles and a configurable watermark. The README documents each stage; sampled code confirms the entry-point dispatch, file handoffs, and download/transcription/edit implementation. Config and logging form the shared internal layer. Some editing details and integrations are documented but only partially excerpted, so edges reflect shown calls or explicit README statements.

Main entry points: [`src/edit.py`](https://github.com/lmfrozza/autoclip/blob/main/src/edit.py) (Vertical editing), [`src/download.py`](https://github.com/lmfrozza/autoclip/blob/main/src/download.py) (Clip download), [`src/extracion.py`](https://github.com/lmfrozza/autoclip/blob/main/src/extracion.py) (Bronze collection), [`main.py`](https://github.com/lmfrozza/autoclip/blob/main/main.py) (Pipeline runner)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Clip workflow"]
  node_runner["Pipeline runner<br/>[main.py]"]
  node_bronze["Bronze collection<br/>[extracion.py]"]
  node_silver["Silver scoring<br/>[extracion.py]"]
  node_gold["Gold ranking<br/>[extracion.py]"]
  node_bronze_data["Bronze data"]
  node_silver_data["Silver data"]
  node_gold_data["Gold data"]
end

subgraph group_media["Media production"]
  node_download["Clip download<br/>[download.py]"]
  node_raw_media["Raw clips"]
  node_transcription["Word transcription<br/>[download.py]"]
  node_subtitles["Word subtitles"]
  node_editing["Vertical editing<br/>[edit.py]"]
  node_final_video["Edited videos"]
end

subgraph group_shared["Shared support"]
  node_config["Config and logging<br/>[config.py]"]
  node_settings["Pipeline settings<br/>[config.yaml]"]
  node_watermark["Watermark asset"]
end

node_operator(("Operator"))
node_twitch["Twitch API"]
node_yt_dlp["yt-dlp"]
node_whisper["faster-whisper"]
node_ffmpeg["FFmpeg encoding"]

node_operator -->|"runs"| node_runner
node_runner -->|"runs stages"| node_bronze
node_runner -->|"runs"| node_download
node_runner -->|"runs"| node_editing
node_bronze -->|"fetches clips"| node_twitch
node_bronze -->|"reads settings"| node_config
node_config -->|"loads"| node_settings
node_bronze -->|"writes"| node_bronze_data
node_bronze -->|"dispatches"| node_silver
node_silver -->|"reads"| node_bronze_data
node_silver -->|"writes"| node_silver_data
node_silver -->|"dispatches"| node_gold
node_gold -->|"reads"| node_silver_data
node_gold -->|"writes"| node_gold_data
node_download -->|"reads"| node_gold_data
node_download -->|"reads cap"| node_config
node_download -->|"downloads via"| node_yt_dlp
node_download -->|"writes clips"| node_raw_media
node_download -->|"runs"| node_transcription
node_transcription -->|"reads clips"| node_raw_media
node_transcription -->|"transcribes with"| node_whisper
node_transcription -->|"writes"| node_subtitles
node_editing -->|"reads clips"| node_raw_media
node_editing -->|"reads"| node_subtitles
node_editing -->|"reads watermark settings"| node_config
node_editing -->|"overlays"| node_watermark
node_editing -->|"encodes with"| node_ffmpeg
node_editing -->|"writes"| node_final_video

click node_runner "https://github.com/lmfrozza/autoclip/blob/main/main.py"
click node_bronze "https://github.com/lmfrozza/autoclip/blob/main/src/extracion.py"
click node_silver "https://github.com/lmfrozza/autoclip/blob/main/src/extracion.py"
click node_gold "https://github.com/lmfrozza/autoclip/blob/main/src/extracion.py"
click node_download "https://github.com/lmfrozza/autoclip/blob/main/src/download.py"
click node_transcription "https://github.com/lmfrozza/autoclip/blob/main/src/download.py"
click node_editing "https://github.com/lmfrozza/autoclip/blob/main/src/edit.py"
click node_config "https://github.com/lmfrozza/autoclip/blob/main/src/config.py"
click node_settings "https://github.com/lmfrozza/autoclip/blob/main/config.yaml"
click node_watermark "https://github.com/lmfrozza/autoclip/tree/main/assets"

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_runner,node_bronze,node_silver,node_gold,node_bronze_data,node_silver_data,node_gold_data toneBlue
class node_download,node_raw_media,node_transcription,node_subtitles,node_editing,node_final_video toneAmber
class node_config,node_settings,node_watermark,node_twitch toneMint
class node_operator,node_yt_dlp,node_whisper,node_ffmpeg toneIndigo
```

## Components

### Clip workflow

- [Pipeline runner](https://github.com/lmfrozza/autoclip/blob/main/main.py): `main.py`
- [Bronze collection](https://github.com/lmfrozza/autoclip/blob/main/src/extracion.py): `src/extracion.py`
- [Silver scoring](https://github.com/lmfrozza/autoclip/blob/main/src/extracion.py): `src/extracion.py`
- [Gold ranking](https://github.com/lmfrozza/autoclip/blob/main/src/extracion.py): `src/extracion.py`
- **Bronze data**
- **Silver data**
- **Gold data**

### Media production

- [Clip download](https://github.com/lmfrozza/autoclip/blob/main/src/download.py): `src/download.py`
- **Raw clips**
- [Word transcription](https://github.com/lmfrozza/autoclip/blob/main/src/download.py): `src/download.py`
- **Word subtitles**
- [Vertical editing](https://github.com/lmfrozza/autoclip/blob/main/src/edit.py): `src/edit.py`
- **Edited videos**

### Shared support

- [Config and logging](https://github.com/lmfrozza/autoclip/blob/main/src/config.py): `src/config.py`
- [Pipeline settings](https://github.com/lmfrozza/autoclip/blob/main/config.yaml): `config.yaml`
- [Watermark asset](https://github.com/lmfrozza/autoclip/tree/main/assets): `assets`

### Other components

- **Operator**
- **Twitch API**
- **yt-dlp**
- **faster-whisper**
- **FFmpeg encoding**

## Connections

- Operator → Pipeline runner: runs (evidence: `README.md`)
- Pipeline runner → Bronze collection: runs stages (evidence: `main.py`)
- Pipeline runner → Clip download: runs (evidence: `main.py`)
- Pipeline runner → Vertical editing: runs (evidence: `main.py`)
- Bronze collection → Twitch API: fetches clips (evidence: `src/extracion.py`)
- Bronze collection → Config and logging: reads settings (evidence: `src/extracion.py`)
- Config and logging → Pipeline settings: loads (evidence: `src/config.py`)
- Bronze collection → Bronze data: writes (evidence: `src/extracion.py`)
- Bronze collection → Silver scoring: dispatches (evidence: `src/extracion.py`)
- Silver scoring → Bronze data: reads (evidence: `src/extracion.py`)
- Silver scoring → Silver data: writes (evidence: `src/extracion.py`)
- Silver scoring → Gold ranking: dispatches (evidence: `src/extracion.py`)
- Gold ranking → Silver data: reads (evidence: `src/extracion.py`)
- Gold ranking → Gold data: writes (evidence: `src/extracion.py`)
- Clip download → Gold data: reads (evidence: `src/download.py`)
- Clip download → Config and logging: reads cap (evidence: `src/download.py`)
- Clip download → yt-dlp: downloads via (evidence: `src/download.py`)
- Clip download → Raw clips: writes clips (evidence: `src/download.py`)
- Clip download → Word transcription: runs (evidence: `src/download.py`)
- Word transcription → Raw clips: reads clips (evidence: `src/download.py`)
- Word transcription → faster-whisper: transcribes with (evidence: `src/download.py`)
- Word transcription → Word subtitles: writes (evidence: `src/download.py`)
- Vertical editing → Raw clips: reads clips (evidence: `README.md`)
- Vertical editing → Word subtitles: reads (evidence: `README.md`)
- Vertical editing → Config and logging: reads watermark settings (evidence: `src/edit.py`)
- Vertical editing → Watermark asset: overlays (evidence: `README.md`)
- Vertical editing → FFmpeg encoding: encodes with (evidence: `README.md`)
- Vertical editing → Edited videos: writes (evidence: `README.md`)
