Systemübersicht

TeamRacePilot ist die Zentrale. Externe Geräte und Tools liefern Daten hinein; die App verarbeitet und gibt Ergebnisse in verschiedenen Formaten aus.

Input
Output
ANMELDUNG
iOS-Device HTTP: lokales WLAN, get/post
IP per QR-Code aus TeamRacePilot
Externes Tool: CSV Anmeldedaten-Export · csv
ZEITNAHME
BIB-Scanner iOS
  • Bonjour → HTTP POST
  • Clipboard (gleiche Apple-ID)
  • CSV (AirDrop, Mail…)
RFID Kathrein (experimentell, für Bastler)
  • TCP 4007
  • RRU4 ELC E6; WRA3070
Externe Zeitnahme
  • CSV-Export
Event-Daten Extern gespeichert (.json)
MAC 2 – macOS
Gemeinsamer Netzwerkpfad

MAC 1 – macOS

Anbindung
· HTTP 8080 – iOS Anmeldung
· TCP 4007 – KATHREIN RFID
· FTP/SFTP/FTPS – HTML Server
· Netzwerkpfad + RunLock
Eventverwaltung
Teilnehmerverwaltung
Interne Anmeldung · Import HTML · CSV
BIB / Urkunden Design
Zeitnahme
Intern: manuell, RFID
Import: BIB-Scanner, CSV
Output: Teilnehmerliste, Startliste, Ergebnisliste, Gesamtergebnisliste, Vereinsliste, Quittungen, Urkunden, index.html Template
Event-Daten: Backup & Import
Internet-Upload FTP/SFTP/FTPS
index.html · Startliste · Ergebnisliste (Lauf & Gesamt) · Urkunden · optional: Vereinsliste, Quittungen
Listen pdf · html · csv · Drucker
Teilnehmerliste · Startliste · Vereinsliste · Ergebnisliste (Lauf & Gesamt) · Urkunden · Quittungen
BIBs, Urkunden pdf · html · csv · Drucker
Event-Daten Externe Speicherung

Datenstruktur

Erste Schritte

Typischer Ablauf

  1. Event anlegen (Name, Ort, Datum, Veranstalter)
  2. Läufe und Wettbewerbe definieren
  3. Teilnehmer / Teams importieren (CSV, iOS Web-Anmeldung) oder manuell eingeben
  4. Am Veranstaltungstag: Zeitnahme erfassen (RFID, BIB-Scanner, manuell)
  5. Platzierungen berechnen lassen
  6. Urkunden drucken / als PDF exportieren
  7. Ergebnisse per FTP auf die Website hochladen (optional)
💡

Alle Daten werden automatisch alle 10 Minuten gesichert. Bei einem Fehler kann über den Backup-Manager ein früherer Stand wiederhergestellt werden.

Events

Die Event-Liste ist das Hauptfenster der App. Alle Veranstaltungen werden hier angelegt und verwaltet.

Event anlegen

  1. Auf das +-Symbol oben rechts klicken
  2. Name, Ort, Datum und Veranstalter eingeben
  3. Mit Speichern bestätigen

Event bearbeiten oder löschen

Jede Event-Zeile enthält drei Inline-Buttons: Stift (Bearbeiten), Doppelseite (Duplizieren) und Papierkorb (Löschen).

⚠️

Das Löschen eines Events entfernt auch alle Teams, Läufe und Ergebnisse. Nicht rückgängig machbar.

Läufe & Wettbewerbe

Was ist ein Lauf?

Ein Lauf ist ein zeitlicher Startblock — z. B. „Lauf A (Schüler)" oder „Hauptlauf". Jeder Lauf enthält Wettbewerbe (Altersklassen) und die zugehörigen Ergebnisse.

Lauf anlegen

  1. Event auswählen → Bereich Läufe
  2. Button + klicken, Name eingeben
  3. Wettbewerbe hinzufügen (siehe unten)
  4. Mit Speichern bestätigen

Wettbewerb-Felder

FeldBeschreibung
Namez. B. „U12"
(Gesamt-)Alter von – bisAlterspanne in Jahren (Summe aller Jahrgänge im Team)
Disziplinz. B. „3 km"
StartgeldBetrag in Euro (für Quittungen)

Lauf-Einstellungen

EinstellungBeschreibung
Athleten pro Team Anzahl Athleten je Team: 1 – Einzel · 2 – Duo · 3 – Trio · 4 – Quartett. Bestimmt, welche CSV-Spalten beim Import und Export verwendet werden.
Mannschaftswertung Top-3-Teams pro Verein werden zusätzlich zur Einzelwertung gerankt. Aktivierbar pro Lauf; zeigt einen eigenen Tab in der Ergebnisansicht.
Wertungsmodus Punkte (Platzierung) oder Zeit (Summe) — nur sichtbar wenn Mannschaftswertung aktiv
Geschlechter Getrennt (m/w/x) · Gesamt · Beides — nur sichtbar wenn Mannschaftswertung aktiv

Lauf-Sperrmechanismus

Im Netzwerkbetrieb zeigt der RunLockManager an, ob ein anderer Mac gerade aktiv schreibt. Konflikte werden so verhindert.

Teilnehmer & Teams

TeamRacePilot unterstützt Einzelstarter genauso wie Teamläufe. Je Eintrag sind 1–4 Athleten möglich — die Anzahl wird pro Lauf festgelegt: 1 = Einzel, 2 = Duo, 3 = Trio, 4 = Quartett. Teilnehmer können direkt eingegeben, aus CSV importiert oder über die iOS Web-Anmeldung erfasst werden.

Teilnehmer / Team manuell hinzufügen

  1. Event auswählen → Button Teilnehmerverwaltung (👥-Icon)
  2. Button + klicken
  3. Geschlecht, Athleten-Daten (Name, Verein, Jahrgang — Anzahl je nach Lauf-Einstellung: 1–4), Startnummer, Wettbewerb ausfüllen
  4. Mit Hinzufügen bestätigen

Teilnehmer / Teams importieren

VarianteBeschreibung
CSV-DateiDatei aus externem Tool (Excel, Online-Formular) importieren
Zwischenablage ⌘⇧VDaten direkt aus Excel kopieren und einfügen
iOS Web-AnmeldungTeilnehmer melden sich selbst über den Browser an (→ Web-Anmeldung)

Startnummern automatisch vergeben

Button BIB Auto-Fill: Teilnehmer / Teams ohne Startnummer erhalten fortlaufende Nummern in einem wählbaren Bereich.

Wettbewerbe neu berechnen

Button Wettbewerbe neu berechnen: Weist Teilnehmer / Teams ohne Wettbewerb automatisch eine Altersklasse zu, basierend auf dem Gesamtalter (bei Einzelstartern: eigener Jahrgang; bei Teams: Summe der Jahrgänge). Der Wettbewerb kann auch manuell zugewiesen werden — z. B. wenn ein Athlet oder Team in einer anderen Klasse startet.

Ergebnisse

Platzierungen

Platzierungen werden automatisch berechnet sobald Zeiten geändert werden — Platz gesamt und Platz im Wettbewerb. Zeitgleiche Einträge erhalten denselben Platz.

Filter

Zeitnahme

Die Ergebnisansicht ist die Zentrale für alle Zeitnahme-Methoden. Je nach Methode erfolgt der Einstieg direkt in der Ergebnisansicht oder über das Zeitmessungs-Fenster.

Methode Einstieg Beschreibung
Manuell ⏱ Stoppuhr-Icon → Zeitmessungs-Fenster Integrierte Stoppuhr; Startnummer eingeben und bestätigen → aktuelle Stoppuhr-Zeit wird übertragen
BIB-Scanner Direkt in Ergebnisansicht (Bonjour) iPhone sendet Startnummer per HTTP POST; Zeit wird von TeamRacePilot vergeben
Copy / Paste (nur Startnummern oder nur Zeiten) ⏱ Stoppuhr-Icon → Zeitmessungs-Fenster Aus BIB-Scanner per Universal Clipboard einfügen (gleiche Apple-ID)
CSV-Import Direkt in Ergebnisansicht (Import-Button) Zeiten aus externer Stoppuhr oder BIB-Scanner-Export laden (→ Externe Zeitnahme CSV)
RFID (experimentell, für Bastler) ⏱ Stoppuhr-Icon → Zeitmessungs-Fenster Nur Kathrein RRU4 ELC E6 / WRA3070 · Reader liest Tags automatisch; Kandidaten werden bestätigt oder verworfen

Urkunden & BIB-Design

Urkunden-Designer

Der Designer erlaubt das freie Gestalten von Urkunden und Startnummern. Elemente (Text, Logo, Hintergrundbild) können frei positioniert werden. Das Layout wird pro Event gespeichert.

Urkunden ausgeben

AktionBeschreibung
PDF exportierenAlle gefilterten Urkunden als PDF-Datei speichern
HTML exportierenAls HTML-Datei, optional per FTP hochladen
DruckenDirekt an den Drucker senden

Filter

💡

Nur Teilnehmer / Teams mit einer Zeit und Platzierung erscheinen in der Urkundenliste. Platzierungen werden automatisch berechnet sobald Zeiten vorhanden sind.

Listen & Drucken

ListeInhaltFormate
StartlisteAlle Teams nach Startnummer, Lauf & Gesamtpdf · html · csv · Drucker
TeilnehmerlisteAlle Teilnehmer, alphabetisch oder nach Vereinpdf · html · csv · Drucker
VereinslisteTeams gruppiert nach Vereinpdf · html · csv · Drucker
ErgebnislisteErgebnisse, Lauf & Gesamtpdf · html · csv · Drucker
UrkundenLauf & Gesamt, gefiltert nach Wettbewerb/Geschlechtpdf · html · Drucker
QuittungenStartgeld pro Verein, mit Rabattpdf · html · csv · Drucker
BIBs (Startnummern)Druckfertige Startnummern nach eigenem Designpdf · html · Drucker
Einnahmen-ÜbersichtStartgelder gesamtAnsicht · Drucker

Web-Anmeldung iOS

TeamRacePilot stellt einen integrierten HTTP-Server auf Port 8080 bereit. Teilnehmer öffnen die Anmeldeseite direkt im Browser ihres iOS-Geräts im gleichen WLAN — kein App-Download nötig.

Einrichtung

  1. In der Event-Liste auf den QR-Code-Button klicken
  2. QR-Code mit dem iOS-Gerät scannen oder URL manuell eingeben
  3. Teilnehmer füllen das Formular aus und senden ab
💡

Mac und iOS-Gerät müssen im gleichen WLAN sein. Der Server läuft, solange TeamRacePilot geöffnet ist.

BIB-Scanner iOS

Die BIB-Scanner App (App Store) erfasst Startnummern per Kamera (OCR), QR-Code oder Tastatur und überträgt sie mit Zeiten an TeamRacePilot.

💡

TeamRacePilot übernimmt die Zeitnahme. BIB-Scanner sendet nur die Reihenfolge der Startnummern — die Zielzeit wird von TeamRacePilot zugewiesen.

Verbindungsarten

MethodeBeschreibungVoraussetzung
Bonjour (empfohlen) BIB-Scanner findet TeamRacePilot automatisch im WLAN → HTTP POST direkt in den Lauf Gleiches WLAN
Clipboard Daten per Universal Clipboard kopieren/einfügen Gleiche Apple-ID, Handoff aktiv
CSV-Export CSV-Datei per AirDrop, Mail oder Dateien teilen, dann in TeamRacePilot importieren Keine Apple-ID nötig

Bonjour-Verbindung einrichten

  1. TeamRacePilot öffnen (Bonjour-Service startet automatisch)
  2. In BIB-Scanner: 📁-Button (oben links) → TeamRacePilot verbinden… antippen
    Alternativ: Einstellungen → Bereich TeamRacePilot → TeamRacePilot suchen…
  3. TeamRacePilot in der Liste antippen → Lauf auswählen
  4. Zeiten werden ab sofort direkt übertragen

RFID-Zeitnahme (experimentell)

Der RFID-Modus ist ein experimentelles DIY-Feature und wurde ausschließlich mit dem Kathrein RRU4 ELC E6 und WRA3070 entwickelt und getestet. Andere Reader werden nicht offiziell unterstützt. Die Verbindung erfolgt über TCP Port 4007.

⚠️

Der Kathrein RRU4 ELC besitzt keine eingebaute Antenne. Externe UHF-Antennen (865–868 MHz, EU-Band) sind erforderlich.

RFID einrichten

  1. Lauf auswählen → Button RFIDRFID Einstellungen
  2. IP-Adresse des Readers eingeben (Port 4007)
  3. Verbindung testenSpeichern

Tag-Mapping

Im Bereich Tag-Zuordnung: RFID-Tags (EPC-Nummern) werden den Startnummern zugewiesen. Tags können manuell eingegeben oder beim ersten Lesen automatisch erkannt werden.

Live Timing

Das Live Timing-Fenster zeigt alle eingehenden Tag-Lesungen in Echtzeit mit Zeitstempel, EPC und zugeordnetem Team.

Externe Zeitnahme CSV

Zeiten aus beliebigen externen Stoppuhren oder Timing-Apps können als CSV in die Ergebnisansicht importiert werden.

CSV-Format

SpalteInhaltBeispiel
StartnummerBIB des Teams42
ZeitFormat MM:SS,T oder HH:MM:SS,T18:34,2

Trennzeichen Komma oder Semikolon werden automatisch erkannt. Spalten werden anhand des Headers identifiziert.

Internet-Upload FTP

Ergebnisse und Listen können als HTML-Dateien auf einen externen Webserver hochgeladen werden (z. B. IONOS) — über FTP, FTPS oder SFTP.

FTP einrichten

  1. In der Event-Liste → FTP-Icon → FTP Einstellungen
  2. Protokoll (FTP / FTPS / SFTP), Host, Port, Benutzername, Passwort, Zielordner eingeben
  3. Verbindung testenSpeichern

Hochgeladene Dateien

DateiInhaltOptional
index.htmlNavigationsseite mit Links zu allen Läufen
Startliste_[Lauf].htmlStartliste pro Lauf & Gesamt
Ergebnisliste_[Lauf].htmlErgebnisse pro Lauf & Gesamt
Urkunden_[Lauf].htmlUrkunden pro Lauf & Gesamt
Vereinsliste_[Event].htmlTeams nach Verein gruppiertJa
Quittungen_[Event].htmlStartgebühren pro VereinJa
💡

Vereinsliste und Quittungen sind nicht in der index.html verlinkt und müssen separat hochgeladen werden.

2. Mac / Netzwerkpfad

Über den Datenpfad-Button kann ein gemeinsamer Netzwerkordner (SMB/AFP) als Datenspeicher festgelegt werden. Beide Macs greifen auf dieselben Event-Daten zu.

⚠️

Alle Macs müssen exakt denselben Netzwerkpfad eingebunden haben. Backups werden immer lokal gespeichert (unabhängig vom Netzwerkpfad).

Der RunLockManager zeigt den Status des anderen Macs an und verhindert gleichzeitiges Schreiben in denselben Lauf.

Import & Export

CSV-Export (Teams)

Toolbar der Event-Liste → Teams exportieren: Teilnehmerliste als CSV mit Startnummer, Teilnehmer, Verein, Jahrgang, Wettbewerb.

CSV-Export (Ergebnisse)

Toolbar der Event-Liste → Ergebnisse exportieren: Lauf, Startnummer, Zeit, Platz gesamt, Platz im Wettbewerb.

CSV-Import (Teams)

Der Import erkennt Semikolon und Komma als Trennzeichen automatisch. Die Athleten-Spalten wiederholen sich je nach Lauf-Konfiguration (1–4 Athleten).

SpalteInhalt
StartnummerBIB
Geschlechtm / w / x
WettbewerbWettbewerbsname (optional)
Teilnehmer 1Name Athlet 1
Jahrgang 1Geburtsjahr Athlet 1
Verein 1Vereinsname Athlet 1
Teilnehmer 2 … 4Name Athlet 2–4 (optional, je nach Lauf-Einstellung)
Jahrgang 2 … 4Geburtsjahr Athlet 2–4 (optional)
Verein 2 … 4Vereinsname Athlet 2–4 (optional)

Der Export (Button Teams exportieren) erzeugt exakt dieses Format mit der im Event vorkommenden maximalen Athletenanzahl.

Backup & Event-Daten

Automatisches Backup

Alle 10 Minuten wird automatisch ein lokales Backup erstellt (nur bei Änderungen). Backups liegen immer lokal — unabhängig vom Netzwerkpfad.

Backup-Manager

Toolbar → Wolken-Symbol → Backup-Manager: Liste aller Backups mit Datum. Backup auswählen → Wiederherstellen.

Event-Datei exportieren / importieren

Einzelne Events können als JSON-Datei exportiert und auf einem anderen Mac importiert werden — für Sicherung, Weitergabe oder Gerätewechsel.

Feldbeschreibungen

Team-Felder

FeldTypBeschreibung
Startnummer (BIB)TextEindeutige Kennnummer des Teams
Geschlechtm / w / xMännlich, weiblich, gemischt
Athlet 1 – 4TextVor- und Nachname (Anzahl je nach Lauf-Einstellung)
Verein 1 – 4TextVereinszugehörigkeit je Athlet (kann unterschiedlich sein)
Jahrgang 1 – 4ZahlGeburtsjahr je Athlet — Basis für Wettbewerbszuweisung
WettbewerbAuswahlZugeordnete Altersklasse

Wettbewerb-Felder

FeldBeschreibung
Namez. B. „U14 männlich"
Teamalter von / bisAltersbereich in Jahren
DisziplinStrecke oder Disziplinbezeichnung
StartgeldBetrag in Euro (für Quittungen)

Tastenkürzel

KürzelFunktion
⌘NNeues Event anlegen
⌘TTeilnehmerverwaltung öffnen
⌘RZeitmessung öffnen
⌘⇧DUrkunden Designer öffnen
⌘⌥BBackup-Verwaltung öffnen
⌘⇧BBackup erstellen
⌘⇧EReport: Ergebnisliste
⌘⇧UReport: Urkunden
⌘⇧VReport: Vereinsliste · oder (in Teilnehmerverwaltung) Teams aus Zwischenablage importieren
⌘ZRückgängig
⌘⇧ZWiederholen
⌘MFenster minimieren