{{ :oas_screenshot_1.0.0_v2.png?600|}} ====== OnAirScreen ====== Multipurpose **OnAir Lamp** for professional broadcast studios. Current version: **1.0.15**. Product page: [[https://www.astrastudio.de/en/onairscreen/|astrastudio.de]] Complete manuals: * English: [[onairscreen:manual-en|OnAirScreen – User Manual]] ({{onairscreen:onairscreen-manual-en.pdf|PDF}}) * Deutsch: [[onairscreen:manual-de|OnAirScreen – Bedienungsanleitung]] ({{onairscreen:onairscreen-manual-de.pdf|PDF}}) * Release Notes: * [[onairscreen:release_notes_1.0.0|OnAirScreen 1.0.0 — Release Notes]] * [[onairscreen:release_notes_0.9.8|OnAirScreen 0.9.8 — Release Notes]] ===== Features ===== * Flexible integration into existing studio setups (Windows, macOS, Linux, Raspberry Pi) * Customizable logo, colors, fonts (Roboto / Noto Sans), labels, and instance name (e.g. ''Studio-1'') * 4:3 and 16:9/16:10 monitor aspect ratios; fullscreen by default (hidden mouse cursor) * 4 status LEDs and 4 AIR timers (Mic, Phone, Radio Timer, Stream); AIR3 with count-up/down and Top-of-Hour * Left-click toggles LEDs and AIR timers; right-click menu for Fullscreen, Settings, I+LRA, Quit * Digital or analog clock, optional text clock, static or blinking colon * Time source: local clock, NTP, PTPv2 (IEEE 1588-2008), or SMPTE LTC (Leo Bodnar LBE-1110 or local audio). OnAirScreen **never** changes the OS clock * Stereo audio meters: Local Input, Axia Livewire, or AES67 (SAP / pasted SDP) * Meter layouts: L/R, programme LUFS (EBU R128), or both; dBFS / dBTP / BBC PPM; optional I+LRA, TooLoud, Silence Detection * NOW / NEXT / WARN lines with warning priorities * Weather widget (OpenWeatherMap) * Remote control: keyboard, UDP, HTTP, Web UI, MQTT (Home Assistant autodiscovery), OSC, SNMP (PEN 66873), REST (''/api/status'', ''/api/command'') * Web UI: studio look, phone layout, settings overlay (optional PIN), Livewire/AES67 pickers, home-screen icon * Bitfocus Companion HTTP module (Stream Deck); Generic OSC as fallback * Presets/profiles, rotating logs and crash reports, update check for shop builds ===== Documentation ===== * [[OAS:funktionstasten|Hotkeys / action keys]] * [[onairscreen:rodecaster-pro-ii-led-en|ON AIR LED from a RØDECaster Pro II (MIDI)]] * [[OAS:API|API / UDP / HTTP / MQTT / OSC, oas_send]] * [[onairscreen:mib-en|SNMP MIB]] (IANA PEN 66873) * [[OAS:changelog|Changelog]] * Open Settings with Ctrl+S or Ctrl+, (macOS: Cmd). Changes apply only after **Apply**. ===== HOWTOs ===== Pages as linked from [[start|the wiki start page]]: * [[OnAirScreen SD Card|Flash the Raspberry Pi OS SD-card image]] * [[OnAirScreen MacOS|Make the OnAirScreen app executable under macOS]] * [[OnAirScreen Linux|Install the .deb on Debian Linux and Raspberry Pi OS]] ===== Precompiled builds ===== Ready-to-run Windows (MSI), macOS (app/DMG), Linux x64 (''.deb''), and Raspberry Pi OS 64-bit (''.deb'' and optional SD image) are sold in the [[https://www.astrastudio.de/shop/|astrastudio shop]]. One license covers one PC or one Raspberry Pi. Activate with the Update Key from [[https://customer.astrastudio.de|customer.astrastudio.de]]. After a year, renew the activation. The Update Key stays the same. The license can also be moved. If this activation does not fit your use case, [[https://www.astrastudio.de/kontakt/|contact support]]. We will work out a custom solution. Source is available under OASL 1.0 (see below). Official binaries may not be redistributed without written permission. ===== Time source and NTP check ===== Under **Settings → Time Source** choose what drives the **on-screen clock**: * **Local** — the operating-system clock * **NTP** — an NTP server (default ''pool.ntp.org''); use a local or otherwise stable server if the public pool is flaky * **PTP** — software PTPv2 slave (IEEE 1588-2008) * **LTC** — SMPTE timecode from a Leo Bodnar LBE-1110 or a local audio input NTP and PTP steer an independent display clock. A jump of the OS time does not move the studio clock. LTC can jump or freeze and shows frames (''HH:MM:SS:FF''). **NTP-Check** (same tab) is an optional **warning** if the displayed time disagrees with the NTP server by more than 300 ms, or if the server is unreachable. It is independent of whether NTP is the selected time source. Turn it off if you do not need that accuracy. If the time source is **Local**, keep the OS clock in sync. Windows still syncs internet time only about once a week by default, which can show the wrong time on screen. Either set a shorter Windows sync interval (15 minutes to 1 hour) or switch OnAirScreen to NTP/PTP/LTC. * [[https://www.thewindowsclub.com/change-internet-time-update-interval-windows|Change the Windows internet time update interval]] ===== Weather-Widget ===== The weather widget needs an [[https://openweathermap.org/appid|OpenWeatherMap API key]]. In **Settings → Advanced**: * Enable the weather widget * Enter the API key (masked; use the slashed-eye icon to show it) * Type a city name next to **City ID**, press **Find**, and pick a match — or enter a City ID by hand * Use **Test API** to check the connection You can still look up a City ID on [[https://openweathermap.org/|openweathermap.org]]. Open a city page; the ID is the number at the end of the URL. London is [[https://openweathermap.org/city/2643743|2643743]]. ===== Automation and playout ===== * Bitfocus Companion: [[https://github.com/bitfocus/companion-module-astrastudio-onairscreen|astrastudio OnAirScreen module]] * RadioBOSS: [[https://www.djsoft.net/community/threads/onair-screen-with-radio-boss.11398/|OnAir Screen with RadioBOSS]] * mAirList: [[https://community.mairlist.com/t/ansteuerung-des-onairscreen/|Ansteuerung des OnAirScreen]] ===== License ===== OnAirScreen uses the **OnAirScreen Source-Available License (OASL 1.0)**. You may use, modify, and redistribute **source**. You may compile for private or internal use. You may **not** redistribute compiled binaries without written permission. Settings → License shows OASL plus third-party notices (PySide6/Qt, fonts, analog clock example). ===== Screenshots ===== {{https://www.astrastudio.de/wp-content/uploads/2026/08/OAS_Screenshot_1.0.0.png?800x|OnAirScreen main screen}} ===== Pictures of OnAirScreen in use ===== {{https://www.astrastudio.de/wp-content/uploads/2026/08/OAS_customer_images_00007.jpg?500x|OnAirScreen on a studio monitor at WILK-FM: digital clock, four mic timers, and status LEDs}} {{https://www.astrastudio.de/wp-content/uploads/2026/08/OAS_customer_images_00002.jpg?500x|Radio control room with three monitors, mixing desk, and OnAirScreen clock with meters on the left screen}} {{https://www.astrastudio.de/wp-content/uploads/2026/08/OAS_customer_images_00010.jpg?500x|Radio studio with digital mixer, three monitors, and OnAirScreen as a wall clock with station logo}} {{https://www.astrastudio.de/wp-content/uploads/2026/08/OAS_customer_images_00001.jpg?500x|Over-the-shoulder view in a podcast studio: video session on top, OnAirScreen clock on the lower monitor}} {{https://www.astrastudio.de/wp-content/uploads/2026/08/OAS_customer_images_00004.jpg?500x|Podcast studio with broadcast microphones, wood-panelled wall, and OnAirScreen clock on the lower monitor}} {{https://www.astrastudio.de/wp-content/uploads/2026/08/OAS_customer_images_00005.jpg?500x|Podcast table with four microphones; OnAirScreen clock and station logo on the wall monitor}} {{https://www.astrastudio.de/wp-content/uploads/2026/08/OAS_customer_images_00003.jpg?500x|Radio control room with Airlite mixer, broadcast microphone, and OnAirScreen on the studio monitors}} {{https://www.astrastudio.de/wp-content/uploads/2026/08/OAS_customer_images_00008.jpg?500x|TV gallery with multiview monitors, mixing desk, and OnAirScreen countdown on the wall}} {{https://www.astrastudio.de/wp-content/uploads/2026/08/OAS_customer_images_00009.jpg?500x|Camera rig with teleprompter and OnAirScreen timer in a television studio}} {{https://www.astrastudio.de/wp-content/uploads/2026/08/OAS_customer_images_00006.jpg?500x|Talk studio with a white table, broadcast microphones, and a red on-air lamp on the wall}}