====== Замена mjpg-streamer на ustreamer ======

===== Зачем и почему? =====

µstreamer (читается как мю-стример) это mjpg-streamer "на стероидах". Таблица различий есть на [[https://github.com/pikvm/ustreamer#µstreamer|странице проекта]]. Из достаточно полезного - он быстрее (кодирует jpeg в несколько потоков), умеет не падать, если отключить камеру. В сообществе есть пруфы, что на mjpg-streamer'e картинка с c270 сыпалась, а с мю-стримером все заработало без проблем.

Как пишет сам разработчик:
"Если вы собираетесь вести прямую трансляцию с веб-камеры на заднем дворе и вам нужно ее контролировать, используйте mjpg-streamer. Если вам нужно качественное изображение с высоким FPS — µStreamer в помощь". Мю-стример не умеет работать с камерами с сервоприводами и управлением фокусировкой, но нам это и не нужно.

Ну и ложка дегтя - в kiauh mjpg-streamer на момент написания статьи пропал, плюс есть инфа что его (mjpg-streamer) разломали. У него там половину библиотек умерло, вернее они обновились новыми и нужно уже разбираться что да как.

<WRAP center round todo 60%>
Здесь описывается локальная сборка, в идеале надо сделать пакет, но это, возможно, в будущем.

</WRAP>

Все, что делается по этой инструкции делается из unix-консоли. Т.е. первым делом надо поключиться к вашему уустройству с установленным Klipper по SSH (Putty, Xshell и подобное). Данный конкретный рецепт для OrangePI с установленной системой Raspbian. Для других устройств и OS смотрите сайт проекта µstreamer.


===== Отключаем mjpg-streamer =====
Итак, если у нас уже был установлен mjpg-streamer, то прежде чем что-то делать, надо его отключить. Если его не было, сразу смотри следующий пункт.

Выполняем две команды, первая останавливает процесс, вторая убирает его из автозагрузки:
<code bash>
sudo systemctl stop webcamd
sudo systemctl disable webcamd
</code>
Такими действиями мы не удалили, но отключили mjpg-streamer.

===== Установка ustreamer с нуля ======
Если до этого в системе не было стримера, то надо выполнить некоторые подготовительные действия.

А именно установить утилиты для сборки из исходного кода (уже могут быть, мы же ставили клиппер!) и набор свободных библиотек с открытым исходным кодом, которые позволяют записывать, конвертировать и передавать цифровые аудио- и видеозаписи в различных форматах, ffmpeg.

<code bash>
sudo apt install build-essential ffmpeg
</code>


===== Сборка ustreamer =====
Далее нам надо собрать сам ustreamer. В принципе, [[https://github.com/pikvm/ustreamer#building|инструкция есть на домашней странице проекта]] на гитхабе.

Пререквизиты для сборки make, gcc, libevent c поддержкой pthreads, libjpeg-turbo и libbsd.

<code bash>
sudo apt install libevent-dev libjpeg62-turbo-dev libbsd-dev libgpiod-dev libsystemd-dev
</code>

Собираем его (по-умолчанию в нашем домашнем каталоге, ~/, он же /home/klipper). Сборку делаем с поддержкой GPIO (не смог придумать кейс, но пусть будет) и поддержкой SYSTEMD (для автозапуска).

<code bash>
git clone --depth=1 https://github.com/pikvm/ustreamer
cd ustreamer
WITH_GPIO=1 WITH_SYSTEMD=1 make
./ustreamer --help
</code>

===== Установка ustreamer =====
В итоге, если все получилось, инсталлируем стример локально.

<code bash> 
sudo make install
</code>

После выполнения этой команды бинарник стримера будет установлен в /usr/local/bin/

Дальше нам надо решить вопрос с автозапуском. Что нужно сделать описано [[https://github.com/pikvm/ustreamer/issues/16|здесь]]. Но мы приведем здесь последовательность действий, адаптированную под нашу систему.

Первым делом надо убедиться, что установка прошла успешно:

<code bash>
ls -l /usr/local/bin/ustreamer
-rwxr-xr-x 1 root root 419392 ноя 10 12:18 /usr/local/bin/ustreamer
</code>
У вас права доступа (-rwxr-xr-x) должны быть как в примере выше.

Запускать процесс будем от имени пользователя klipper.

Добавляем пользователя в группу video (он там уже должен быть, но хуже от команды точно не будет):
<code bash>
sudo usermod -a -G video klipper
</code>

Далее нам нужно создать руками конфигурационный файл для systemd.
В нашем случае мы не будем делать как предлагает автор ustreamer'a, сделаем конфиг под конкретное видеоустройство, а именно /dev/video1 (если у вас камера на другом порту, то надо указывать его, конечно), а также, чтобы ustreamer "слушал" на порту 8080, там видеопоток ожидает клиппер.

Используем наиболее привычный вам текстовый редактор в unix-среде (vim, nano, joe..):

<code bash>
sudo nano /etc/systemd/system/ustreamer.service
</code>

в файле пишем следующее (обратите внимание - формат, fps и качество задаются в ключах resolution, desired-fps и quality соответственно):
<code>
[Unit]
Description=uStreamer service
After=network.target
[Service]
Environment="SCRIPT_ARGS=1"
User=klipper
ExecStart=/usr/local/bin/ustreamer --process-name-prefix ustreamer-1 --log-level 0 --device /dev/video1 --device-timeout=8 --format=MJPEG --quality 80 --resolution 1280x720 --desired-fps=30 --host=0.0.0.0 --port=8080 --static /var/www/html/ustreamer-1/
[Install]
WantedBy=multi-user.target
</code>

Включаем автозапуск стримера:
<code bash>
sudo systemctl enable ustreamer.service
</code>

и, наконец, запускаем сервис:

<code bash>
sudo systemctl start ustreamer.service
</code>

Убеждаемся, что все запустилось:
<code bash>
systemctl status ustreamer                                                                                                                                                                                                                                                                                                     <master>
● ustreamer.service - uStreamer service
     Loaded: loaded (/etc/systemd/system/ustreamer.service; enabled; vendor preset: enabled)
     Active: active (running) since Thu 2022-11-10 12:44:07 MSK; 4s ago
   Main PID: 4544 (main)
      Tasks: 7 (limit: 2218)
     Memory: 3.3M
        CPU: 1.287s
     CGroup: /system.slice/ustreamer.service
             └─4544 ustreamer-1: /usr/local/bin/ustreamer --process-name-prefix ustreamer-1 --log-level 0 --device /dev/video1 --device-timeout=8 --quality 100 --resolution 1280x720 --desired-fps=30 --host=0.0.0.0 --port=8080 --static /var/www/html/ustreamer-1/
</code>


Так как мы жестко привязали стример к порту 8080, видеопоток с камеры должен быть доступен по адресу http://pi_ip:8080/stream, где //pi_ip// - IP-адрес вашего одноплатника с установленным Klipper на котором мы все только что собирали.

Если вы настраиваете камеру впервые - идем в web-интерфейс Klipper, раздел "Камеры" и добавляем подключенную камеру. Тип потока - MJPEG-поток, URL камеры - http://127.0.0.1:8080/stream

Этот же самый URL должен быть в telegram.cfg, если вы ставили телеграм-бота. 
Должно быть что-то типа такого:
<code>
[camera]
host: http://127.0.0.1:8080/stream
</code>

Финально проверяем в интерфейсе клиппера - всё должно работать.
{{ :klipper:ustreamer:c270.png?400 |}}