# Как установить VividFrame-GPU и настроить апскейл видео в реальном времени

> AI Release · @ai_release1 · https://ai-release.org/guides/kak-ustanovit-vividframe-gpu-i-nastroit-apskeyl-video-v.html

## TL;DR

- Время выполнения: 25–40 минут
- Уровень сложности: Intermediate
- Понадобится: NVIDIA GPU с драйвером (проверка через `nvidia-smi`), FFmpeg со сборкой NVENC, OBS Studio с виртуальной камерой, для Linux — пакет `v4l2loopback-dkms`, права администратора/root, ≥ 5 ГБ свободного места под тестовую запись

**Оговорка по фактам:** в исходных постах канала нет ни одной команды, версии или цифры, относящейся к самому пакету VividFrame-GPU. Поэтому все вызовы утилиты помечены плейсхолдерами `<...>` — их значения сверьте с документацией проекта. Полностью проверяемы стандартные шаги: проверка GPU, сборка цепочки апскейла на FFmpeg/NVENC, вывод в виртуальную камеру.

## Требования и подготовка
![Иллюстрация к разделу «Требования и подготовка»](https://ai-release.org/guides/img/kak-ustanovit-vividframe-gpu-i-nastroit-apskeyl-video-v-ru-1.jpg?v=1795185786)


- ОС: Windows 10/11 x64 или Linux с установленным проприетарным драйвером NVIDIA.
- GPU NVIDIA с аппаратным кодеком NVENC — это отдельный блок видеокарты, который сжимает видео без нагрузки на процессор.
- FFmpeg — сборка, в которой включён NVENC (в «стоковых» сборках из репозиториев он есть не всегда).
- OBS Studio — для Windows это основной способ отдать картинку как виртуальную камеру.
- Linux: `v4l2loopback-dkms` — модуль ядра, создающий «фальшивую» камеру `/dev/videoN`.
- Свободное место: ≥ 5 ГБ, если планируете записывать тестовый файл для сравнения «до/после».

**Что сделать:** убедиться, что GPU, драйвер и кодеки на месте — до любых установок.

**Зачем:** 9 из 10 сбоев реального времени — это не настройка фильтров, а отсутствующий NVENC или неверно определённое устройство ввода.

**Как проверить:** три команды ниже.

```bash
nvidia-smi
```

Ожидаемый результат — таблица с моделью GPU, строкой `Driver Version: <версия>` и занятой видеопамятью в MiB. Если вы видите `nvidia-smi: command not found` — драйвер не установлен или не в PATH.

```bash
ffmpeg -hide_banner -encoders | grep -E "nvenc"
```

В PowerShell: `ffmpeg -hide_banner -encoders | Select-String nvenc`. Ожидаемый вывод — строки вида:

```
 V....D h264_nvenc           NVIDIA NVENC H.264 encoder
 V....D hevc_nvenc           NVIDIA NVENC HEVC encoder
```

```bash
ffmpeg -hide_banner -filters | grep -E " (scale|cas) "
```

Здесь проверяются два фильтра: `scale` (сам апскейл — растяжение кадра до целевого разрешения) и `cas` (contrast adaptive sharpening — адаптивное повышение резкости, компенсирующее «мыло» после растяжения). Если `cas` в выводе нет — уберите его из команд дальше, цепочка продолжит работать.

**Пример:** на машине с одной GPU вывод `nvidia-smi` содержит одну строку `0  <модель>  ...  <N>MiB / <M>MiB`; если строк несколько, для кодирования берите ту, где свободно больше памяти.

## Шаг 1. Установка VividFrame-GPU и фиксация входного устройства

**Что сделать:** установить пакет VividFrame-GPU штатным для вашей ОС способом из документации проекта и параллельно определить точное имя устройства ввода, с которого будет читаться видео.

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

**Как проверить:** утилита отвечает на вызов версии, а FFmpeg видит устройство в списке.

```bash
# установочная команда и имя бинарника — из документации VividFrame-GPU
<команда-установки-из-документации>
<бинарник-vividframe-gpu> --version
```

Ожидаемый результат: строка с версией без трейсбека. Точный флаг версии сверьте с документацией — в постах канала он не зафиксирован.

Список камер:

```bash
# Linux
ls -l /dev/video*
# Windows (PowerShell): перечисление устройств захвата через FFmpeg
ffmpeg -hide_banner -list_devices true -f dshow -i dummy
```

**Пример:** на Linux в выводе `ls` вы видите `/dev/video0` (веб-камера) и `/dev/video2` (уже созданная виртуальная камера). Вход — `0`, выход — `2`. Перепутать их — самая частая ошибка: FFmpeg начнёт читать из собственного выхода и зависнет.

## Шаг 2. Сборка цепочки апскейла в реальном времени

**Что сделать:** собрать конвейер «захват → масштабирование → резкость → аппаратное кодирование → вывод» и запустить его с бюджетом задержки в один кадр.

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

**Как проверить:** в строке прогресса FFmpeg параметр `speed` держится на `1.0x` и выше, а `drop` не растёт.

| Этап | Что делает | Параметр |
|---|---|---|
| Вход | читает камеру с фиксированным FPS | `-f v4l2 -framerate 30 -video_size 1280x720 -i /dev/video0` |
| Апскейл | растягивает кадр | `scale=2560:1440:flags=lanczos` |
| Резкость | возвращает детализацию | `cas=strength=0.4` |
| Кодирование | сжатие на GPU с низкой задержкой | `-c:v h264_nvenc -preset p1 -tune ll -b:v 12M` |
| Вывод | отдаёт в виртуальную камеру | `-f v4l2 /dev/video2` |

Сначала создайте приёмник на Linux:

```bash
sudo modprobe v4l2loopback video_nr=2 card_label="VividFrame" exclusive_caps=1
```

`exclusive_caps=1` нужен, чтобы приложения (Zoom, браузер) видели устройство именно как камеру, а не как устройство вывода.

Затем запустите цепочку:

```bash
ffmpeg -hide_banner -loglevel warning \
  -f v4l2 -framerate 30 -video_size 1280x720 -i /dev/video0 \
  -vf "scale=2560:1440:flags=lanczos,cas=strength=0.4,format=yuv420p" \
  -c:v h264_nvenc -preset p1 -tune ll -rc cbr -b:v 12M -maxrate 12M -bufsize 24M \
  -f v4l2 /dev/video2
```

Почему это работает: `scale` выполняется на GPU-фильтрах FFmpeg, `h264_nvenc` кодирует в отдельном блоке видеокарты, `-preset p1` и `-tune ll` выбирают самый быстрый профиль кодировщика с минимальной задержкой, `-bufsize 24M` (двухсекундный буфер при 12 Мбит/с) не даёт потоку разрастаться.

Путь для Windows — через OBS Studio, там же настраивается виртуальная камера:

1. «Источники» → «+» → «Устройство захвата видео» → выбрать камеру.
2. ПКМ по источнику → «Фильтрация масштабирования» → «Lanczos».
3. «Настройки» → «Видео» → «Разрешение холста» = `2560x1440`, «Разрешение вывода» = `2560x1440`, FPS = `30`.
4. «Настройки» → «Вывод» → кодек `NVIDIA NVENC H.264`, «Управление битрейтом» = `CBR`, битрейт `12000` Кбит/с.
5. «Запустить виртуальную камеру» в панели «Управление».

Детальный разбор остальных фильтров, интерполяции кадров и выбора модели апскейла — в гайде [Как улучшить качество видео нейросетью на GPU: апскейл, интерполяция кадров и настройка пайплайна](https://ai-release.org/guides/kak-uluchshit-kachestvo-video-neyrosetyu-na-gpu-apskeyl.html?utm_source=tg&utm_medium=channel&utm_campaign=guide_inline&utm_content=guide_to_guide).

## Шаг 3. Проверка результата и вывод в конференц-приложение
![Иллюстрация к разделу «Шаг 3. Проверка результата и вывод в конференц-приложение»](https://ai-release.org/guides/img/kak-ustanovit-vividframe-gpu-i-nastroit-apskeyl-video-v-ru-3.jpg?v=1795185803)


**Что сделать:** прогнать цепочку 60 секунд, снять метрики и убедиться, что виртуальная камера видна снаружи.

**Зачем:** разрешение в фильтре — это ещё не результат; результат — стабильные 30 кадров/с без накопления задержки и работающая камера в целевом приложении.

**Как проверить:** четыре независимых признака.

Чек-лист приёмки:

- [ ] `nvidia-smi` видит GPU и драйвер
- [ ] `ffmpeg -encoders` содержит `h264_nvenc`
- [ ] в прогрессе FFmpeg `speed=1.0x` или выше, `drop=0`
- [ ] `ffprobe` показывает целевое разрешение
- [ ] виртуальная камера видна в Zoom / Discord / браузере

Проверка фактического разрешения на выходе:

```bash
ffprobe -v error -select_streams v:0 \
  -show_entries stream=width,height,avg_frame_rate \
  -of csv=p=0 /dev/video2
```

Ожидаемый вывод: `2560,1440,30/1`. Если вы видите `1280,720,30/1` — фильтр `scale` не применился (опечатка в `-vf` или он перекрыт более поздним `format`).

Строка прогресса FFmpeg выглядит так:

```
frame= 1800 fps= 30 q=21.0 size=   25600kB time=00:01:00.00 bitrate=3495.3kbits/s speed=1.0x
```

Успех — `speed=1.0x` и `drop=0` на протяжении всей минуты. Значение `speed=0.6x` означает, что обработчик отстаёт и буфер задержки растёт.

Финальный шаг — открыть конференц-приложение, выбрать в настройках видео камеру `VividFrame` (Linux) или `OBS Virtual Camera` (Windows) и убедиться, что картинка идёт. Если параллельно нужен и виртуальный микрофон, порядок настройки описан в гайде [Как изменить голос в реальном времени: настройка Voice Changer 2026 и виртуального микрофона в Discord, OBS и Zoom](https://ai-release.org/guides/kak-izmenit-golos-v-realnom-vremeni-nastroyka-voice-cha.html?utm_source=tg&utm_medium=channel&utm_campaign=guide_inline&utm_content=guide_to_guide).

## Возможные проблемы и решения

**Проблема. FFmpeg не запускается, кодировщик не найден**

- Ошибка: `Unknown encoder 'h264_nvenc'`
- Причина: сборка FFmpeg без NVENC, либо драйвер NVIDIA не установлен и модуль кодировщика не инициализируется.
- Решение: проверить наличие кодировщика и заменить сборку на версию с NVENC.

```bash
ffmpeg -hide_banner -encoders | grep nvenc
```

Если строк нет — установите сборку с поддержкой NVENC; как временный обход используйте `-c:v libx264 -preset ultrafast`, но на 2560x1440 CPU-энкодер почти наверняка не уложится в реальное время.

**Проблема. Кодировщик падает при старте**

- Ошибка: `OpenEncodeSessionEx failed: out of memory (10): (no details)`
- Причина: закончились свободные сессии NVENC или видеопамять — обычно из-за запущенного рендера, другой записи или игры.
- Решение: посмотреть занятую память и освободить GPU, затем снизить нагрузку.

```bash
nvidia-smi --query-gpu=memory.used,memory.total --format=csv
```

Закройте лишние приложения, при необходимости уменьшите целевое разрешение с `2560:1440` до `1920:1080` и перезапустите цепочку.

**Проблема. Виртуальная камера не появляется в приложениях**

- Ошибка: `[v4l2 @ 0x...] /dev/video2: No such file or directory`
- Причина: модуль `v4l2loopback` не загружен или создан под другим номером.
- Решение: загрузить модуль с нужным номером и проверить список устройств.

```bash
sudo modprobe v4l2loopback video_nr=2 card_label="VividFrame" exclusive_caps=1
ls -l /dev/video*
```

После этого перезапустите FFmpeg и заново выберите камеру в приложении — многие программы кэшируют список устройств при старте.

## Резюме и следующие шаги

Рабочая конфигурация — это проверенный NVENC плюс цепочка `scale → cas → h264_nvenc` с `speed=1.0x` и нулевыми потерями кадров. Дальше имеет смысл сравнить `flags=lanczos` с `bicubic` на вашем материале и подобрать `cas=strength` под степень сжатия источника.

## FAQ

**Обязательна ли видеокарта NVIDIA для апскейла в реальном времени?**
Для аппаратного кодирования через NVENC — да. Без него цепочка запустится на `libx264`, но на высоких разрешениях не удержится в бюджет одного кадра, и вы получите растущую задержку.

**Чем апскейл в реальном времени отличается от обычного?**
Обычный обработчик может тратить на кадр сколько угодно времени. Здесь бюджет жёсткий: обработка кадра должна укладываться в интервал между кадрами (при 30 FPS — около 33 мс), иначе буфер растёт.

**Как отдать результат в Zoom или Discord?**
Через виртуальную камеру: на Linux — вывод FFmpeg в `/dev/video2` от `v4l2loopback`, на Windows — кнопка «Запустить виртуальную камеру» в OBS. В приложении выбирается соответствующее устройство.

**Почему после апскейла картинка выглядит мягкой?**
Растяжение не создаёт деталей. Резкость возвращает фильтр `cas` (или аналогичный), но при сильном сжатии источника артефакты тоже усиливаются — уменьшайте `strength` и сверяйтесь с документацией по доступным фильтрам вашей сборки FFmpeg.
