Differences

This shows you the differences between two versions of the page.

--- onairscreen_linux [07.07.2026 18:56] – created admin
+++ onairscreen_linux [03.09.2026 22:42] (current) – admin
@@ Line 1: / Line 1: @@
-===== OnAirScreen: Required packages on Debian Linux =====
+====== Install OnAirScreen from a .deb (Linux / Raspberry Pi OS) ======
-The **OnAirScreen** Linux binary (``OnAirScreen_*_Linux_x64.bin``) is built with PyInstaller and includes Python and PyQt6. **System libraries for OpenGL/EGL and the display stack are not bundled** — they must be installed on the target system.
+Official builds ship as a **Debian package** (''.deb''). After install the app lives in ''/opt/onairscreen'', starts via ''/usr/bin/onairscreen'', and appears in the application menu.
-If a library is missing, the app may fail immediately with an error like:
+Download: [[https://customer.astrastudio.de/]]
-  ImportError: libEGL.so.1: cannot open shared object file: No such file or directory
+===== Which package? =====
-This is normal for Qt6 GUI applications on Linux — not a sign that the OnAirScreen binary is broken.
+^ Shop ZIP ^ Inside the ZIP ^ Architecture ^ For ^
+| ''OnAirScreen_Linux_x64.zip'' | ''OnAirScreen_<version>_Linux_x64.deb'' | ''amd64'' | Debian/Ubuntu PCs, x86-64 |
+| ''OnAirScreen_PiOS_x64.zip'' | ''OnAirScreen_<version>_RaspberryPiOSx64.deb'' | ''arm64'' | Raspberry Pi OS **64-bit** |
-==== Why is this necessary? ====
+Check the architecture:
-  * **PyQt6 / Qt6** loads graphics libraries from the system at runtime.
+<code bash>
-  * PyInstaller ships the application code, but **not** Mesa/OpenGL/EGL drivers and related X11 libraries.
+dpkg --print-architecture
-  * Minimal or server installations often do not include these packages by default.
+</code>
-==== Required packages (Debian / Ubuntu / Raspberry Pi OS) ====
+  * ''amd64'' → Linux x64 package
+  * ''arm64'' → Raspberry Pi package
-Install the following packages:
+The two packages are **not** interchangeable. A Pi ''.deb'' will not install on a PC and vice versa.
+**Raspberry Pi:** 64-bit OS on Zero 2 W, Pi 3 / 4 / 400, CM4, Pi 5 / 500, CM5. Not supported: Pi 1 and classic Zero (no 64-bit CPU). Built for **Debian / Raspberry Pi OS 13 (Trixie)** 64-bit. You need a graphical desktop session, not a console-only system.
+===== Install =====
+Unzip the download, change to the folder that contains the ''.deb'', then use **apt** (not ''dpkg -i'' alone) so dependencies (PortAudio, OpenGL, Xcb) are pulled in:
 <code bash>
+unzip OnAirScreen_Linux_x64.zip
+# or: unzip OnAirScreen_PiOS_x64.zip
+cd ~/Downloads   # adjust if needed
 sudo apt update
-sudo apt install libegl1 libgl1
+sudo apt install ./OnAirScreen_*.deb
 </code>
-These provide:
+The ''./'' in front of the file is required, otherwise apt looks in the repositories instead of the local file.
-  * ''libEGL.so.1'' — EGL support (required by Qt6 GUI)
+Confirm extra packages with Yes if apt asks.
-  * ''libGL.so.1'' — OpenGL support
-==== Recommended additional packages ====
+===== Start =====
-On some systems (minimal desktop, older images, certain VMs) you may also need:
+  * Application menu → **OnAirScreen**
+  * or in a terminal: ''onairscreen''
-<code bash>
+Default: fullscreen, mouse cursor hidden. Settings: ''Ctrl+S''; changes apply only after **Apply**.
-sudo apt install libxkbcommon0 libxcb-cursor0
-</code>
-==== Run OnAirScreen ====
+Settings file: ''~/.config/astrastudio/OnAirScreen.conf''\\
+Logs: ''~/.local/share/astrastudio/OnAirScreen/logs/''
-<code bash>
+===== Update =====
-chmod +x OnAirScreen_0.9.8_Linux_x64.bin
-./OnAirScreen_0.9.8_Linux_x64.bin
-</code>
-Replace the filename with your downloaded version if different.
+Install the new ''.deb'' the same way with ''sudo apt install ./OnAirScreen_*.deb''. Settings are kept. Old portable folders or leftover binaries are not removed by the package; delete those by hand.
-==== Verify missing libraries (optional) ====
+===== Uninstall =====
-If the app still fails to start, check which libraries are missing:
+Remove the package, keep settings:
 <code bash>
-./OnAirScreen_0.9.8_Linux_x64.bin
+sudo apt remove onairscreen
 </code>
-Read the error message for the missing ''*.so'' name, then install the corresponding Debian package. You can also search for the package:
+Remove the package and its system files (user config and logs in your home stay):
 <code bash>
-sudo apt install apt-file
+sudo apt purge onairscreen
-sudo apt-file update
-apt-file search libEGL.so.1
 </code>
-Common mappings:
+Delete config and logs yourself if you want them gone:
-^ Missing library ^ Debian package ^
+<code bash>
-| libEGL.so.1 | libegl1 |
+rm -f ~/.config/astrastudio/OnAirScreen.conf
-| libGL.so.1 | libgl1 |
+rm -rf ~/.local/share/astrastudio/OnAirScreen
-| libxkbcommon.so.0 | libxkbcommon0 |
+</code>
-| libxcb-cursor.so.0 | libxcb-cursor0 |
-==== Troubleshooting ====
+===== Troubleshooting =====
-**"Permission denied" when running the binary**
+**Missing dependencies** after ''dpkg -i'':
-Make the file executable: ''chmod +x OnAirScreen_*.bin''
-**Black window / no display (SSH session)**
-OnAirScreen needs a graphical desktop (X11 or Wayland). Run it on the local console or with X forwarding, not on a plain text-only SSH session without display.
-**Wayland vs X11**
-If you have display issues under Wayland, try:
 <code bash>
-QT_QPA_PLATFORM=xcb ./OnAirScreen_0.9.8_Linux_x64.bin
+sudo apt -f install
 </code>
-Only install and run OnAirScreen from a **trusted source** (official astrastudio customer portal or the astrastudio shop download).
+From now on use ''sudo apt install ./OnAirScreen_*.deb''.
+**Does not start / black window:** you need a desktop session. On a Pi use Raspberry Pi OS 64-bit with desktop, not Lite without a GUI.
+**Old OnAirScreen still there:** the ''.deb'' only replaces the ''onairscreen'' package. A binary you copied by hand into ''/home/...'' must be deleted separately.