Linux

Minimum Requirements

• OS: Ubuntu Desktop 16.04
• Processor: Intel Celeron 1.6 GHz (J3160).
  
• RAM: 2 GB.
  
• Graphics card: integrated Intel HD Graphics 400.
  
• Disk space: 35 GB.

Recommended Requirements

• OS: Ubuntu Desktop 18.04 LTS / 22.04 LTS (support for 22.04 is only possible with the second version of the client application 2. ...)
• Processor: Intel Nuc i3 or more powerful devices.
  
• RAM: 4 GB.
  
• Graphics card: external graphics card.
  
• Disk space: 100 GB.

Installation

The SmartPlayer company has experience launching the client application on Ubuntu 16.04 (x32/x64), Ubuntu 18.04 (x64), and Ubuntu 20.04 (skipped by SmartPlayer, and the client application was not launched). Here, we recommend the latest version, Ubuntu 22.04.04 LTS, for stable operation. If the project uses outdated operating systems mentioned above, we can create a custom distribution package, request it from the project manager.

Installation Steps

First, install the operating system:

1. Install Ubuntu 22.04.04 LTS Download from the official website
2. Operating system setup:
   1. Before installing the application, you need to change the operating system settings via the graphical interface. Linux instruction
   2. Disable the screensaver and sleep mode - Инструкция
   3. Install proprietary drivers for graphics cards - Инструкция
   4. Disable system notification settings - Инструкция
3. Install the application via terminal $ sudo dpkg -i SmartPlayer_..*_api.smartplayer.org_x64.deb
4. Launch the application
   1. You can launch the application from the application list
   2. Launch the application via terminal $ /usr/bin/SmartPlayer/SmartPlayer.sh

Exiting Kiosk Mode

The application will start in kiosk mode. To exit, use the keyboard shortcut Ctrl+F12.

Removing the Application

Run the following command in the terminal: $ sudo dpkg --purge SmartPlayer

Running on Low-End Hardware

When running on computers with low specifications, video freezing and lagging may occur. To achieve better performance, you need to:

1. Upload the video to the built-in video editor in your personal account, adjust the video bitrate in the editor to an appropriate level (depending on the required quality), process it, and save it. Use the processed video in the broadcast.
2. In the personal account, go to the device settings and enable hardware acceleration. Settings - Hardware acceleration - enter the parameter

file-caching=3000 and save.

Troubleshooting

The display does not turn off when the display timeout is set

To resolve the issue, first run the following command in the device's command line: xset dpms force off. If the display turns off, incorrect settings are configured in the SmartPlayer personal account. If the display does not turn off and the message server does not have extension for dpms option appears in the command line, you need to adjust the settings. The solution requires disabling Wayland in Ubuntu:

1. Run the command sudo nano /etc/gdm3/custom.conf
2. Remove the comment from the line #WaylandEnable = false (the text will be highlighted in white).
3. Save (ctrl+O)
4. Run the command sudo service gdm3 restart

Переключение оконного интерфейса

У пользователя при запуске приложения на Ubuntu не происходит никакой реакции на приложении. Для решения данной проблемы необходимо необходимо зайти в раздел "О системе" и перейти к строке "Оконные интерфейс".

Расположение настройки "Оконный интерфейс".

В данной строке меняем вариант "Wayland", на вариант "X11".

Альтернативное решение

Существует возможность переключиться с Wayland на систему отображения X11 с экрана блокировки. Данный метод подходит для тех, у кого нет доступа к sudo для изменения "/etc/gdm3/daemon.conf" или "/etc/gdm3/custom.conf", или если пользователю необходимо временно переключиться с Wayland на систему отображения X11.
Для начала пользователю нужно выйти из системы, запустив приведенный ниже код, или использовать традиционный метод, чтобы выйти из системы.
$ loginctl terminate-user $(users)
После данного действия необходимо нажать кнопку "Enter" для входа в систему.
Далее пользователь находит иконку "шестерёнка" в правом нижнем углу. Кликнув на нее пользователю откроется окно с настройками параметров. По умолчанию пользователи Ubuntu работают на X11, но если каким-то образом они находятся на Ubuntu на Wayland, тогда измените его на «Ubuntu», а пользователям на базе Debian необходимо выбрать «GNOME на Xorg».

Пример для Ubuntu и Debian.

После этого снова войдите в систему и перейдите в Настройки->О системе, чтобы проверить новые изменения. В разделе Система окон вы найдете X11 для пользователей Ubuntu и на базе Debian.

Пример для Ubuntu и Debian.

Смена оконного интерфейса при помощи терминала

• Запустите терминал
• Введите команду sudo gedit /etc/gdm3/custom.conf
• Чтобы отключить режим "Wayland" найдите строчку #WaylandEnable=false‍ , удалите знак "#" и сохраните изменения
• Перезапустите "GDM" используя команду sudo systemctl restart gdm3

Аппаратные ограничения платформы

На устройствах под управлением Linux существуют следующие аппаратные ограничения:

1. Наличие включенного антивируса или брандмауэра может повлиять на работу приложения SmartPlayer.
2. Просматривая минимальные системные требования для устройства, пользователь должен понимать что они указаны для корректной работы само приложения SmartPlayer, без учета остальных программ и процессов которые также расходуют ресурсы устройства. Поэтому рекомендуется иметь конфигурацию устройства. которое имеет более производительные компоненты, чем указаны в минимальных системных требованиях. Иначе стабильная работа приложения SmartPlayer и его компонентов не гарантируется.