onairscreen

Differences

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

Link to this comparison view

Both sides previous revision Previous revision
Next revision		 Previous revision
onairscreen [03.09.2026 22:46] – adminonairscreen [20.10.2026 12:58] (current) – external edit 127.0.0.1
Line 1: Line 1:
-{{ :oas.png?400|}} +{{ :oas_screenshot_1.0.0_v2.png?600|}}
-<markdown> +
-# OnAirScreen+
  
-Multipurpose "OnAir Lamp" solution targeted for use in professional broadcast environments 
  
-For the complete User Manual see here: [OnAirScreen – User Manual](https://www.astrastudio.de/wiki/onairscreen:manual-en)   +====== OnAirScreen ======
-Eine komplette Bedienungsanleitung gibt es hier: [OnAirScreen – Bedienungsanleitung](https://www.astrastudio.de/wiki/onairscreen:manual-de)+
  
-Latest release notes: </markdown>[[onairscreen:release_notes_0.9.8|OnAirScreen 0.9.8 — Release Notes]]<markdown>+Multipurpose **OnAir Lamp** for professional broadcast studios. Current version: **1.0.15**.
  
-#### Features +Product page: [[https://www.astrastudio.de/en/onairscreen/|astrastudio.de]]
-  * Flexible integration into existing studio setups +
-  * Customizable logo, colors and labels +
-  * 4:3 and 16:9/16:10 monitor aspect ratio support +
-  * Easy installation (Win/Linux/Mac binaries available) +
-  * Runs on RaspberryPi +
-  * Runs on Windows, Mac, Linux +
-  * Controlled via keyboard and network +
-  * Web-UI for remote control via browser +
-  * Web-UI: Dark Mode support with theme persistence +
-  * Web-UI: Real-time status updates via WebSocket +
-  * Web-UI: Warning priority system (NTP, Normal, Medium, High) +
-  * Web-UI: Improved compact layout for better space efficiency +
-  * REST-style API endpoints (/api/status, /api/command) +
-  * MQTT integration with Home Assistant Autodiscovery support +
-  * Event logging system for tracking all actions +
-  * Configurable log level settings (DEBUG, INFO, WARNING, ERROR, CRITICAL, NONE) +
-  * Command-line option to override log level (--loglevel) +
-  * Tooltips for all settings widgets +
-  * Preset/Profile management for saving and loading configurations +
-  * Unified error handling system with custom exceptions for better error tracking and debugging +
-  * Modular architecture with separated concerns (NTP, UI updates, system operations, etc.) +
-  * Weather Widget +
-  * Static or blinking colon in digital clock mode +
-  * OnAir Timer, Stopwatch, Countdown and more+
  
-</markdown> +Complete manuals:
-=== Documentation === +
-  * [[OAS:funktionstasten|Hotkeys/Action keys]] +
-  * [[OAS:API|API / UDP Commands, oas_send Command Syntax]] +
-  * [[OAS:changelog|Changelog – List of changes between versions]] +
-  * You can open the settings dialog with <key>Ctrl</key>+<key>s</key> or <key>Ctrl+,</key> +
-=== HOWTO's === +
-  * [[onairscreen_sd_card|Creating the microSD Card from the OnAirScreen SD-Card Image]] +
-  * [[onairscreen_macos|Make OnAirScreen Application executable under macOS]] +
-  * [[OnAirScreen Linux|Install OnAirScreen from a .deb (Linux / Raspberry Pi OS)]]+
  
 +  * 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 =====
  
-<markdown>+  * 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
  
-#### Precompiled Linux/Win/Mac versions +===== Documentation =====
-If you need ready-to-run Linux/Win/Mac executables, please visit https://www.astrastudio.de/software/onairscreen/. +
-You can purchase all versions of the latest build, including updates in the shop.+
  
-#### NTP Check +  * [[OAS:funktionstasten|Hotkeys / action keys]] 
-OnAirScreen checks the local (displayed) system time to an external NTP server from pool.ntp.org. Those server pools are unreliable from time to time and may lead to NTP warnings. You are advised to change pool.ntp.org to a stable or even local NTP server. +  * [[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 <key>Ctrl</key>+<key>S</key> or <key>Ctrl</key>+<key>,</key> (macOS: <key>Cmd</key>). Changes apply only after **Apply**.
  
-#### NTP Warnings +===== HOWTOs =====
-If the system time is more than 300ms of the NTP time, OnAirScreen will display a warning by default. You can either try to fix your system time and use a time source for your system that is reliable. Sync it every hour (see NTP glitches on Windows), or just disable the "NTP-Check and warning" (Settings->General), if you don't need the time with that accuracy.+
  
-#### NTP glitches on Windows +Pages as linked from [[start|the wiki start page]]:
-By default, Windows 10/8/7 syncs your system time with Internet servers on a weekly basis. This may lead to a wrong system time and a display of the wrong time in the OnAirScreen. Here are some tips how you can set the update interval. Recommended is something between 15m to 1h. +
-https://www.thewindowsclub.com/change-internet-time-update-interval-windows+
  
-#### Weather-Widget +  * [[OnAirScreen SD Card|Flash the Raspberry Pi OS SD-card image]] 
-To use the integrated weather widget, you require an openweathermap.org API key. +  * [[OnAirScreen MacOS|Make the OnAirScreen app executable under macOS]] 
-You can get one here: https://openweathermap.org/appid+  * [[OnAirScreen Linux|Install the .deb on Debian Linux and Raspberry Pi OS]]
  
-You also need to know the CityID of your location. Simply search for the desired city on https://openweathermap.org/ and click on it. +===== Precompiled builds =====
-You can then find the CityID at the end of the URL.+
  
-For example, London is: https://openweathermap.org/city/2643743 - 2643743+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.
  
-Once you have an API key and the CityID, just enter them in the settings dialog (Advanced tab)+Source is available under OASL 1.0 (see below). Official binaries may not be redistributed without written permission.
  
-#### mAirList Support +===== Time source and NTP check ===== 
-https://community.mairlist.com/t/ansteuerung-des-onairscreen/12457/16+ 
 +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).
  
-</markdown> 
 ===== Screenshots ===== ===== Screenshots =====
-{{https://cdn.rawgit.com/saschaludwig/oasdocs/main/images/OAS3.png?800x}} + 
-{{https://cdn.rawgit.com/saschaludwig/oasdocs/main/images/oas_configuration_1.png?500x}} +{{https://www.astrastudio.de/wp-content/uploads/2026/08/OAS_Screenshot_1.0.0.png?800x|OnAirScreen main screen}} 
-{{https://cdn.rawgit.com/saschaludwig/oasdocs/main/images/oas_configuration_2.png?500x}} +
-{{https://cdn.rawgit.com/saschaludwig/oasdocs/main/images/oas_webinterface_1.png?500x}}+
 ===== Pictures of OnAirScreen in use ===== ===== Pictures of OnAirScreen in use =====
-{{https://cdn.rawgit.com/saschaludwig/oasdocs/main/images/OAS1.jpeg?500x}} + 
-{{https://cdn.rawgit.com/saschaludwig/oasdocs/main/images/OAS2.jpeg?500x}} +{{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://cdn.rawgit.com/saschaludwig/oasdocs/main/images/OAS4.jpeg?500x}}+{{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}} 
  • onairscreen.1788475567.txt.gz
  • Last modified: 01.10.2026 17:43
  • (external edit)