Большинство медиа-библиотек для Go рано или поздно упираются в одну и ту же проблему.

У них нет собственного декодера.

Вместо этого они полагаются на установленный в системе пакет FFmpeg, shared библиотеки, платформозависимые DLL или внешние исполняемые файлы, которые должны присутствовать на целевой системе.

На этапе разработки всё работает. Затем начинается развертывание.

И внезапно вы отлаживаете отсутствующие DLL в Windows, несовместимые версии FFmpeg в Linux, различия версий из Homebrew на macOS, образы контейнеров без нужных библиотек или продуктовые серверы, где рядовое обновление пакета неожиданно ломает обработку медиа.

Цель

Мне нужен был декодер, который:

• Работает на чистом коде Go

• Собирается в единый бинарник

• Не требует установки FFmpeg или других рантайм зависимостей

• Поддерживает современные кодеки, такие как AV1, H.264, H.265, VP8, VP9, Opus, AAC, MP3 и другие

• Может читать из файлов, буферов памяти, HTTP-потоков, пайпов, SSH-потоков и любого io.Reader

Результат — gopeg.

Вместо того чтобы зависеть от того медиа-стека, который установлен на машине, необходимые компоненты FFmpeg и декодер dav1d статически линкуются в приложение на этапе сборки (с использованием cgo).

Когда бинарник готов, всё необходимое для декодирования видео уже находится внутри.

Почему это важно

Огромное количество времени уходит на решение проблем развёртывания, а не прикладных задач. Типичный пайплайн при обработке медиа часто выглядит так:

• Установить FFmpeg

• Установить совместимые shared библиотеки

• Корректно их упаковать

• Убедиться, что на продуктовых машинах стоят совместимые версии

• Надеяться, что будущие обновления операционной системы ничего не сломают

Приложение становится зависимым от внешнего состояния. Со статической линковкой сценарий развёртывания становится гораздо проще: go build и всё.

Никаких внешних пакетов кодеков. Никаких DLL. Никакого поиска библиотек во время выполнения и кривых cmd.Exec. Без фраз - «у меня на тачке всё работает».

Поддержка io.Reader

Ещё одной целью дизайна была гибкость. Декодеру не нужен прямой доступ к файлу. Он должен уметь работать с произвольными потоками:

resp, _ := http.Get(url)
dec, err := gopeg.NewDecoder(resp.Body)

Или:

dec, err := gopeg.NewDecoder(os.Stdin)

Или даже с данными, поступающими через SSH-соединение или кастомный транспорт. Библиотека при наличии Seek() у источника дает возможность извлечения метаданных (ps, если видео является стримом то невозможно будет корректно получить длительность).

Простота вместо абстракции

Одно из моих главных желаний было избежать создания громоздкого фреймворка. API специально сделан максимально простым.

Открываем источник:

dec, err := gopeg.NewDecoder(file)

Читаем метаданные:

meta := dec.Meta()

Декодируем кадры:

for {
    frame, err := dec.DecodeFrame()
    if err != nil {
        panic(err)
    }
    if frame == nil {
      break
    }
    // обрабатываем кадр
}

Никаких фоновых воркеров, скрытых процессов, внешних зависимостей. Чистый гошный интерфейс с каноничными типами.

Заключение

FFmpeg — потрясающий продукт, но зависимость от системной установки FFmpeg создаёт эксплуатационную сложность, которая на самом деле не нужна многим приложениям. Для моих задач статически слинкованный подход оказался более осмысленным, также получилось выиграть в размере финальной сборки. Результат — медиа-декодер, который легко встроить, легко развернуть и который предсказуемо работает в любом окружении.

Результат сборки - один self-contained бинарный файл который содержит всё необходимое для декода видео.

Поэтому gopeg - первое законченное решение на go, предоставляющее доступ ко всем современным декодерам, не обязывающее устанавливать платформенные dll или внешние пакеты, что делает библиотеку кратно более удобной при развертывании.

Резервный репозиторий: https://codeberg.org/d1nch8g/gopeg