onairscreen:manual-en

Differences

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

Link to this comparison view

Both sides previous revision Previous revision
onairscreen:manual-en [27.09.2026 01:27] – external edit 127.0.0.1onairscreen:manual-en [27.09.2026 02:22] (current) – external edit 127.0.0.1
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 268: Line 268:
 | **Network**      | UDP, HTTP, multicast, MQTT, OSC, SNMP                                       | | **Network**      | UDP, HTTP, multicast, MQTT, OSC, SNMP                                       |
 | **Links**        | Discover other OnAirScreens; replicas (1→n full status) and source mappings | | **Links**        | Discover other OnAirScreens; replicas (1→n full status) and source mappings |
-| **Time Source**  | Local / NTP / PTPv2 / LTC clock, NTP check                                  | 
 | **Advanced**     | Formatting, weather                                                         | | **Advanced**     | Formatting, weather                                                         |
 | **Timers**       | AIR timers 1–4                                                              | | **Timers**       | AIR timers 1–4                                                              |
 | **Fonts**        | Fonts for all elements                                                      | | **Fonts**        | Fonts for all elements                                                      |
 +| **Time Source**  | Local / NTP / PTPv2 / LTC clock, NTP check                                  |
 | **Audio Meters** | Level meters, source, TooLoud, Silence Detection                            | | **Audio Meters** | Level meters, source, TooLoud, Silence Detection                            |
 | **GPIO**         | Raspberry Pi, Axia Livewire, and MIDI inputs (parallel)                     | | **GPIO**         | Raspberry Pi, Axia Livewire, and MIDI inputs (parallel)                     |
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/slave roles: any instance can publish replicas **and** subscribe to sources. 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/slave roles: any instance can publish replicas **and** subscribe to sources.
Line 540: Line 540:
 | Replica of              | `Links/follow_instance` | *(empty)* | Written when another screen adds this one as a replica                                                                                                                                                                                       | | Replica of              | `Links/follow_instance` | *(empty)* | Written when another screen adds this one as a replica                                                                                                                                                                                       |
  
- 
---- 
- 
- 
- 
-### 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()`), so a jump of the system clock does not move the studio clock. LTC may jump, freeze, and includes frames (`HH:MM:SS:FF`). 
- 
-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            | Key                            | Default        | Description                                                               | 
-| ------------------ | ------------------------------ | -------------- | ------------------------------------------------------------------------- | 
-| Time Source        | `TimeSource/source`            | `local`        | `local`, `ntp`, `ptp`, or `ltc`                                           | 
-| Enable NTP-Check   | `NTP/ntpcheck`                 | `true`         | Warning if time diverges from the NTP server or the server is unreachable | 
-| NTP Server         | `NTP/ntpcheckserver`           | `pool.ntp.org` | NTP server for NTP as time source **and** for the optional NTP check      | 
-| PTP Interface      | `TimeSource/ptp_iface`         | *(empty)*      | IPv4 address of the PTP network interface (independent of AoIP)           | 
-| PTP Domain         | `TimeSource/ptp_domain`        | `0`            | IEEE 1588 domain (0–255)                                                  | 
-| LTC Input          | `TimeSource/ltc_input`         | `serial`       | `serial` (LBE-1110) or `audio` (local PortAudio decode)                   | 
-| LTC Serial Port    | `TimeSource/ltc_port`          | *(empty)*      | USB serial device of the LBE-1110; empty = Auto                           | 
-| LTC Audio Device   | `TimeSource/ltc_audio_device`  | *(empty)*      | Local capture device; empty = system default                              | 
-| LTC Channel        | `TimeSource/ltc_audio_channel` | `0`            | `0` = Left, `1` = Right                                                   | 
-| LTC unlock warning | `TimeSource/ltc_warn`          | `false`        | WARN text when LTC drops; the `LTC NOT LOCKED` LED always remains         | 
- 
- 
-**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:** Software slave on multicast `224.0.1.129` UDP 319/320 (event/general), delay mechanism E2E. Typical accuracy is milliseconds (no hardware timestamping). Choose the studio/AoIP VLAN interface independently of the Audio Meters AoIP interface. Loss of Sync: last time keeps running plus warning. If UDP 319/320 cannot be bound (another stack already holds the ports), the slave retries every few seconds; the lock LED and WARN show `PTP ERROR` until the ports are free. Details stay in the log. On Linux and Raspberry Pi OS, shop `.deb`/`.rpm`/SD images install the `/usr/lib/onairscreen/oas-ptp-bind` helper for UDP 319/320. 
- 
-**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`, `LTC reader not connected`) are **off by default** so video scrubbing does not flood WARN; enable **Show LTC unlock warning** if you want them. The lock LED always shows `LTC LOCK` / `LTC NOT LOCKED`. NTP-Check still compares the OS clock to the NTP server, not the timecode. 
- 
-**LBE-1110 Serial:** USB CDC virtual serial port of a [Leo Bodnar LBE-1110](https://www.leobodnar.com/shop/index.php?main_page=product_info&cPath=120&products_id=374); no drivers. Auto selects a Leo Bodnar device (USB VID `0x1DD2`) or an LBE-1110 / CDC port. 
- 
-**Audio Input:** Decodes SMPTE LTC (biphase-mark) from a **local** PortAudio capture device, independent of Audio Meters (not Livewire/AES67). Choose Left or Right (default Left). On some hosts the same device cannot be opened twice — if meters already use that input, pick a different device for LTC. 
- 
-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:** Use a local NTP server on your studio network, as `pool.ntp.org` can be unreliable at times. 
  
 --- ---
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()`), so a jump of the system clock does not move the studio clock. LTC may jump, freeze, and includes frames (`HH:MM:SS:FF`).
  
-| Element            | Description                                                 | +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.
-| ------------------ | ----------------------------------------------------------- | +
-| Version            | Current OnAirScreen version                                 | +
-| Distribution       | `OpenSource` or commercial distribution                     | +
-| Settings Path      | Path to the configuration file on this system               | +
-| Log Folder         | Folder with `onairscreen.log` and crash reports             | +
-| Open log folder    | Opens that folder in the system file manager                | +
-| Loglevel           | `DEBUG`, `INFO`, `WARNING`, `ERROR`, `CRITICAL`, `NONE`     | +
-| Enable Reset       | Checkbox to enable the reset button                         | +
-| Reset all settings | Resets **all** settings to defaults (cannot be undone)      | +
-| Reboot             | Reboot the host operating system (asks for confirmation)    | +
-| Shutdown           | Shut down the host operating system (asks for confirmation) |+
  
 +
 +| Setting            | Key                            | Default        | Description                                                               |
 +| ------------------ | ------------------------------ | -------------- | ------------------------------------------------------------------------- |
 +| Time Source        | `TimeSource/source`            | `local`        | `local`, `ntp`, `ptp`, or `ltc`                                           |
 +| Enable NTP-Check   | `NTP/ntpcheck`                 | `true`         | Warning if time diverges from the NTP server or the server is unreachable |
 +| NTP Server         | `NTP/ntpcheckserver`           | `pool.ntp.org` | NTP server for NTP as time source **and** for the optional NTP check      |
 +| PTP Interface      | `TimeSource/ptp_iface`         | *(empty)*      | IPv4 address of the PTP network interface (independent of AoIP)           |
 +| PTP Domain         | `TimeSource/ptp_domain`        | `0`            | IEEE 1588 domain (0–255)                                                  |
 +| LTC Input          | `TimeSource/ltc_input`         | `serial`       | `serial` (LBE-1110) or `audio` (local PortAudio decode)                   |
 +| LTC Serial Port    | `TimeSource/ltc_port`          | *(empty)*      | USB serial device of the LBE-1110; empty = Auto                           |
 +| LTC Audio Device   | `TimeSource/ltc_audio_device`  | *(empty)*      | Local capture device; empty = system default                              |
 +| LTC Channel        | `TimeSource/ltc_audio_channel` | `0`            | `0` = Left, `1` = Right                                                   |
 +| LTC unlock warning | `TimeSource/ltc_warn`          | `false`        | WARN text when LTC drops; the `LTC NOT LOCKED` LED always remains         |
 +
 +
 +**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:** Software slave on multicast `224.0.1.129` UDP 319/320 (event/general), delay mechanism E2E. Typical accuracy is milliseconds (no hardware timestamping). Choose the studio/AoIP VLAN interface independently of the Audio Meters AoIP interface. Loss of Sync: last time keeps running plus warning. If UDP 319/320 cannot be bound (another stack already holds the ports), the slave retries every few seconds; the lock LED and WARN show `PTP ERROR` until the ports are free. Details stay in the log. On Linux and Raspberry Pi OS, shop `.deb`/`.rpm`/SD images install the `/usr/lib/onairscreen/oas-ptp-bind` helper for UDP 319/320.
 +
 +**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`, `LTC reader not connected`) are **off by default** so video scrubbing does not flood WARN; enable **Show LTC unlock warning** if you want them. The lock LED always shows `LTC LOCK` / `LTC NOT LOCKED`. NTP-Check still compares the OS clock to the NTP server, not the timecode.
 +
 +**LBE-1110 Serial:** USB CDC virtual serial port of a [Leo Bodnar LBE-1110](https://www.leobodnar.com/shop/index.php?main_page=product_info&cPath=120&products_id=374); no drivers. Auto selects a Leo Bodnar device (USB VID `0x1DD2`) or an LBE-1110 / CDC port.
 +
 +**Audio Input:** Decodes SMPTE LTC (biphase-mark) from a **local** PortAudio capture device, independent of Audio Meters (not Livewire/AES67). Choose Left or Right (default Left). On some hosts the same device cannot be opened twice — if meters already use that input, pick a different device for LTC.
 +
 +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:** Use a local NTP server on your studio network, as `pool.ntp.org` can be unreliable at times.
  
 --- ---
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            | Description                                                 |
 +| ------------------ | ----------------------------------------------------------- |
 +| Version            | Current OnAirScreen version                                 |
 +| Distribution       | `OpenSource` or commercial distribution                     |
 +| Settings Path      | Path to the configuration file on this system               |
 +| Log Folder         | Folder with `onairscreen.log` and crash reports             |
 +| Open log folder    | Opens that folder in the system file manager                |
 +| Loglevel           | `DEBUG`, `INFO`, `WARNING`, `ERROR`, `CRITICAL`, `NONE`     |
 +| Enable Reset       | Checkbox to enable the reset button                         |
 +| Reset all settings | Resets **all** settings to defaults (cannot be undone)      |
 +| Reboot             | Reboot the host operating system (asks for confirmation)    |
 +| Shutdown           | Shut down the host operating system (asks for confirmation) |
 +
  
 --- ---
Line 1101: Line 1101:
  
 - **Text clock:** Spoken time display (e.g. "it's a quarter past three") - **Text clock:** Spoken time display (e.g. "it's a quarter past three")
-- **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)
  • onairscreen/manual-en.txt
  • Last modified: 27.09.2026 02:22
  • by 127.0.0.1