mirror of https://github.com/cjfranko/NTP-Timeturner.git synced 2025-11-08 18:32:02 +00:00

A NTP Server with LTC Input and Offsetting Options

Find a file

John Rogers 1506c464e9 docs: update footnote to emphasize support for trans rights and their contributions to technology		2025-07-10 20:02:12 +01:00
.github	ci: separate test workflow for parallel execution	2025-07-10 19:31:09 +01:00
firmware	Add files via upload	2025-07-07 18:40:05 +01:00
src	feat: add PTP integration tests for LTC timecode synchronization	2025-07-10 19:00:58 +01:00
tests	style: remove unused Arc and Mutex imports	2025-07-10 19:38:11 +01:00
.gitattributes	Add .gitattributes, .gitignore, and README.md.	2024-07-27 20:16:00 +01:00
.gitignore	Update .gitignore to include Rust build artifacts and JetBrains specific files	2025-07-10 12:25:32 +01:00
Cargo.toml	feat: add PTP integration tests for LTC timecode synchronization	2025-07-10 19:00:58 +01:00
config.json	docs: Update README and setup.sh for PTP integration and configuration	2025-07-10 19:03:45 +01:00
README.md	docs: update footnote to emphasize support for trans rights and their contributions to technology	2025-07-10 20:02:12 +01:00
setup.sh	docs: Update README and setup.sh for PTP integration and configuration	2025-07-10 19:03:45 +01:00
splash.png	Rename wallpaper.png to splash.png	2025-06-24 22:29:29 +01:00
test_ltc_serial.py	final test_ltc_serial.py	2025-07-07 20:23:28 +01:00
timeturner.py	final python script version - moving to RUST	2025-07-08 18:50:12 +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 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.

1: *Editor's Note: Trans rights are Your Human Rights 🏳️‍⚧️. While the author of the Harry Potter series holds horrible backwards old-fashioned and abhorant views. we believe in supporting trans, non-binary, and gender-diverse people.I If you find this software useful please consider donating to Mermaids, a UK charity supporting trans, non-binary, and gender-diverse children, young people, and their families since 1995.

📦 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 broadcast)
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 (to update)

For Rust install you can do

cargo install --git https://github.com/cjfranko/NTP-Timeturner

Clone and run the installer:

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