.tar.gz · 128 МБ · x86-64 (Wayland / X11)Внутри архива: AppImage, установщик install-linux.sh, документация и SHA256SUMS для проверки целостности. Звук на Linux не поддерживается — версия только для видео.
1Что в пакете
После распаковки архива вы получите папку со следующими файлами:
- FaceterScreenCam-0.0.3-x86_64.AppImage — само приложение (единый бинарный файл)
- install-linux.sh — установщик: добавляет приложение в систему и меню, создаёт команду удаления
- INSTALL_LINUX.md, SYSTEM_REQUIREMENTS_LINUX.md, USER_GUIDE_LINUX.md — документация
- SHA256SUMS — контрольные суммы (проверка:
sha256sum -c SHA256SUMS)
2Системные требования
Дистрибутивы. Любой Linux с glibc ≥ 2.31: Ubuntu 20.04+, Debian 11+, Fedora 34+, RHEL/CentOS 9+, openSUSE Leap 15.4+. Проверено на Ubuntu 22.04 / 24.04 / 26.04 и Debian 12.
| Компонент | Минимум | Рекомендуется |
|---|---|---|
| CPU | 2 ядра x86-64, ≥ 2.0 ГГц | 4 ядра ≥ 3.0 ГГц или аппаратный кодировщик (Intel QSV / NVIDIA NVENC / AMD VAAPI) |
| RAM | 2 ГБ | 4 ГБ+ |
| Диск | 150 МБ | 1 ГБ (с местом под логи) |
| GPU | Не требуется (есть программный кодек) | Intel / NVIDIA / AMD с аппаратным H.264 |
| Сеть | Стабильный интернет | Upload ≥ 2.5 Мбит/с для HD-потока |
| Дисплей | X11 (Xorg / XWayland) или Wayland | Путь захвата выбирается автоматически |
Не поддерживается: ARM (aarch64), 32-битный x86, дистрибутивы на musl libc (Alpine, Void).
xdg-desktop-portal; при первом запуске система спросит разрешение «Поделиться экраном» — нажмите «Разрешить» и выберите монитор. Для Wayland нужен установленный portal-бэкенд (xdg-desktop-portal-gnome или -kde). Полная матрица композиторов и сетевых требований — в SYSTEM_REQUIREMENTS_LINUX.md внутри архива.
3Установка зависимостей
AppImage не включает ffmpeg, Qt6 и библиотеки xcb — их ставит система. Установщик умеет проверить, чего не хватает:
./install-linux.sh --check-deps |
Команда напечатает точный список для вашего пакетного менеджера. Готовые команды:
Ubuntu / Debian:
sudo apt install -y libfuse2t64 libxcb-cursor0 libxcb-keysyms1 libxcb-icccm4 libxcb-image0 libxcb-render-util0 libxkbcommon-x11-0 ffmpeg pulseaudio-utils libpipewire-0.3-0 libsodium23 xdg-desktop-portal xdg-desktop-portal-gnome |
На Ubuntu 22.04 / Debian 11 вместо libfuse2t64 — libfuse2. На KDE вместо xdg-desktop-portal-gnome — xdg-desktop-portal-kde. Последние 3 пакета нужны только на Wayland.
Fedora / RHEL / CentOS:
sudo dnf install -y fuse-libs xcb-util-cursor xcb-util-keysyms xcb-util-wm xcb-util-image xcb-util-renderutil libxkbcommon-x11 ffmpeg pulseaudio-utils |
openSUSE:
sudo zypper install -y fuse libxcb-cursor0 libxcb-keysyms1 libxcb-icccm4 libxcb-image0 libxcb-render-util0 libxkbcommon-x11-0 ffmpeg pulseaudio-utils |
4Быстрый старт
- Распакуйте архив:
tar xzf faceter-screencam-0.0.3-2026-07-20-linux.tar.gzи перейдите в папку. - Проверьте зависимости:
./install-linux.sh --check-deps— и доставьте недостающие (см. раздел 3). - Установите приложение системно:
sudo ./install-linux.sh - Запустите — из меню приложений («Faceter ScreenCam») или командой:
/opt/faceter-screencam/FaceterScreenCam-0.0.3-x86_64.AppImage
sudo ./install-linux.sh --kiosk — камера работает непрерывно.5Что делает установщик
- проверяет системные зависимости и подсказывает команду установки недостающих;
- кладёт приложение в
/opt/faceter-screencam/; - создаёт ярлык в меню приложений (Activities / KDE Menu) и распаковывает иконку;
- создаёт команду удаления
faceter-screencam-uninstallс защитой PIN-кодом.
6Запуск без установки
AppImage можно запустить напрямую, без install-linux.sh:
chmod +x FaceterScreenCam-0.0.3-x86_64.AppImage |
./FaceterScreenCam-0.0.3-x86_64.AppImage |
В этом режиме нет ярлыка в меню, но всё остальное работает.
7PIN-код и автозапуск
PIN-код. При первом запуске приложение предложит задать PIN — это защита от удаления приложения посторонним (например, если ПК ПВЗ остаётся без присмотра). PIN хранится в зашифрованном виде и привязан к конкретной машине. Изменить можно в Настройках; если забыли — в диалоге удаления есть кнопка сброса через e-mail / код.
Автозапуск. После первого входа приложение предложит включить автозапуск при входе в систему. Отключить — снять галочку в Настройках или удалить файл ~/.config/autostart/faceter-screencam.desktop.
8Проверка работоспособности
- Откройте приложение, введите e-mail, получите код по почте, введите его.
- Дойдите до экрана «Запись идёт ~XXXX kbps» — значит поток в Faceter Cloud работает.
- В мобильном приложении Faceter → раздел «Камеры» → должна появиться камера с именем вашего хоста; откройте её → должна идти живая трансляция экрана.
9Решение проблем
«Could not load the Qt platform plugin "xcb"»
Не хватает Qt6 xcb-зависимостей:
sudo apt install libxcb-cursor0 libxcb-keysyms1 libxcb-icccm4 libxcb-image0 libxcb-render-util0 libxkbcommon-x11-0 |
AppImage не запускается, «no such file»
Не установлен FUSE2: sudo apt install libfuse2t64 (Ubuntu 24.04+, Debian 13+) или sudo apt install libfuse2 (Ubuntu 22.04, Debian 11/12).
Чёрный экран в мобильном приложении
Wayland: установите portal-бэкенд xdg-desktop-portal-gnome (или -kde) — без него композитор не отдаёт поток. Также проверьте, что не отменили системный диалог «Поделиться экраном».
Xorg: захвату нужен доступ к реальному X-серверу. Если хотите явно X11 — при входе выберите сессию «GNOME on Xorg» вместо «GNOME on Wayland».
CPU загружен под завязку
На слабых CPU (≤ 4 ядра без аппаратного кодировщика) приложение само включает щадящий режим (fps 10, меньше нагрузки). Форсировать: FACETER_LOW_CPU=1 — включить, FACETER_LOW_CPU=0 — выключить перед запуском.
Логи
JSON-логи: ~/.local/share/faceter/screencam/logs/screencam.log. Полный troubleshooting — в INSTALL_LINUX.md внутри архива.
USER_GUIDE_LINUX.md. 10Удаление
Если ставили через установщик: sudo faceter-screencam-uninstall — запросит PIN (если задан) и удалит приложение, ярлык и иконку.
Если запускали вручную: просто удалите файл AppImage.
Полностью удалить пользовательские данные:
rm -rf ~/.config/faceter-screencam ~/.local/share/faceter |
rm -f ~/.config/autostart/faceter-screencam.desktop |
11Ограничения версии
- Аппаратные кодировщики (QSV / NVENC / VAAPI) пока не задействованы — программный кодек libx264;
- ПВЗ-специфичные триггеры (сканер штрихкодов, отслеживание активного окна) — пока только на Windows;
- ARM (aarch64) — сборки пока нет.