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

37 lines
1.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 🕰️ 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:
```bash
wget https://raw.githubusercontent.com/cjfranko/NTP-Timeturner/master/setup.sh
chmod +x setup.sh
./setup.sh