# galihjuansaputra/cheat-clip-pro architecture

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

- Interactive diagram: https://gitdiagram.com/galihjuansaputra/cheat-clip-pro
- Repository: https://github.com/galihjuansaputra/cheat-clip-pro

## Overview

Cheat Clip PRO turns YouTube, Google Drive, or uploaded videos into short-form clips through AI-assisted analysis, studio customization, batch rendering, and downloads. The graph combines the documented user workflow with source-index and excerpt evidence for backend routing and service dependencies. Some UI-to-API and rendering details are documented capabilities rather than fully sampled call sites; these links are cited to the README where appropriate.

Main entry points: [`backend/main.py`](https://github.com/galihjuansaputra/cheat-clip-pro/blob/master/backend/main.py) (FastAPI App), [`backend/routers/analyze.py`](https://github.com/galihjuansaputra/cheat-clip-pro/blob/master/backend/routers/analyze.py) (Analysis Routes), [`src/App.tsx`](https://github.com/galihjuansaputra/cheat-clip-pro/blob/master/src/App.tsx) (App Workflow), [`backend/routers/render.py`](https://github.com/galihjuansaputra/cheat-clip-pro/blob/master/backend/routers/render.py) (Render Routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web App"]
  node_app["App Workflow<br/>[App.tsx]"]
  node_studio_ui["Studio Controls"]
  node_trim_ui["Clip Trimmer"]
  node_batch_ui["Batch Progress"]
  node_api_client["API Retry Client<br/>[api.ts]"]
end

subgraph group_api["API Surface"]
  node_api_app["FastAPI App<br/>[main.py]"]
  node_analyze_route["Analysis Routes<br/>[analyze.py]"]
  node_media_route["Media Routes<br/>[media.py]"]
  node_render_route["Render Routes<br/>[render.py]"]
  node_download_route["Download Routes<br/>[downloads.py]"]
  node_cookie_route["Cookie Routes<br/>[cookies.py]"]
  node_system_route["System Routes<br/>[system.py]"]
  node_config["Runtime Configuration<br/>[config.py]"]
end

subgraph group_analysis["Video Analysis"]
  node_analysis_contract["Analysis Models<br/>[analyze.py]"]
  node_ai["AI Clip Selection<br/>[ai_service.py]"]
  node_youtube["YouTube Metadata<br/>[youtube_service.py]"]
end

subgraph group_studio["Clip Studio"]
  node_render_service["Batch Rendering<br/>[render_service.py]"]
  node_render_contract["Render Settings<br/>[render.py]"]
  node_engine["Video Engine<br/>[video_engine.py]"]
end

subgraph group_sources["Media Sources"]
  node_gdrive["Drive Integration<br/>[gdrive_service.py]"]
  node_download_service["Raw Downloads"]
end

node_user(("Creator"))
node_gemini(("Google Gemini"))
node_youtube_service(("YouTube"))
node_drive_service(("Google Drive"))
node_media_store[("Local Media Files")]

node_user -->|"submits video"| node_app
node_app -->|"probes API"| node_api_client
node_app -->|"uses backend"| node_api_app
node_studio_ui -->|"customizes clips"| node_app
node_trim_ui -->|"adjusts clips"| node_app
node_app -.->|"shows progress"| node_batch_ui
node_api_app -->|"mounts routes"| node_analyze_route
node_api_app -->|"mounts routes"| node_media_route
node_api_app -->|"mounts routes"| node_render_route
node_api_app -->|"mounts routes"| node_download_route
node_api_app -->|"mounts routes"| node_cookie_route
node_api_app -->|"mounts routes"| node_system_route
node_analyze_route -->|"validates requests"| node_analysis_contract
node_analyze_route -->|"fetches metadata"| node_youtube
node_analyze_route -->|"selects moments"| node_ai
node_analyze_route -->|"handles Drive input"| node_gdrive
node_analyze_route -.->|"requests analysis"| node_gemini
node_youtube -->|"reads video data"| node_youtube_service
node_gdrive -.->|"reads source files"| node_drive_service
node_media_route -.->|"serves media"| node_media_store
node_render_route -->|"dispatches batches"| node_render_service
node_render_route -->|"accepts settings"| node_render_contract
node_render_service -->|"uses settings"| node_render_contract
node_render_route -.->|"renders clips"| node_engine
node_download_route -->|"starts downloads"| node_download_service
node_cookie_route -.->|"stores cookies"| node_media_store
node_system_route -->|"reads runtime config"| node_config
node_config -->|"imports engine APIs"| node_engine

click node_app "https://github.com/galihjuansaputra/cheat-clip-pro/blob/master/src/App.tsx"
click node_studio_ui "https://github.com/galihjuansaputra/cheat-clip-pro/blob/master/src/components/ClipStudioSection.tsx"
click node_trim_ui "https://github.com/galihjuansaputra/cheat-clip-pro/blob/master/src/components/ClipTrimmerModal.tsx"
click node_batch_ui "https://github.com/galihjuansaputra/cheat-clip-pro/blob/master/src/components/BatchRenderProgressModal.tsx"
click node_api_client "https://github.com/galihjuansaputra/cheat-clip-pro/blob/master/src/utils/api.ts"
click node_api_app "https://github.com/galihjuansaputra/cheat-clip-pro/blob/master/backend/main.py"
click node_analyze_route "https://github.com/galihjuansaputra/cheat-clip-pro/blob/master/backend/routers/analyze.py"
click node_media_route "https://github.com/galihjuansaputra/cheat-clip-pro/blob/master/backend/routers/media.py"
click node_render_route "https://github.com/galihjuansaputra/cheat-clip-pro/blob/master/backend/routers/render.py"
click node_download_route "https://github.com/galihjuansaputra/cheat-clip-pro/blob/master/backend/routers/downloads.py"
click node_cookie_route "https://github.com/galihjuansaputra/cheat-clip-pro/blob/master/backend/routers/cookies.py"
click node_system_route "https://github.com/galihjuansaputra/cheat-clip-pro/blob/master/backend/routers/system.py"
click node_analysis_contract "https://github.com/galihjuansaputra/cheat-clip-pro/blob/master/backend/schemas/analyze.py"
click node_ai "https://github.com/galihjuansaputra/cheat-clip-pro/blob/master/backend/services/ai_service.py"
click node_youtube "https://github.com/galihjuansaputra/cheat-clip-pro/blob/master/backend/services/youtube_service.py"
click node_gdrive "https://github.com/galihjuansaputra/cheat-clip-pro/blob/master/backend/services/gdrive_service.py"
click node_download_service "https://github.com/galihjuansaputra/cheat-clip-pro/blob/master/backend/services/download_service.py"
click node_render_service "https://github.com/galihjuansaputra/cheat-clip-pro/blob/master/backend/services/render_service.py"
click node_render_contract "https://github.com/galihjuansaputra/cheat-clip-pro/blob/master/backend/schemas/render.py"
click node_engine "https://github.com/galihjuansaputra/cheat-clip-pro/blob/master/backend/video_engine.py"
click node_config "https://github.com/galihjuansaputra/cheat-clip-pro/blob/master/backend/config.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_app,node_studio_ui,node_trim_ui,node_batch_ui,node_api_client toneBlue
class node_api_app,node_analyze_route,node_media_route,node_render_route,node_download_route,node_cookie_route,node_system_route,node_config,node_media_store toneAmber
class node_analysis_contract,node_ai,node_youtube toneMint
class node_render_service,node_render_contract,node_engine toneRose
class node_gdrive,node_download_service,node_user,node_gemini,node_youtube_service,node_drive_service toneIndigo
```

## Components

### Web App

- [App Workflow](https://github.com/galihjuansaputra/cheat-clip-pro/blob/master/src/App.tsx): `src/App.tsx`
- [Studio Controls](https://github.com/galihjuansaputra/cheat-clip-pro/blob/master/src/components/ClipStudioSection.tsx): `src/components/ClipStudioSection.tsx`
- [Clip Trimmer](https://github.com/galihjuansaputra/cheat-clip-pro/blob/master/src/components/ClipTrimmerModal.tsx): `src/components/ClipTrimmerModal.tsx`
- [Batch Progress](https://github.com/galihjuansaputra/cheat-clip-pro/blob/master/src/components/BatchRenderProgressModal.tsx): `src/components/BatchRenderProgressModal.tsx`
- [API Retry Client](https://github.com/galihjuansaputra/cheat-clip-pro/blob/master/src/utils/api.ts): `src/utils/api.ts`

### API Surface

- [FastAPI App](https://github.com/galihjuansaputra/cheat-clip-pro/blob/master/backend/main.py): `backend/main.py`
- [Analysis Routes](https://github.com/galihjuansaputra/cheat-clip-pro/blob/master/backend/routers/analyze.py): `backend/routers/analyze.py`
- [Media Routes](https://github.com/galihjuansaputra/cheat-clip-pro/blob/master/backend/routers/media.py): `backend/routers/media.py`
- [Render Routes](https://github.com/galihjuansaputra/cheat-clip-pro/blob/master/backend/routers/render.py): `backend/routers/render.py`
- [Download Routes](https://github.com/galihjuansaputra/cheat-clip-pro/blob/master/backend/routers/downloads.py): `backend/routers/downloads.py`
- [Cookie Routes](https://github.com/galihjuansaputra/cheat-clip-pro/blob/master/backend/routers/cookies.py): `backend/routers/cookies.py`
- [System Routes](https://github.com/galihjuansaputra/cheat-clip-pro/blob/master/backend/routers/system.py): `backend/routers/system.py`
- [Runtime Configuration](https://github.com/galihjuansaputra/cheat-clip-pro/blob/master/backend/config.py): `backend/config.py`

### Video Analysis

- [Analysis Models](https://github.com/galihjuansaputra/cheat-clip-pro/blob/master/backend/schemas/analyze.py): `backend/schemas/analyze.py`
- [AI Clip Selection](https://github.com/galihjuansaputra/cheat-clip-pro/blob/master/backend/services/ai_service.py): `backend/services/ai_service.py`
- [YouTube Metadata](https://github.com/galihjuansaputra/cheat-clip-pro/blob/master/backend/services/youtube_service.py): `backend/services/youtube_service.py`

### Clip Studio

- [Batch Rendering](https://github.com/galihjuansaputra/cheat-clip-pro/blob/master/backend/services/render_service.py): `backend/services/render_service.py`
- [Render Settings](https://github.com/galihjuansaputra/cheat-clip-pro/blob/master/backend/schemas/render.py): `backend/schemas/render.py`
- [Video Engine](https://github.com/galihjuansaputra/cheat-clip-pro/blob/master/backend/video_engine.py): `backend/video_engine.py`

### Media Sources

- [Drive Integration](https://github.com/galihjuansaputra/cheat-clip-pro/blob/master/backend/services/gdrive_service.py): `backend/services/gdrive_service.py`
- [Raw Downloads](https://github.com/galihjuansaputra/cheat-clip-pro/blob/master/backend/services/download_service.py): `backend/services/download_service.py`

### Other components

- **Creator**
- **Google Gemini**
- **YouTube**
- **Google Drive**
- **Local Media Files**

## Connections

- Creator → App Workflow: submits video (evidence: `README.md`)
- App Workflow → API Retry Client: probes API (evidence: `src/App.tsx`)
- App Workflow → FastAPI App: uses backend (evidence: `README.md`)
- Studio Controls → App Workflow: customizes clips (evidence: `src/App.tsx`)
- Clip Trimmer → App Workflow: adjusts clips (evidence: `src/App.tsx`)
- App Workflow → Batch Progress: shows progress
- FastAPI App → Analysis Routes: mounts routes (evidence: `backend/main.py`)
- FastAPI App → Media Routes: mounts routes (evidence: `backend/main.py`)
- FastAPI App → Render Routes: mounts routes (evidence: `backend/main.py`)
- FastAPI App → Download Routes: mounts routes (evidence: `backend/main.py`)
- FastAPI App → Cookie Routes: mounts routes (evidence: `backend/main.py`)
- FastAPI App → System Routes: mounts routes (evidence: `backend/main.py`)
- Analysis Routes → Analysis Models: validates requests (evidence: `backend/routers/analyze.py`)
- Analysis Routes → YouTube Metadata: fetches metadata (evidence: `backend/routers/analyze.py`)
- Analysis Routes → AI Clip Selection: selects moments (evidence: `backend/routers/analyze.py`)
- Analysis Routes → Drive Integration: handles Drive input (evidence: `backend/routers/analyze.py`)
- Analysis Routes → Google Gemini: requests analysis (evidence: `README.md`)
- YouTube Metadata → YouTube: reads video data (evidence: `README.md`)
- Drive Integration → Google Drive: reads source files
- Media Routes → Local Media Files: serves media
- Render Routes → Batch Rendering: dispatches batches (evidence: `backend/routers/render.py`)
- Render Routes → Render Settings: accepts settings (evidence: `backend/routers/render.py`)
- Batch Rendering → Render Settings: uses settings (evidence: `backend/services/render_service.py`)
- Render Routes → Video Engine: renders clips
- Download Routes → Raw Downloads: starts downloads (evidence: `backend/routers/downloads.py`)
- Cookie Routes → Local Media Files: stores cookies
- System Routes → Runtime Configuration: reads runtime config (evidence: `backend/routers/system.py`)
- Runtime Configuration → Video Engine: imports engine APIs (evidence: `backend/config.py`)
