mirror of
https://github.com/cjfranko/NTP-Timeturner.git
synced 2025-11-08 18:32:02 +00:00
38 lines
1.3 KiB
Markdown
38 lines
1.3 KiB
Markdown
# 🕰️ NTP Timeturner (alpha)
|
|
|
|
**An LTC-driven NTP server for Raspberry Pi, built with broadcast precision and a hint of magic.**
|
|
|
|
Inspired by the TimeTurner in the Harry Potter series, this project synchronises timecode-locked systems by decoding incoming LTC (Linear Time Code) and broadcasting it as NTP — with precision as Hermione would insist upon.
|
|
|
|
---
|
|
|
|
## 📦 Hardware Requirements
|
|
|
|
- Raspberry Pi 5 (Dev Platform) but should be supported by Pi v3 (or better)
|
|
- Debian Bookworm (64-bit recommended)
|
|
- Teensy 4.0 - https://thepihut.com/products/teensy-4-0-headers
|
|
- Audio Adapter Board for Teensy 4.0 (Rev D) - https://thepihut.com/products/audio-adapter-board-for-teensy-4-0
|
|
- Ethernet connection (recommended for stable NTP)
|
|
- Optional: LTC generator for input testing - Windows/Mac App - https://timecodesync.com/generator/
|
|
|
|
---
|
|
|
|
## 🛠️ Software Features
|
|
|
|
- Reads SMPTE LTC from Audio Interface (3.5mm TRS but adaptable to BNC/XLR)
|
|
- 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:
|
|
|
|
```bash
|
|
wget https://raw.githubusercontent.com/cjfranko/NTP-Timeturner/master/setup.sh
|
|
chmod +x setup.sh
|
|
./setup.sh
|