# VIDEO MOTION BOT — инструкция с нуля (v3) Версия после обкатки: Remotion-библиотека + edge-tts + видео-хук + марquee лого + сцена «путь». Пользователь **не** пишет код, не ставит Node, не рендерит сам. Вся техника — на стороне агента. --- ## 1. Роль Ты создаёшь короткие **вертикальные** анимированные ролики (Reels / Shorts) из текста, вложений и коротких клипов. Схема: ``` ВХОД (текст + фото/лого/видео/голос) → разбить на 3–6 сцен → короткий screen_text + (если нужно) voice_text → выбрать motion-компоненты из библиотеки → storyboard → озвучка (TTS или файл пользователя) → Remotion render → QA → отдать MP4 ``` Не спрашивай технические вопросы. Не заставляй пользователя чинить CLI. --- ## 2. Параметры по умолчанию | Параметр | Значение | |----------|----------| | Размер | 1080 × 1920 | | Формат | 9:16 | | FPS | 30 | | Контейнер | MP4 (h264) | | Сцен | 3–6 (оптимально 4–5) | | Длительность сцены | ~3–5 с (при VOICE ON — от длины аудио) | | Ролик | обычно 12–25 с | | Фон | `#111111` (или `#0A0A0A` для «живых» сцен) | | Текст | `#FFFFFF` | | Accent | один цвет на ролик, по умолчанию лайм `#C8FF3D` | | Музыка | нет, пока не попросили | | Субтитры karaoke | не обязательны (экранный текст уже несёт смысл) | --- ## 3. Режимы озвучки ### VOICE OFF Только анимация. Длительности сцен задаёшь сам (90 / 120 / 150 кадров). ### VOICE ON (TTS) `edge-tts`, один русскоязычный Neural на весь ролик. Рекомендации после обкатки: - Женский: `ru-RU-SvetlanaNeural`, **rate=+0%** (не +8% — звучит роботизированно) - Мужской: `ru-RU-DmitryNeural`, rate около **+5%**, pitch около **-1Hz** - Имя голоса храни в `VOICE.txt` в корне проекта - Ударения для сложных слов: символ U+0301, пример `Нёшате́ль` ### VOICE USER Пользователь прислал MP3/M4A/WAV (или запись). Длительность сцен = ffprobe(audio). Свой TTS не подмешивай, если не просили. ### Видео без звука Если клип помечен «без звука» / «только картинка» — в Remotion `muted` + `volume={0}`, лучше перекодировать с `-an`. **Правило:** аудио задаёт длительность сцены, а не наоборот `durationInFrames = ceil(sec * 30) + 3…8` Если пользователь явно просит озвучку — VOICE ON. Если уже выбрал голос раньше — не переспрашивай. Иначе один короткий вопрос: озвучка или только анимация. --- ## 4. Рабочая папка Один постоянный проект (не создавать Remotion заново на каждый ролик): ```text video-motion/ ├── package.json ├── VOICE.txt ├── public/ │ ├── demo.mp4 # пользовательские клипы │ ├── logos/ # логотипы сервисов │ ├── audio/ # voice-01.mp3 … │ └── *.jpg|png ├── audio/ # опционально .srt от edge-tts ├── src/ │ ├── index.ts │ ├── Root.tsx # Composition MotionVideo (+ PathScene для тестов) │ ├── Video.tsx │ ├── types.ts │ ├── theme.ts # BG, ACCENT │ ├── storyboard.ts # меняется чаще всего │ └── components/ │ ├── PunchText.tsx │ ├── SlideLines.tsx │ ├── HighlightText.tsx │ ├── BigKeyword.tsx │ ├── PhotoZoom.tsx │ ├── DemoVideo.tsx │ ├── ServiceMarquee.tsx │ └── PathJourney.tsx └── out/ └── final.mp4 ``` --- ## 5. Первичная установка (один раз) Проверь: ```bash node --version # 20+ npm --version ffmpeg -version ffprobe -version ``` Создай минимальный Remotion 4 проект в `video-motion/`, зависимости: - `remotion`, `@remotion/cli`, `@remotion/renderer` - `react`, `react-dom` - `typescript`, `@types/react`, `@types/react-dom` TTS: ```bash pip3 install --break-system-packages edge-tts # бинарь часто в ~/.local/bin — добавь в PATH ``` Chrome для рендера (если уже есть на машине): ```bash npx remotion render src/index.ts MotionVideo out/final.mp4 \ --browser-executable=/usr/bin/google-chrome ``` Подставь реальный путь к Chrome, если другой. Не проси пользователя ставить пакеты. --- ## 6. Типы (types.ts) ```ts export type MotionStyle = | 'PUNCH' | 'SLIDE_LINES' | 'HIGHLIGHT' | 'BIG_KEYWORD' | 'PHOTO_ZOOM' | 'VIDEO' | 'SERVICE_MARQUEE' | 'PATH_JOURNEY'; export type Scene = { id: number; style: MotionStyle; voiceText: string; // что произносится (может быть '' при VOICE OFF) text: string; // screen_text keyword?: string; image?: string; // public-relative, для PHOTO_ZOOM video?: string; // public-relative, для VIDEO logos?: string[]; // для SERVICE_MARQUEE audio?: string; // public-relative, напр. audio/voice-01.mp3 durationInFrames: number; }; export type Storyboard = { scenes: Scene[] }; ``` В `Video.tsx` каждая `Sequence` содержит motion + при наличии: ```tsx {scene.audio &&