Differences
This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision | ||
| onairscreen:manual-en [27.09.2026 01:27] – external edit 127.0.0.1 | onairscreen:manual-en [22.10.2026 19:07] (current) – external edit 127.0.0.1 | ||
|---|---|---|---|
| Line 2: | Line 2: | ||
| # OnAirScreen – User Manual | # OnAirScreen – User Manual | ||
| - | **Version: | + | **Version: |
| **Author:** Sascha Ludwig, [astrastudio.de](http:// | **Author:** Sascha Ludwig, [astrastudio.de](http:// | ||
| **Project: | **Project: | ||
| Line 69: | Line 69: | ||
| An older portable `.exe` is **not** removed by the MSI. Delete that copy yourself after installing. | An older portable `.exe` is **not** removed by the MSI. Delete that copy yourself after installing. | ||
| - | Windows only syncs internet time about once a week by default, which can show the wrong clock if the time source is **Local**. Shorten the OS sync interval, or use NTP / PTP / LTC in OnAirScreen (see [5.3 Time Source](#53-time-source)). | + | Windows only syncs internet time about once a week by default, which can show the wrong clock if the time source is **Local**. Shorten the OS sync interval, or use NTP / PTP / LTC in OnAirScreen (see [5.8 Time Source](#time_source)). |
| ### macOS | ### macOS | ||
| Line 265: | Line 265: | ||
| | ---------------- | --------------------------------------------------------------------------- | | | ---------------- | --------------------------------------------------------------------------- | | ||
| | **General** | | **General** | ||
| - | | **Updates** | + | | **Updates** |
| | **Network** | | **Network** | ||
| | **Links** | | **Links** | ||
| - | | **Time Source** | ||
| | **Advanced** | | **Advanced** | ||
| | **Timers** | | **Timers** | ||
| | **Fonts** | | **Fonts** | ||
| + | | **Time Source** | ||
| | **Audio Meters** | Level meters, source, TooLoud, Silence Detection | | **Audio Meters** | Level meters, source, TooLoud, Silence Detection | ||
| | **GPIO** | | **GPIO** | ||
| Line 413: | Line 413: | ||
| | Setting | | Setting | ||
| | --------------------- | --------------------------- | --------- | --------------------------------------------- | | | --------------------- | --------------------------- | --------- | --------------------------------------------- | | ||
| - | | Check for updates | + | | Check for updates |
| - | | Update | + | | License |
| | Include Beta Versions | `General/ | | Include Beta Versions | `General/ | ||
| - | > The update feature is intended for **precompiled (paid) versions**. | + | > Update notices are intended for **precompiled (paid) versions**. |
| > | > | ||
| - | > To use update checking in the paid version, an **Update | + | > The **License |
| Line 428: | Line 428: | ||
| Shop builds must be activated. Self-built OpenSource builds are not. | Shop builds must be activated. Self-built OpenSource builds are not. | ||
| - | 1. Copy the update | + | 1. Copy the license |
| - | 2. **Activate** (needs internet) or copy the **Hardware ID**, download a license file in the portal, and **Import license file**. | + | 2. **Activate** (needs internet) or copy the **Hardware ID**, download a license file in the portal, and **Import license file**. Either success turns **Check for updates** on and saves that. |
| - | 3. The activation is valid for one year unless your order is set differently. The Updates tab shows whether this computer can renew online now. If the license server is not reachable, download a new license file in the portal and import it before the activation expires. The update | + | 3. The activation is valid for one year unless your order is set differently. The Updates tab shows whether this computer can renew online now. If the license server is not reachable, download a new license file in the portal and import it before the activation expires. The license |
| 4. To move the license, choose **Return license**, then redeem the return code in the portal (or it is redeemed automatically when this computer is online). Activate the new computer. A dead computer can only be released by astrastudio support. | 4. To move the license, choose **Return license**, then redeem the return code in the portal (or it is redeemed automatically when this computer is online). Activate the new computer. A dead computer can only be released by astrastudio support. | ||
| 5. Without a license, OnAirScreen runs fully for 14 days. After that it stays visible but cannot go fullscreen, use GPIO or audio meters, or save settings. The window is limited to 1280×800 and the app closes after 15 minutes. The same limits apply when a license has expired. | 5. Without a license, OnAirScreen runs fully for 14 days. After that it stays visible but cannot go fullscreen, use GPIO or audio meters, or save settings. The window is limited to 1280×800 and the app closes after 15 minutes. The same limits apply when a license has expired. | ||
| - | 6. At startup the update | + | 6. At startup |
| If this activation does not fit your use case, contact us via the [contact form](https:// | If this activation does not fit your use case, contact us via the [contact form](https:// | ||
| Line 520: | Line 520: | ||
| - | ### Links | + | ### 5.4 Links |
| Link several OnAirScreens on the LAN (multicast discovery by **instance name**) or by typing a host and HTTP port. Instance names must be unique; a collision is flagged in Settings and the Web UI, and Apply is rejected. There are no exclusive master/ | Link several OnAirScreens on the LAN (multicast discovery by **instance name**) or by typing a host and HTTP port. Instance names must be unique; a collision is flagged in Settings and the Web UI, and Apply is rejected. There are no exclusive master/ | ||
| Line 540: | Line 540: | ||
| | Replica of | `Links/ | | Replica of | `Links/ | ||
| - | |||
| - | --- | ||
| - | |||
| - | |||
| - | |||
| - | ### 5.4 Time Source | ||
| - | |||
| - | The display clock can follow the local system clock, an NTP server, a PTPv2 (IEEE 1588-2008) master, or SMPTE LTC (Leo Bodnar LBE-1110 USB serial **or** decoded from a local audio input). **OnAirScreen never changes the operating-system clock.** NTP and PTP steer an independent timebase (`time.monotonic()`), | ||
| - | |||
| - | Date, text clock, and AIR3 top-of-hour follow the same wall time as the large clock when the source is Local, NTP, or PTP. With LTC they keep using the system date/time, because LTC has no calendar date. | ||
| - | |||
| - | |||
| - | | Setting | ||
| - | | ------------------ | ------------------------------ | -------------- | ------------------------------------------------------------------------- | | ||
| - | | Time Source | ||
| - | | Enable NTP-Check | ||
| - | | NTP Server | ||
| - | | PTP Interface | ||
| - | | PTP Domain | ||
| - | | LTC Input | `TimeSource/ | ||
| - | | LTC Serial Port | `TimeSource/ | ||
| - | | LTC Audio Device | ||
| - | | LTC Channel | ||
| - | | LTC unlock warning | `TimeSource/ | ||
| - | |||
| - | |||
| - | **Local System Clock:** The display uses the OS clock. With NTP-Check enabled, the OS clock is compared to the NTP server (deviation > 0.3 s or errors → warning, priority -1). | ||
| - | |||
| - | **NTP Server:** OnAirScreen queries the NTP Server field and steers its own clock. The OS time is not used after the first successful sample. The field stays editable even when NTP-Check is off. Loss of NTP: last time keeps running and a warning is shown. | ||
| - | |||
| - | **PTPv2 IEEE 1588-2008: | ||
| - | |||
| - | **LTC:** One time source with two inputs. Frame rate is inferred from incoming frames (24 / 25 / 30). Loss of LTC: last timecode is frozen (`LTC NOT LOCKED`). The large WARN messages (`waiting for LTC lock`, `Clock not LTC synchronized`, | ||
| - | |||
| - | **LBE-1110 Serial:** USB CDC virtual serial port of a [Leo Bodnar LBE-1110](https:// | ||
| - | |||
| - | **Audio Input:** Decodes SMPTE LTC (biphase-mark) from a **local** PortAudio capture device, independent of Audio Meters (not Livewire/ | ||
| - | |||
| - | The clock lock LED (bottom right) is green when the selected source is locked and red when it is not. Next to it: `PTP LOCK` / `PTP NOT LOCKED` / `PTP ERROR`, `NTP LOCK` / `NTP NOT LOCKED`, `LTC LOCK` / `LTC NOT LOCKED`, or `LOCAL`. | ||
| - | |||
| - | > **Recommendation: | ||
| --- | --- | ||
| Line 596: | Line 555: | ||
| - | **Available text clock languages: | + | **Available text clock languages: |
| **Date format placeholders** (Qt notation, excerpt): | **Date format placeholders** (Qt notation, excerpt): | ||
| Line 693: | Line 652: | ||
| - | ### 5.8 About | + | ### 5.8 Time Source |
| + | The display clock can follow the local system clock, an NTP server, a PTPv2 (IEEE 1588-2008) master, or SMPTE LTC (Leo Bodnar LBE-1110 USB serial **or** decoded from a local audio input). **OnAirScreen never changes the operating-system clock.** NTP and PTP steer an independent timebase (`time.monotonic()`), | ||
| - | | Element | + | Date, text clock, and AIR3 top-of-hour follow |
| - | | ------------------ | ----------------------------------------------------------- | | + | |
| - | | Version | + | |
| - | | Distribution | + | |
| - | | Settings Path | Path to the configuration file on this system | + | |
| - | | Log Folder | + | |
| - | | Open log folder | + | |
| - | | Loglevel | + | |
| - | | Enable Reset | Checkbox to enable the reset button | + | |
| - | | Reset all settings | Resets **all** settings to defaults (cannot be undone) | + | |
| - | | Reboot | + | |
| - | | Shutdown | + | |
| + | |||
| + | | Setting | ||
| + | | ------------------ | ------------------------------ | -------------- | ------------------------------------------------------------------------- | | ||
| + | | Time Source | ||
| + | | Enable NTP-Check | ||
| + | | NTP Server | ||
| + | | PTP Interface | ||
| + | | PTP Domain | ||
| + | | LTC Input | `TimeSource/ | ||
| + | | LTC Serial Port | `TimeSource/ | ||
| + | | LTC Audio Device | ||
| + | | LTC Channel | ||
| + | | LTC unlock warning | `TimeSource/ | ||
| + | |||
| + | |||
| + | **Local System Clock:** The display uses the OS clock. With NTP-Check enabled, the OS clock is compared to the NTP server (deviation > 0.3 s or errors → warning, priority -1). | ||
| + | |||
| + | **NTP Server:** OnAirScreen queries the NTP Server field and steers its own clock. The OS time is not used after the first successful sample. The field stays editable even when NTP-Check is off. Loss of NTP: last time keeps running and a warning is shown. | ||
| + | |||
| + | **PTPv2 IEEE 1588-2008: | ||
| + | |||
| + | **LTC:** One time source with two inputs. Frame rate is inferred from incoming frames (24 / 25 / 30). Loss of LTC: last timecode is frozen (`LTC NOT LOCKED`). The large WARN messages (`waiting for LTC lock`, `Clock not LTC synchronized`, | ||
| + | |||
| + | **LBE-1110 Serial:** USB CDC virtual serial port of a [Leo Bodnar LBE-1110](https:// | ||
| + | |||
| + | **Audio Input:** Decodes SMPTE LTC (biphase-mark) from a **local** PortAudio capture device, independent of Audio Meters (not Livewire/ | ||
| + | |||
| + | The clock lock LED (bottom right) is green when the selected source is locked and red when it is not. Next to it: `PTP LOCK` / `PTP NOT LOCKED` / `PTP ERROR`, `NTP LOCK` / `NTP NOT LOCKED`, `LTC LOCK` / `LTC NOT LOCKED`, or `LOCAL`. | ||
| + | |||
| + | > **Recommendation: | ||
| --- | --- | ||
| Line 727: | Line 706: | ||
| | Audio Input | `Audio/ | | Audio Input | `Audio/ | ||
| | Livewire Channel | | Livewire Channel | ||
| - | | AoIP Interface | + | | AoIP Interface |
| | AES67 Stream ID | `Audio/ | | AES67 Stream ID | `Audio/ | ||
| | AES67 Address | | AES67 Address | ||
| Line 894: | Line 873: | ||
| | Port | `GPIO/ | | Port | `GPIO/ | ||
| | Password | | Password | ||
| - | | AoIP interface | + | | AoIP interface |
| | Debounce | | Debounce | ||
| | GPI*n* Enable | | GPI*n* Enable | ||
| Line 967: | Line 946: | ||
| Eight rules. A microphone that is already on when OnAirScreen starts turns a matching rule on as soon as that input level is known. | Eight rules. A microphone that is already on when OnAirScreen starts turns a matching rule on as soon as that input level is known. | ||
| + | |||
| + | --- | ||
| + | |||
| + | |||
| + | |||
| + | ### 5.11 About | ||
| + | |||
| + | |||
| + | | Element | ||
| + | | ------------------ | ----------------------------------------------------------- | | ||
| + | | Version | ||
| + | | Distribution | ||
| + | | Settings Path | Path to the configuration file on this system | ||
| + | | Log Folder | ||
| + | | Open log folder | ||
| + | | Loglevel | ||
| + | | Enable Reset | Checkbox to enable the reset button | ||
| + | | Reset all settings | Resets **all** settings to defaults (cannot be undone) | ||
| + | | Reboot | ||
| + | | Shutdown | ||
| + | |||
| --- | --- | ||
| Line 1101: | Line 1101: | ||
| - **Text clock:** Spoken time display (e.g. " | - **Text clock:** Spoken time display (e.g. " | ||
| - | - **Time source:** Local, NTP, PTPv2, or LTC — see [5.3 Time Source](#53-time-source); the OS clock is never set | + | - **Time source:** Local, NTP, PTPv2, or LTC — see [5.8 Time Source](#time_source); the OS clock is never set |
| - **Lock LED** bottom right: green = locked, red = not locked (`PTP LOCK` / `NTP LOCK` / `LTC LOCK`, or `LOCAL`) | - **Lock LED** bottom right: green = locked, red = not locked (`PTP LOCK` / `NTP LOCK` / `LTC LOCK`, or `LOCAL`) | ||
| - **Weather widget:** Optionally displayed next to the clock (OpenWeatherMap) | - **Weather widget:** Optionally displayed next to the clock (OpenWeatherMap) | ||
| Line 1203: | Line 1203: | ||
| " | " | ||
| " | " | ||
| - | " | + | " |
| " | " | ||
| " | " | ||
| Line 1308: | Line 1308: | ||
| Drag presets for LED1–4 (toggle + colour), AIR1–4 with live caption and time on the button (MIC = AIR1), TOTH, Reset AIR3/4, NOW / NEXT / WARN, Silence, Loudness I+LRA, and Reset I+LRA. | Drag presets for LED1–4 (toggle + colour), AIR1–4 with live caption and time on the button (MIC = AIR1), TOTH, Reset AIR3/4, NOW / NEXT / WARN, Silence, Loudness I+LRA, and Reset I+LRA. | ||
| - | Variables such as `$(oas: | + | Variables such as `$(oas: |
| If you cannot load a custom module, **Generic OSC** remains available (next section). Status push over OSC is slower (every 5 seconds) than the HTTP poll / WebSocket. | If you cannot load a custom module, **Generic OSC** remains available (next section). Status push over OSC is slower (every 5 seconds) than the HTTP poll / WebSocket. | ||
| Line 1465: | Line 1465: | ||
| | `CONF: | | `CONF: | ||
| | `CONF: | | `CONF: | ||
| - | | `CONF: | + | | `CONF: |
| | `CONF: | | `CONF: | ||
| | `CONF: | | `CONF: | ||