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/

Check the architecture:

dpkg --print-architecture

• 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.

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:

unzip OnAirScreen_Linux_x64.zip
# or: unzip OnAirScreen_PiOS_x64.zip
 
cd ~/Downloads   # adjust if needed
sudo apt update
sudo apt install ./OnAirScreen_*.deb

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.

• 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/

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.

Remove the package, keep settings:

sudo apt remove onairscreen

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

sudo apt purge onairscreen

Delete config and logs yourself if you want them gone:

rm -f ~/.config/astrastudio/OnAirScreen.conf
rm -rf ~/.local/share/astrastudio/OnAirScreen

Missing dependencies after dpkg -i:

sudo apt -f install

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.