KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #developer-tools #ai-agent #claude-code #codex #typescript #ai-agents #deepseek-harness #mcp #cli #rust

kadr

★ 111 Open GitHub ↗

AI-native GPU-accelerated video editor with Claude Code built into the timeline

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Kadr

**ИИ-нативный видеоредактор с GPU-ускорением — и с Claude Code прямо в таймлайне.**

[English version →](README.en.md) · [Полное руководство по функциям →](FEATURES.md) · [Video →](https://www.youtube.com/watch?v=1RKRtRgzE24)

[![License: GPL-3.0](https://img.shields.io/badge/License-GPL_3.0-blue.svg)](https://raw.githubusercontent.com/HelpFreedom/kadr/main/LICENSE)

Поддержать меня можно на Boosty: https://boosty.to/triangle_black/

![Демо Kadr](https://raw.githubusercontent.com/HelpFreedom/kadr/main/demo.gif)

Kadr — многодорожечный видеоредактор (Electron + React + TypeScript),
построенный вокруг одной идеи: *ИИ-агент должен монтировать видео рядом с
вами, на том же таймлайне, теми же инструментами.* Нажмите 🤖, напишите
«добавь сюда анимированные субтитры» — и смотрите, как это происходит
вживую в превью.

## Возможности

- 🎬 **Полноценный многодорожечный монтаж** — видео/аудио/текстовые
  дорожки, трим, луп, фейды, связанные AV-клипы, полная история отмен.
  Скорость ×0.02–×100 Ctrl-драгом за **любой** край клипа (левый якорит
  правую границу) с прилипанием к круглым множителям и краям соседних
  клипов и живым бейджем «×N» у курсора.
- 📥 **Медиа отовсюду** — перетащите файлы в любое место окна (на
  дорожку — лягут клипами встык в точку броска, аудио уйдёт на свою
  дорожку), картинку прямо из браузера (скачается по URL), или нажмите
  Ctrl+V — вставка из буфера обмена понимает и скопированные файлы, и
  «Копировать изображение» (например, из Telegram, который фото
  перетаскиванием не отдаёт). Поддержаны и XDG-портальные перетаскивания
  из песочных приложений. В медиапанели — множественное выделение и
  удаление файлов вместе с их клипами на таймлайне (одна отмена).
- ⚡ **GPU-композитинг (WebGL2)** — превью и есть рендер: один и тот же
  компоновщик рисует оба, экспорт пиксель-в-пиксель WYSIWYG.
- 🔑 **Ключевые кадры везде** — позиция, масштаб, поворот, прозрачность,
  громкость, маски; рабочий процесс в стиле After Effects.
- 🧊 **Настоящее 3D** — наклоны и глубина клипа, «полёт камеры» целой
  дорожкой, перспективно-корректные текстуры.
- 🎭 **Маски** — анимируемые кромки + до 8 фигур с растушёвкой
  (прямоугольник/эллипс/треугольник, инверсия).
- 🌫️ **Эффекты: дымное внешнее сияние и размытие** — сияние из клубов
  billow-шума с рваными щупальцами и искрами; гауссово размытие слоя с
  ползунком интенсивности; всё параметрично, сохраняется в пресеты и
  идентично в превью и рендере.
- ⏪ **Реверс клипа** — правый клик → «Реверсировать»: используемый кусок
  исходника рендерится задом наперёд (с кэшем), связанная AV-пара
  переворачивается синхронно, повторный клик мгновенно возвращает
  оригинал.
- 🔀 **26 переходов** — 14 переходов наложения (Vegas-стиль: просто
  перекройте два клипа) и 12 кинематографичных торцевых (вип-паны,
  зум-блюры, RGB-расхождение, глитч…) со спектральным смазом.
- 🗣️ **Локальное распознавание речи** — faster-whisper (large-v3) с
  пословными таймкодами и серьёзной защитой от галлюцинаций (чистый тон
  обязан дать *ноль* реплик — закреплено тестами). Редактор SRT/TXT
  встроен.
- ✨ **Авто-субтитры** — один диалог: распознавание → анимированные
  караоке-титры (пословная подсветка, появления поп/подъём/фейд);
  позиция и размер — мышью прямо в превью.
- ⚛️ **Remotion-фрагменты** — программируемая моушн-графика (React/TSX)
  как клипы таймлайна. Живое превью с hot reload (никаких рендеров во
  время итераций!), автоматический режим захвата пикселей для GL-эффектов,
  3D и переходов на фрагменте, и ровно **один** настоящий рендер при
  экспорте (кэш по хешу содержимого).
- 🤖 **Встроенный Claude Code** — настоящая интерактивная сессия Claude в
  терминальной панели, подключённая к живому проекту через MCP: читает
  таймлайн, правит клипы, транскрибирует, создаёт и дорабатывает
  Remotion-фрагменты, пока вы смотрите превью. Панель перетаскивается,
  растягивается и помнит своё место между запусками.
- 📤 **Экспорт без компромиссов** — видео кодирует ffmpeg x264 с честным
  битрейтом пресета (кодировщик Chromium игнорировал битрейт и «мылил»
  картинку — измерено и заменено; кадры передаются в ffmpeg без единой
  копии), быстрый декод на mp4box (~8× быстрее перемоток, с
  автоматическим откатом), 8-сэмпловый motion blur, frame blending для
  исходников с «чужим» fps, пресеты YouTube/Shorts/WebM/MP3.
- 🛟 **Забота о работе** — фоновые 540p-прокси для превью, автосохранение
  раз в 5 минут (атомарное, не мешает рендеру и ИИ-сессиям), индикатор
  несохранённых изменений и «✓ Сохранено», самовосстановление после
  жёсткого закрытия (никаких зависших процессов), пресеты эффектов и
  поз, общие для всех проектов, интерфейс RU/EN.
- 🔒 **Чистый `npm audit`** — Electron 42 / Chromium 148, vite 7,
  свежий tar: 0 известных уязвимостей в зависимостях (спасибо
  [@Antony-hash512](https://github.com/Antony-hash512) за
  [issue #1](https://github.com/HelpFreedom/kadr/issues/1)).

## Требования

| Компонент | Для чего | Примечание |
|---|---|---|
| Node.js ≥ 20 | всё | |
| ffmpeg + ffprobe | импорт, аудиомикс, экспорт | любая свежая сборка в PATH |
| python3 + [faster-whisper](https://github.com/SYSTRAN/faster-whisper) | распознавание речи, авто-субтитры | `pip install faster-whisper`; модели скачаются при первом запуске |
| [Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code) | панель 🤖 | опционально; использует ваш существующий вход |
| сеть (один раз) | workspace Remotion-фрагментов | `~/kadr-fragments`, ~150 МБ |

## Запуск

```bash
git clone https://github.com/HelpFreedom/kadr.git && cd kadr
npm install        # postinstall пересоберёт node-pty под Electron
npm run dev
```

Импортируйте медиа, монтируйте, жмите «Экспорт». Для ИИ-ассистента
нажмите 🤖 (CLI `claude` должен быть установлен и залогинен). Если для
Claude/npm нужен прокси — создайте `~/.config/kadr/claude-env.json`:

```json
{ "env": { "HTTPS_PROXY": "http://127.0.0.1:1080", "NO_PROXY": "127.0.0.1,localhost" } }
```

## Как устроена ИИ-интеграция

Kadr поднимает локальный мост в рендерер и отдаёт Claude MCP-сервер с
пятью инструментами:

| Инструмент | Что делает |
|---|---|
| `kadr_state` | весь живой проект: дорожки, клипы, пути медиа, транскрипты, пресеты |
| `kadr_eval` | выполнить JS против API редактора (каждая правка — в истории отмен) |
| `kadr_export` | отрендерить проект или диапазон и дождаться файла |
| `kadr_transcribe` | локальный Whisper по файлу или диапазону таймлайна |
| `kadr_fragment_create` | создать Remotion-композицию как клип таймлайна |

Главный цикл: Claude создаёт фрагмент, правит его TSX обычными файловыми
инструментами — vite горячо перезагружает превью за ~2 секунды. Вы даёте
правки обычным языком; рендер один — финальный.

## Тесты

E2E-тесты управляют настоящим приложением через Chrome DevTools Protocol:

```bash
npx electron-vite dev -- --remote-debugging-port=9777   # терминал 1
node scripts/e2e13.mjs                                  # терминал 2 (и т. д.)
```

Покрыто: переходы, сияние, пресеты, прокси, точность экспорта
(PSNR быстрого пути против отката), motion blur, каденс frame blending,
MCP-мост, антигаллюцинационный контракт транскрипции, фрагменты и режим
захвата, семантика автосохранения, авто-субтитры.

## Документация

- [FEATURES.md](FEATURES.md) — полное руководство по функциям (1200+ строк).
- [CLAUDE.md](CLAUDE.md) — карта архитектуры (её же читает Claude Code).

## Лицензия

[GPL-3.0](LICENSE)

kadr

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README