Skip to content

13 Years 1.5.0

Choose a tag to compare

@TristonYoder TristonYoder released this 14 Oct 16:41
· 10 commits to main since this release
8f18009

Remote Producers and hosted clocks

1.5.0 puts the whole 13 Years engine in a shared Swift package, ThirteenYearsClockKit. The Mac and iPad Producers run on it, and so does a new headless Producer that runs on Linux, so a show clock can be hosted anywhere and controlled from any Producer.

Producer (Mac, iPad)

  • Connect To… a remote Producer or hosted clock. It opens in the same window, with a magenta title bar while you're connected. The close button and File ▸ Disconnect (⇧⌘W) end the session.
  • Pagers on this network, in Settings ▸ Remote Producer:
    • Control Only
    • Introducer: advertises the clock server so pagers connect to it directly
    • Local Relay: pagers connect to this Producer, which relays to the server
  • Your own files on the remote. Open, Open Recent and New from Template load your local run sheets onto the remote. Save writes the remote's state to a local file. Flash a Pager works during remote sessions.
  • Planning Center belongs to the remote. Sign in from your Producer; the remote keeps the login and does all the syncing itself.
  • Recents and startup. Remote hosts and templates appear in the launcher recents, and "Connect to a remote Producer" is a startup option.
  • No broadcasting at launch. A fresh launch doesn't advertise to pagers until a document is open or a relay session starts.
  • Settings stay available during remote sessions. Only the local Control API switch is locked. The "Act as Master Controller" toggle is gone.

Pagers (iPhone, iPad, Apple TV, Mac, web, ESP32)

  • Any server, any port. Enter host:port to reach a hosted clock server directly.
  • Steadier connection handling:
    • the display dims after 5 s without data and shows the connection screen after 20 s
    • short dropouts no longer pause the countdown
    • Settings show the link state immediately
  • Producer time. The local-time clock shows the producer's time, corrected for network delay and in the producer's time zone, and flips exactly with the producer's seconds.
  • Follows Introducer hints and magic packets. Pagers act on Introducer advertisements and on magic packets that carry a host and port.
  • Readable host field. The manual host field on the waiting screen is easier to read.

Protocol and API

  • Faster keep-alive. v2 sends a digest every 2 s, about 30 B/s per idle pager.
  • New Control API routes:
    • PUT /v1/document loads a complete run sheet
    • POST /v1/pco/authorize and /v1/pco/authorize/complete handle Planning Center sign-in on behalf of the remote
  • /v1/network/master is deprecated.
  • ASSIGN_PRODUCER now carries a port and a mode.
  • More in the state: utcOffsetSeconds is included.
  • Docs: see CONTROL-API.md and Server/PROTOCOL-V2.md (v2.4).

Companion

Downloads

File Contents
13-Years-Producer-1.5.0.dmg 13 Years Producer + 13 Years Pager for Mac
13-Years-1.5.0.dmg 13 Years (Mac Pager)

Both disk images are notarized and stapled. The checksums are in SHA256SUMS. The iPhone, iPad, Apple TV and Mac Pagers are on TestFlight as 1.5.0 (11).