Repository navigation
Releases
SongFrame 1.1.0
SongFrame 1.1.0 — план можно сделать без агента и без платного сервиса, расход клипа считается сам, а тайминги, сценарий и производство получили много правок по живой работе над клипами.
Что нового
Производство без агента и вне приложения
- «Написать самому» — своё описание плана и свой видеопромпт; «Изменить» правит принятые. Сохранение проверяет текст теми же правилами, что ответ агента.
- «Загрузить своё видео» — готовый MP4 сразу становится результатом попытки, без описания, опор и промпта. До приёмки его можно «Заменить видео».
- Способ генерации «Вручную вне приложения» — для отдельной попытки или для всего проекта: приложение собирает пакет из опор и видеопромпта, видео вы делаете в любом сервисе и загружаете обратно, указав источник и, по желанию, стоимость.
- Речевой план у провайдера видео без синхронизации губ делается так же вручную: пакет с опорой, срезом речи и промптом и пошаговой инструкцией сервиса. «Слушать участок» проверяет срез до нарезки.
- Число опор выбирается перед подготовкой описания: «Авто» или точное число до предела провайдера.
- Видеопромпт длиннее предела провайдера нельзя утвердить, а утверждённый промпт можно «Вернуть на доработку» до отправки.
Расход и журнал отправок
- Каждая платная отправка записывается в журнал расхода проекта, включая отклонённые варианты. «Расход» в карточке плана и «Расход клипа» на странице «Проект» показывают суммы по сервисам и валютам; цену своего видео или неизвестного списания можно указать вручную.
- Новая страница «Отправки»: полный промпт, контекст, ответ и итог каждой отправки агенту и сервису генерации, с переходом к месту отправки.
Сценарий и тайминги
- «Пересчитать границы» переносит окна планов по новой разметке, не трогая постановку.
- Предупреждение о пересмотре сценария называет, что именно изменилось, и кнопки, которые его снимут.
- Тайминги: отмена и повтор правок (Ctrl+Z, Ctrl+Y), точная подстройка стрелками, прилипание к соседним строкам и плейхеду, части песни в списке строк. Клик по пустому месту волны ставит плейхед, не снимая выделения, Esc снимает выделение, Ctrl+колесо меняет масштаб без прокрутки страницы.
- Длинное слово на карточке аниматика больше не мешает применить сценарий, а ошибка применения видна над кнопками окна.
Прочее
- Частота кадров проекта 24, 25 или 30 выбирается при создании проекта.
- «Фрагмент под музыку» собирает несколько соседних планов под их участок песни без пересборки аниматика.
- Проверка видео агентом сверяет видео с «Событиями плана» из описания.
- Принятый план показывает свой комплект: видео, опоры, промпт и срез речи.
- Справка дополнена статьями о новых возможностях.
Обновление
Из приложения: «Настройки» → «Обновления приложения». Для deb приложение скачает пакет и подскажет команду установки.
- Проекты, созданные в 1.0.0, нужно один раз поправить вручную: добавьте в
plan/project.jsonстроку"fps": 30,(частота, в которой проект и был сделан). Без неё проверки реестра планов считают проект повреждённым. - Утверждение сценария и ожидающие предложения агента теперь хранятся в папке проекта и переезжают вместе с ней. Прежние записи не читаются: после обновления один раз нажмите «Утвердить текущие кастинг и трактовку» и «Утвердить текущий сценарий» на странице «Сценарий», перегенерировать ничего не нужно.
Установка
| Система | Файл | Требования |
|---|---|---|
| Linux x86_64 | songframe-1.1.0-linux-x86_64.AppImage |
Ubuntu 24.04 или новее (glibc 2.39) |
| Linux x86_64 | songframe-1.1.0-linux-amd64.deb |
Ubuntu 24.04 или новее: sudo apt install ./songframe-1.1.0-linux-amd64.deb |
| Windows | songframe-1.1.0-win-x64-setup.exe |
Windows 10 или 11, x64, без прав администратора |
FFmpeg, ONNX Runtime и модели по-прежнему ставятся кнопкой на странице «Компоненты».
Ограничения
- Установщик Windows проверен по составу, но в этой версии не запускался в Windows. Он не подписан: SmartScreen может показать предупреждение — «Подробнее» → «Выполнить в любом случае».
- macOS не поддерживается.
- Экспорт EDL и FCPXML не проверялся в монтажных программах.
SongFrame 1.0.0
SongFrame 1.0.0 — новая версия приложения на Go и Wails. Она заменяет прежнюю Electron-версию 0.x: те же страницы и тот же порядок работы над клипом, но приложение весит в разы меньше (AppImage 87 МБ вместо 447 МБ, установщик Windows 9,5 МБ вместо 312 МБ) и не требует Python.
Что внутри
- Все этапы работы над клипом: исходники и разметка песни, кастинг, сценарий с агентом, производство с согласованием платной отправки, проверки, аниматик, монтаж, производные планы и экспорт для монтажёра.
- Разметка песни по вокалу работает локально на процессоре (ONNX Runtime и русская CTC-модель), видеокарта не нужна.
- Обновление из приложения: «Настройки» → «Обновления приложения». AppImage и Windows-версия обновляются и перезапускаются сами, для deb приложение скачивает пакет и подсказывает команду установки.
Установка
Ставится с нуля, рядом с прежней версией.
| Система | Файл | Требования |
|---|---|---|
| Linux x86_64 | songframe-1.0.0-linux-x86_64.AppImage |
Ubuntu 24.04 или новее (glibc 2.39). При первом запуске приложение попросит пароль администратора, чтобы настроить AppArmor |
| Linux x86_64 | songframe-1.0.0-linux-amd64.deb |
Ubuntu 24.04 или новее: sudo apt install ./songframe-1.0.0-linux-amd64.deb |
| Windows | songframe-1.0.0-win-x64-setup.exe |
Windows 10 или 11, x64. Ставится в профиль пользователя без прав администратора; WebView2 установщик докачает сам, если его нет |
FFmpeg, ONNX Runtime и модели в установщик не входят. Приложение находит их в системе или скачивает кнопкой на странице «Компоненты» (около 550 МБ в Linux и 660 МБ в Windows). Без них проекты открываются и редактируются, недоступны только операции, которым они нужны.
Установщик Windows не подписан, поэтому SmartScreen может показать предупреждение: «Подробнее» → «Выполнить в любом случае».
Если у вас стояла версия 0.x
- Проекты клипов открываются как есть: формат не изменился, открытие проекта ничего в нём не меняет.
- Настройки, вход в агента и провайдеров генерации, история проектов и скачанные компоненты прежней версии не переносятся — их нужно настроить заново.
- Прежнюю версию можно удалить. Её кнопка «Обновить» тоже поставит 1.0.0, но настройки и в этом случае не перенесутся.
Ограничения
- macOS не поддерживается.
- Экспорт EDL и FCPXML проверен по содержимому файлов, но не открывался в монтажных программах.
SongFrame 0.5.0
В этом выпуске переработана разметка песни: меньше настроек на экране, больше контроля над отдельной строкой и стыком двух строк.
Разметка и прослушивание
- Меню «Распознать» разделяет автоматический и ручной режимы. В ручном редакторе виден весь исходный текст, включая строки без найденных границ и сомнительные предложения модели. Порядок строк можно менять перетаскиванием; фильтры помогают отдельно проверить оставшиеся и подтверждённые строки.
- У выбранной строки открываются поля времени и заметки. Во время правки допустимы незаконченный ввод и временные пересечения; проверка выполняется при сохранении. Подтверждённые строки защищены от случайного перемещения и изменения границ на шкале, клавиша V снимает подтверждение.
- Ctrl+Click выбирает соседнюю пару строк. Общая ручка двигает стык, сохраняя внешние границы пары. Общая панель под шкалой позволяет слушать и повторять выделение или только стык, а кнопки «Весь трек» и «Выделение» меняют масштаб. Shift позволяет выделить произвольный участок для прослушивания.
- Автоматические секции следуют текущей разметке, ручные сохраняются. Сомнительные границы показаны как предложения для проверки, а неизвестные промежутки больше не объявляются инструментальными паузами.
Локальное распознавание
- Можно распознавать исходный трек или сначала выделить вокал моделью Voc FT. Готовый вокал можно сравнить с оригиналом, выбрать для распознавания или удалить. Ранее подготовленные результаты других моделей остаются доступны.
- Приложение проверяет готовность моделей и предлагает скачать недостающие. Распознавание выбранного вокала использует именно этот WAV, включая уточнение границ. Исходный трек и текст песни сохраняются.
- Ход работы показан этапами; технические подробности свёрнуты. Отмена дожидается остановки задания. Случайный Esc или клик за пределами окна не прерывает работу.
- Улучшена обработка тишины и ложных повторов Whisper. Локальные модели могут ошибаться на пении: окончательные границы подтверждает человек. Проверка таймингов внешним агентом удалена.
Референсы, состояние объектов и окна
- Изображения референсов можно открывать крупно и выбирать как опоры для нового запроса. Для обложки можно явно выбрать нужный контекст и изображения, проверить и отредактировать промпт перед отправкой.
- Словарь свойств состояния отделён от выбранных полей объекта: удаление поля из конкретного состояния не удаляет его из словаря. Наследование и изменение состояния отображаются раздельно.
- Окна с черновиком или выполняющимся заданием защищены от случайного закрытия; важные пояснения показаны заметными сообщениями. Общие подсказки говорят об агенте, а имя выбранного исполнителя берётся из настроек.
- Исправлены сохранение заметок кандидатов, проверка длительности ровно 300 мс и удержание вокала до завершения использующих его заданий, в том числе из другого проекта.
Установка и обновление
| Система | Пакет |
|---|---|
| Linux x64 | AppImage |
| Windows x64 | Установщик |
В Linux разрешите выполнение AppImage и запустите его. В Windows запустите установщик: приложение ставится в профиль пользователя без прав администратора, обновление выполняется поверх предыдущей версии. Контрольные суммы SHA-256 приложены к выпуску.
Настройки и ранее загруженные модели сохраняются. Веса моделей устанавливаются отдельно из приложения; для ручной разметки они не нужны. Перед редактированием важных проектов рекомендуется обычная резервная копия их папок.
Код не подписан, поэтому Windows может показать предупреждение SmartScreen. AppImage проверен запуском в Linux-контейнере без сети; для Windows проверены сборка и состав установщика, нативный запуск в Windows в эту проверку не входил.
SongFrame 0.4.0
SongFrame 0.4.0 добавляет проверку готовых видео агентом и управляемую генерацию изображений референсов.
Что нового
- Проверка видео по постановке и опорам. Агент анализирует выбранные кадры результата, показывает замечания с таймкодами и ограничения проверки. Окончательное принятие видео остаётся за человеком; проверка кадров не подтверждает качество звука и движения.
- Конструктор промпта референса. Можно выбрать картинки-опоры, отдельно включить название, идею, текст песни, описание объекта и общие визуальные правила. Полный промпт виден и редактируется перед отправкой выбранному провайдеру изображений. По умолчанию включены только опоры и описание объекта.
- Примечания к опорам. Особенности отдельных изображений добавляются отдельным выключенным по умолчанию переключателем. Номера учитывают объединение одинаковых картинок, исключённые опоры не добавляют свой текст.
- Общее описание внешности. «Исходники» и «Кастинг» редактируют одно описание связанного объекта. Дополнение кастинга из исходников сохраняет выбранные картинки и их порядок.
Исправления
- Принятые результаты корректно учитываются в состоянии производства; исправлена обработка ответа агента при приёмке.
- Исходный промпт изображения явно обозначен как история создания и автоматически не включается в новые запросы.
- Ошибка проверки опор остаётся в диалоге. Для запущенного до изменения кода dev-приложения показывается необходимость перезапуска вместо белого экрана.
- Версия релиза теперь записана в
package.json; подготовка выпуска проверяет совпадение номера. Исправлены инструкции локальной сборки и проверки подсказок загрузки.
Установка
| Платформа | Файл |
|---|---|
| Linux x64 | AppImage · SHA256 |
| Windows x64 | Установщик · SHA256 |
Linux: проверьте SHA256, разрешите выполнение AppImage и запустите его. Windows: запустите установщик; обновление устанавливается поверх прежней версии в профиль пользователя без прав администратора. Пакеты не подписаны, поэтому Windows может показать предупреждение SmartScreen. Модель распознавания речи устанавливается отдельно.
AppImage проверен в Docker, включая разметку аудио и перенос приложения/проекта. Windows-установщик проверен по составу и ресурсам на Linux; нативный прогон Windows для этого выпуска не выполнялся.
SongFrame 0.3.0
Что нового
- Обновление из приложения. На странице «Настройки» появился блок «Обновления приложения». Кнопка «Проверить обновления» находит новую версию на GitHub, «Скачать обновление» загружает пакет вашей системы и сверяет его по SHA-256 из описания выпуска. «Установить и перезапустить» в Windows запускает установщик поверх текущей версии, а в Linux заменяет запущенный AppImage новым и перезапускает приложение. Без нажатия кнопки приложение в сеть за обновлениями не обращается. Проекты, настройки, история и модели распознавания при обновлении сохраняются.
Обновление проверено в Windows 11 и в Linux. Это первый выпуск с такой функцией, поэтому на 0.3.0 нужно перейти вручную, как раньше. Следующие версии можно будет ставить из приложения.
Установка
| Система | Файл | Как запустить |
|---|---|---|
| Linux x64 | songframe-0.3.0-linux-x86_64.AppImage | Разрешите выполнение файла (chmod +x или «Разрешить выполнение как программы» в свойствах) и откройте его вместо прежнего |
| Windows 10/11 x64 | songframe-0.3.0-win-x64-setup.exe | Запустите установщик: он обновит установленную версию, права администратора не нужны |
Рядом с файлами лежат их SHA256 и отчёты проверок сборки. Модель распознавания, как и раньше, скачивается отдельно кнопкой в окне «Тайминги → Разметить».
Ограничения
- Пакеты не подписаны: Windows может показать предупреждение SmartScreen («Подробнее» → «Выполнить в любом случае»).
- Claude Code или Codex и аккаунт провайдера генерации устанавливаются и оплачиваются отдельно.
SongFrame 0.2.0
Что нового
- Claude Code и Codex теперь работают и в Windows. Текстовые этапы — кастинг, сценарий, производственные предложения — запускаются кнопками приложения так же, как в Linux. Приложение само находит программу в
Path, в%USERPROFILE%\.local\bin(нативная установка Claude Code) и в%APPDATA%\npm(установка черезnpm install -g). Отмена и тайм-аут задания завершают программу вместе со всеми её дочерними процессами.
В Windows 11 проверены Codex, установленный через npm, его вход, текстовый этап и отмена задания. Claude Code и провайдер изображений, которого исполняет агент, в Windows пока не проверялись.
Установка
| Система | Файл | Как запустить |
|---|---|---|
| Linux x64 | songframe-0.2.0-linux-x86_64.AppImage | Разрешите выполнение файла (chmod +x или «Разрешить выполнение как программы» в свойствах) и откройте его |
| Windows 10/11 x64 | songframe-0.2.0-win-x64-setup.exe | Запустите установщик: он обновит установленную версию, права администратора не нужны |
Рядом с файлами лежат их SHA256 и отчёты проверок сборки. Модель распознавания, как и раньше, скачивается отдельно кнопкой в окне «Тайминги → Разметить».
Ограничения
- Пакеты не подписаны: Windows может показать предупреждение SmartScreen («Подробнее» → «Выполнить в любом случае»).
- Claude Code или Codex и аккаунт провайдера генерации устанавливаются и оплачиваются отдельно.
SongFrame 0.1.0
Первый выпуск SongFrame — настольного приложения для создания музыкального клипа с помощью ИИ: от трека, текста песни и идеи до аниматика и пакета для монтажёра. Каждый клип хранится в отдельной папке проекта на вашем компьютере. Подробнее — на сайте приложения.
Что умеет
- Исходники. Трек, текст песни, идея клипа, обложка (в том числе сгенерированная) и референсы персонажей, транспорта, локаций и собственных типов.
- Разметка песни. Локальное распознавание текста без отправки трека в облако, волна, правка границ строк и подтверждение на слух.
- Кастинг и сценарий. Герои и мир с изображениями и состояниями, трактовка по частям песни, планы с камерой и действием. Claude Code или Codex готовит предложения, которые можно просмотреть и доработать до применения.
- Производство. Опорные кадры и видео для каждого плана через выбранного в проекте провайдера генерации, импорт своих опор, отдельная приёмка результатов.
- Проверки, пробы и монтаж. Согласованность материалов, короткие пробы стыков, ручной монтаж пробы со звуком и экспортом MP4.
- Аниматик и экспорт. Сборка всего клипа по главам и пакет с медиа для монтажёра.
Платная генерация отправляется только после подтверждения: приложение показывает промпт, входные материалы, стоимость и остаток. Прерванная отправка сама не повторяется.
Установка
| Система | Файл | Как запустить |
|---|---|---|
| Linux x64 | songframe-0.1.0-linux-x86_64.AppImage | Разрешите выполнение файла (chmod +x или «Разрешить выполнение как программы» в свойствах) и откройте его |
| Windows 10/11 x64 | songframe-0.1.0-win-x64-setup.exe | Запустите установщик: права администратора не нужны, приложение ставится в профиль пользователя, ярлыки появятся на рабочем столе и в меню «Пуск» |
Python, FFmpeg и клиенты встроенных провайдеров генерации уже входят в поставку. Рядом с файлами лежат их SHA256 и отчёты проверок сборки.
Модель распознавания скачивается отдельно — кнопкой в окне «Тайминги → Разметить». Видеокарта не обязательна. Подробности — в README.
Ограничения
- Пакеты не подписаны: Windows может показать предупреждение SmartScreen («Подробнее» → «Выполнить в любом случае»).
- Запуск Claude Code и Codex из приложения пока работает только в Linux; там же работает провайдер изображений, которого исполняет агент. Просмотр, редактирование, разметка и встроенные провайдеры генерации доступны в обеих системах.
- Claude Code или Codex и аккаунт провайдера генерации устанавливаются и оплачиваются отдельно.
- Сборки для macOS нет.