y83 code / справочник

Видеоредактор

Монтаж видео прямо на телефоне: несколько клипов на одной дорожке, обрезка, разделение, переходы между клипами и готовый файл на выходе.

раздел
Подсистемы приложения
пунктов возможностей
29
источник
docs/about/video.md

Раздел пока недоступен. Редактор в статусе preview-сборки: интерфейс и рендер написаны и работают, но инструмент намеренно выключен в каталоге хаба — карточка серая и не нажимается. Открыть редактор можно только с экрана записи экрана: под списком прошлых записей там есть кнопка «Открыть видеоредактор». Когда выключение будет снято, карточка появится в хабе сама.

Возможности

  • Клипы на дорожке: добавить любой видеофайл через системный выбор файлов (в том числе из галереи) или взять готовый ролик из записанных вами записей экрана. Клип можно удалить или поменять местами с другим — чтобы переставить, на него надо нажать и подержать, а потом вести в сторону.
  • Файл клипа копируется внутрь папки проекта, поэтому исходник из галереи можно потом спокойно удалить — монтаж не сломается.
  • Обрезка клипа по краям: тянуть ползунок на краю клипа или двигать этот край по одному кадру кнопками «−1» и «+1».
  • Разделение клипа в текущей точке: из одного клипа становится два.
  • Скорость: 0.25×, 0.5×, 1×, 1.5×, 2× — меняется на каждом клипе отдельно.
  • Переходы между соседними клипами: 10 видов — затухание, растворение, шторка слева, шторка справа, круг открывается, круг закрывается, радиальная заливка, пикселизация, наезд, проявление слева. Длительность настраивается, по умолчанию 0.5 секунды.
  • Отмена и повтор: помнит последние 30 правок, поэтому кнопки иногда сереют — когда отменять больше нечего.
  • Формат итогового файла: вертикальный 1080×1920, квадрат 1080×1080, горизонтальный 1920×1080 или как в исходнике.
  • Экспорт: приложение показывает процент готовности, отменяет рендер и предлагает повторить, если рендер упал.
  • Проект сохраняется сам после каждой правки. При следующем запуске редактора открывается тот проект, который меняли последним, — а не пустой монтаж. Если проектов накопилось несколько, новый автоматически не создаётся: редактор продолжит последний, а предыдущие останутся лежать на диске.

Технические данные

ПараметрЗначение
Статус в хабевыключен, preview-сборка
Входзапись экрана → «Открыть видеоредактор»
Частота кадров проекта30 кадров в секунду
Движок быстрого экспортаMedia3 Transformer, внутри приложения
Движок точного экспортаffmpeg в Termux, через локальный сервис
Вариантов перехода10
Скорости клипа0.25×, 0.5×, 1×, 1.5×, 2×
Где хранится проект«Загрузки/y83ws/projects/<id>/project.json»
Копии исходников«Загрузки/y83ws/projects/<id>/sources»
Готовые файлы«Загрузки/y83ws/projects/<id>/exports»
Формат проекта на дискеобычный JSON-файл, открывается текстовым редактором
Субтитры, текст, звуковая нормализацияне поддерживаются
Работа агентачитать монтаж, запускать запись, открывать экран

Два разных экспорта

Путь выбирается сам, в зависимости от монтажа:

  • Быстрый — Media3 Transformer, целиком внутри приложения. Обрезка, склейка, скорость. Работает без Termux, без сервера и без интернета. Клипы склеиваются в один файл, но каждый остаётся целым: перекрытия и смешивания не делаются. Выбранный формат кадра применяется как пропорция: ролик вписывается в неё, а лишнее закрывается чёрными полями сверху и снизу. Разрешение исходника при этом не меняется.
  • Точный — ffmpeg, запущенный в Termux на этом же телефоне через локальный сервис. Нужен, когда в проекте есть переходы: в быстром пути перекрытие клипов просто не склеивается. Здесь формат кадра применяется по-настоящему: файл получается ровно выбранного размера, а кадр вписывается в него с чёрными полями. Без установленного ffmpeg в Termux экспорт падает с понятным сообщением. Если в клипе нет звуковой дорожки, на её место подставляется тишина, чтобы дорожки совпали при склейке.

Оба пути пишут mp4 в одну и ту же папку экспорта и показывают процент готовности: в быстром — считает само приложение, в точном — спрашивает у локального сервиса. Одновременно два рендера не запускаются: пока идёт первый, второй не стартует и получает сообщение «рендер уже идёт».

Как это выглядит

Четыре вкладки:

  • Таймлайн — шкала с клипами, линейкой времени и маркерами переходов. Масштаб меняется тремя кнопками: «−» уменьшает, «+» увеличивает, «вписать» подгоняет всю длительность ролика под ширину экрана. Рядом показывается текущая плотность шкалы в пикселях на секунду. Перемотка — вести пальцем влево-вправо по линейке.
  • Клип — обрезка краёв по кадрам, скорость, удаление клипа.
  • Переход — вид и длительность перехода между двумя клипами. Появляется только когда клипов хотя бы два; выбирается на стыке на шкале.
  • Ещё — формат кадра, экспорт и список записей экрана: оттуда любой ролик добавляется в монтаж одним нажатием.

Точное перекрытие видно только в итоговом файле: в предпросмотре приложение показывает честную подпись, что настоящий вид перехода появится после экспорта.

Про правила монтажа

  • Разделить клип можно не ближе, чем на минимальную длину с обоих краёв. Если поставить точку у самого начала или конца, приложение откажется и скажет, что точка слишком близко к краю клипа.
  • Длительность перехода не может превышать половину более короткого из двух клипов — иначе они наезжали бы друг на друга. Ползунок длительности сам упрётся в этот предел.
  • Если более короткий клип короче 0.2 секунды, переход недоступен совсем: приложение покажет, что клипы слишком короткие.
  • Клип не может быть короче 0.2 секунды — при 30 кадрах в секунду это 6 кадров. Минимум считается по исходному файлу, поэтому на ускоренном клипе исходник должен быть длиннее: на скорости 2× нужно не меньше 0.4 секунды исходника, а на таймлайне клип всё равно займёт те же 0.2 секунды.

Где это живёт на диске

Проект — не запись в базе, а обычная папка с файлом project.json и копиями исходников. Так выбрано потому, что этот же каталог нужен и Termux, и ffmpeg: папка «Загрузки» уже открыта Termux, и рендер читает проект оттуда напрямую.

Практическое следствие: удалили папку проекта — потеряли монтаж целиком, вместе с копиями исходников. Плюс копии исходников не прячутся: они лежат в «Загрузках» обычными файлами и видны любому приложению и файловому менеджеру.

Что агент умеет с видеоредактором

  • Посмотреть состояние монтажа: название проекта, сколько клипов, итоговая длительность, формат кадра, можно ли уже экспортировать, а по каждому клипу — путь к файлу, начало, конец, скорость и длина на таймлайне. Без указания проекта берётся последний изменённый. Проект читается с диска, поэтому открывать редактор для этого не нужно.
  • Запустить и остановить запись экрана, чтобы получить свежий материал для монтажа, и открыть экран записи, чтобы вы увидели настройки глазами.
  • Открыть редактор и снять скриншот экрана, если хочется посмотреть, что там сейчас происходит.

Чего агент не умеет: монтировать. Ни отдельных инструментов, ни команд для добавления клипа, обрезки, склейки, разделения и экспорта нет — агент может только читать. Смонтировать вручную, а потом попросить агента показать результат или проверить, что получилось, — единственный доступный сценарий.

Ограничения

  • В хабе инструмент выключен: карточка серая, по ней не войти.
  • Переходы нельзя посмотреть в предпросмотре — только в готовом файле.
  • Переход требует установленного ffmpeg в Termux: без него точный экспорт не запустится, об этом выводится сообщение.
  • Субтитры, наложенный текст, картинки поверх видео и звуковая нормализация не поддерживаются.
  • Проект не хранится в базе — удалённая папка на диске удаляет монтаж.
  • История отмены живёт только в памяти открытого редактора и сбрасывается при перезапуске. Сами правки в файле проекта остаются — отмены у них нет.

Источник: docs/about/video.md. Страница собрана из документации проекта при сборке сайта — без пересказа.