Skip to content

The VS Code of video editing, built for agents.

TypeScript

Update README with improved project description

Konstantin Paulusd9f5909a6afb
diff --git a/README.md b/README.md
index 027019a2..16864d20 100644
--- a/README.md
+++ b/README.md
@@ -27,15 +27,13 @@
<br />
-## Why Diffusion Studio
+## Diffusion Studio
-Diffusion Studio is an open-source video editor that uses [SolidJS](https://www.solidjs.com) modules as the document source. Think IDE, but it renders a video canvas instead of text.
+Edit videos with Codex, Claude Code, OpenCode, or Pi. Refine any output in a fully featured editing environment.
-This goes both ways: edit on the canvas and the change lands in the code; edit the code and the canvas redraws.
+Every edit you make is written to real code, so the agent always sees the latest version. A Headless mode is available too.
-The desktop app comes with a command line that lets agents watch and listen to your footage and cut it on a timeline.
-
-## What it's for
+## What people do with it
Drop your raw footage and files into a folder, then ask for the video you want. That's it.
@@ -55,6 +53,14 @@ Beyond finishing a cut, it covers:
- **Clipping**: highlights from a long video, reformatted for social
- **Video understanding**: summaries, scene search, quotes with timestamps
+## How it works
+
+Diffusion Studio uses [SolidJS](https://www.solidjs.com) modules as the document source. Think IDE, but it renders a video canvas instead of text.
+
+Editing works both ways: change something on the canvas and the code updates; change the code and the canvas redraws.
+
+The desktop app includes command-line tools that let agents watch and listen to footage, edit it on a timeline, and render the result.
+
## Getting started
Download the desktop app, it walks you through setting everything up: