onairscreen_linux [astrastudio wiki]

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== Install OnAirScreen from a .deb (Linux / Raspberry Pi OS) ======

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.

Download: [[https://customer.astrastudio.de/]]

===== Which package? =====

^ 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** |

Check the architecture:

<code bash>
dpkg --print-architecture
</code>

  * ''amd64'' → Linux x64 package
  * ''arm64'' → Raspberry Pi package

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 ./OnAirScreen_*.deb
</code>

The ''./'' in front of the file is required, otherwise apt looks in the repositories instead of the local file.

Confirm extra packages with Yes if apt asks.

===== Start =====

  * Application menu → **OnAirScreen**
  * or in a terminal: ''onairscreen''

Default: fullscreen, mouse cursor hidden. Settings: ''Ctrl+S''; changes apply only after **Apply**.

Settings file: ''~/.config/astrastudio/OnAirScreen.conf''\\
Logs: ''~/.local/share/astrastudio/OnAirScreen/logs/''

===== Update =====

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.

===== Uninstall =====

Remove the package, keep settings:

<code bash>
sudo apt remove onairscreen
</code>

Remove the package and its system files (user config and logs in your home stay):

<code bash>
sudo apt purge onairscreen
</code>

Delete config and logs yourself if you want them gone:

<code bash>
rm -f ~/.config/astrastudio/OnAirScreen.conf
rm -rf ~/.local/share/astrastudio/OnAirScreen
</code>

===== Troubleshooting =====

**Missing dependencies** after ''dpkg -i'':

<code bash>
sudo apt -f install
</code>

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.