kadr - GitLite

KO | EN

gitlite — search

#hacktoberfest #llm #golang #go #android #machine-learning #linux #nodejs #windows #cli #vue #pytorch #ios #openai

kadr

(★ 114)

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

File Explorer

Download Latest Version (.zip)

- claude.ts
- envelope.ts
- ffmpeg.ts
- fragments.ts
- kadr-skill.md
- main.ts
- mcp-bridge.cjs
- preload.ts
- transcribe.ts
- check-envelope.mjs
- e2e.mjs
- e2e10.mjs
- e2e11.mjs
- e2e12.mjs
- e2e13.mjs
- e2e14.mjs
- e2e15.mjs
- e2e16.mjs
- e2e17.mjs
- e2e18.mjs
- e2e19.mjs
- e2e2.mjs
- e2e20.mjs
- e2e21.mjs
- e2e22.mjs
- e2e23.mjs
- e2e24.mjs
- e2e25.mjs
- e2e26.mjs
- e2e27.mjs
- e2e28.mjs
- e2e29.mjs
- e2e3.mjs
- e2e30.mjs
- e2e31.mjs
- e2e32.mjs
- e2e33.mjs
- e2e4.mjs
- e2e5.mjs
- e2e6.mjs
- e2e7.mjs
- e2e8.mjs
- e2e9.mjs
- gen-test-media.sh
- transcribe.py
- envelope.ts
- paths.ts
- rawEncode.ts
- types.ts
- - AnimEditor.tsx
  - animUtils.ts
  - AudioMeter.tsx
  - CaptionsDialog.tsx
  - ClaudePanel.tsx
  - CtxMenu.tsx
  - ExportDialog.tsx
  - FragmentGizmo.tsx
  - FragmentOverlays.tsx
  - Inspector.tsx
  - MediaBin.tsx
  - NeonWaveDialog.tsx
  - Preview.tsx
  - SidePanel.tsx
  - TextTools.tsx
  - Timeline.tsx
  - TrackMotionEditor.tsx
  - TransportBar.tsx
- - anim.ts
  - audio.ts
  - autosave.ts
  - captions.ts
  - chime.ts
  - codecs.ts
  - demux.ts
  - exporter.ts
  - fragmentCapture.ts
  - fragments.ts
  - mediaImport.ts
  - neonWave.ts
  - normalize.ts
  - player.ts
  - proxy.ts
  - reverse.ts
  - snapshot.ts
  - subtitles.ts
  - text.ts
- - compositor.ts
  - edges.ts
  - glow.ts
  - transitions.ts
- - store.ts
- - mp4box.d.ts
- App.tsx
- env.d.ts
- i18n.ts
- main.tsx
- presets.ts
- styles.css
.gitignore
CLAUDE.md
demo.gif
electron.vite.config.ts
FEATURES.md
index.html
LICENSE
package-lock.json
package.json
README.en.md
README.md
tsconfig.node.json
tsconfig.web.json

// 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
  встроен.
- ✨ **Авто-субтитры** — один диалог: распознавание → анимированные
  караоке-титры (пословная подсветка, появления поп/подъём/фейд);
  позиция и размер — мышью прямо в превью.
- 🌊 **Неоновая волна** — аудио-реактивная светящаяся линия по громкости
  выделенного диапазона (весь микс или одна дорожка); стиль правится в
  коде фрагмента, огибающая — точный аналог «Bake Sound» из Blender.
- ⚛️ **Remotion-фрагменты** — программируемая моушн-графика (React/TSX)
  как клипы таймлайна. Живое превью с hot reload (никаких рендеров во
  время итераций!), автоматический режим захвата пикселей для GL-эффектов,
  3D и переходов на фрагменте, и ровно **один** настоящий рендер при
  экспорте (кэш по хешу содержимого). Код фрагментов лежит **в папке
  проекта** — проект переносится вместе со своей графикой.
- 🪟 **Видео с альфа-каналом** — прозрачные WebM (VP8/VP9+alpha), MOV
  (ProRes 4444) и HEVC с альфой сохраняют прозрачность и в превью, и в
  экспорте: под ними видно нижние дорожки, маски и эффекты работают
  как обычно.
- 🤖 **Встроенный Claude Code** — настоящая интерактивная сессия Claude в
  терминальной панели, подключённая к живому проекту через MCP: читает
  таймлайн, правит клипы, транскрибирует, создаёт и дорабатывает
  Remotion-фрагменты, пока вы смотрите превью. Панель перетаскивается,
  растягивается и помнит своё место между запусками.
- 📍 **Маркеры таймлайна** — клавиша **M** ставит нумерованный маркер на
  плейхеде: перетаскивается, удаляется правым кликом, живёт в проекте и
  **виден встроенному Claude** («правь от маркера 3 до маркера 4»).
- 📤 **Экспорт без компромиссов** — видео кодирует ffmpeg x264 с честным
  битрейтом пресета (кодировщик Chromium игнорировал битрейт и «мылил»
  картинку — измерено и заменено; кадры передаются в ffmpeg без единой
  копии), 8-сэмпловый motion blur, frame blending для исходников с
  «чужим» fps, пресеты YouTube/Shorts/WebM/MP3. По окончании рендера —
  короткий сигнал.
- 🚀 **Быстрый рендер на любом исходнике** — покадровая перемотка
  `<video>` стоит ~0.2 с на кадр, и редактор обходит её везде: видео с
  альфа-каналом (в том числе все прозрачные Remotion-фрагменты) читается
  через упакованный **без потерь** посредник, MP4 с индексом в конце
  файла — по «хвосту», недекодируемые кодеки — через H.264-посредник.
  Реальный проект на 11 минут с прозрачными фрагментами: **13 минут
  вместо нескольких часов** (58 кадров/с при 1080p60).
- 🛟 **Забота о работе** — фоновые 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)