chaos/NTP-Timeturner
1
0
Fork 0
mirror of https://github.com/cjfranko/NTP-Timeturner.git synced 2025-11-08 18:32:02 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
A NTP Server with LTC Input and Offsetting Options
51 commits 5 branches 5 tags 39 MiB
Find a file
Chris Frankland-Wright b51a47457e
Delete package.json
2025-07-07 00:12:36 +01:00
.gitattributes Add .gitattributes, .gitignore, and README.md. 2024-07-27 20:16:00 +01:00
.gitignore Add .gitattributes, .gitignore, and README.md. 2024-07-27 20:16:00 +01:00
config.json stashed some initial files, removed the redundant hermione modules 2025-06-23 18:26:51 +01:00
decode_ltc.py current build before revised methodology to decode live 2025-07-02 18:33:40 +01:00
ltc_probe.py additional diagnostic 2025-06-24 21:55:26 +01:00
package-lock.json Add project files. 2024-07-27 20:16:03 +01:00
README.md Update README.md 2025-06-23 17:31:09 +01:00
setup.sh updated setup 2025-07-02 22:55:15 +01:00
splash.png Rename wallpaper.png to splash.png 2025-06-24 22:29:29 +01:00
test_audioinput.py creates png of audio input 2025-06-24 20:12:37 +01:00
timeturner.jpg visual updates 2025-06-23 16:41:28 +01:00
timeturner.py updated setup 2025-07-02 22:55:15 +01:00

README.md

🕰️ NTP Timeturner (alpha)

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

Inspired by Hermione Granger’s 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