NTP-Timeturner/README.md
Chris Frankland-Wright 9fe70f4688 final commit for the day
2025-06-23 17:25:23 +01:00

1.1 KiB
Raw Blame History

🕰️ NTP Timeturner

An LTC-driven NTP server for Raspberry Pi, built with broadcast precision and a hint of magic.

Inspired by Hermione Grangers TimeTurner, this project synchronises timecode-locked systems by decoding incoming LTC (Linear Time Code) and broadcasting it as NTP — with precision down to the millisecond.


📦 Hardware Requirements

  • Raspberry Pi 3 (or better)
  • Debian Bookworm (64-bit recommended)
  • USB audio input (e.g. USB to 3.5mm TRS adapter)
  • Ethernet connection (recommended for stable NTP)
  • Optional: Blackmagic Video Assist or LTC generator for input testing

🛠️ Software Features

  • Reads SMPTE LTC from audio input (25p/50i to start, with more frame rate support to follow)
  • Converts LTC into NTP-synced time
  • Broadcasts time via local NTP server
  • Supports configurable time offsets (hours, minutes, seconds, milliseconds)
  • Systemd service support for headless operation
  • Optional splash screen branding at boot

🚀 Installation

Clone and run the installer:

wget https://raw.githubusercontent.com/cjfranko/NTP-Timeturner/master/setup.sh
chmod +x setup.sh
./setup.sh