TrainMeet GitHub
Open source och bidrag

Koden är på GitHub. Bygg vidare med oss.

TrainMeet byggs i öppna repon under beahead-ab, i snabb takt och med hobbyn som uppdragsgivare. Klona, läs, rapportera, översätt eller skicka en pull request. Ingen inloggning behövs för att läsa eller ladda ner.

Öppna github.com/beahead-ab Sätt att bidra
Repon och licensläge
trainmeet-server
Python · inga obligatoriska beroenden · 3.10.2
Den lokala servern: klocka, trafiklogik, MQTT, Drift, skärmar, virtuell TMBox, provbänk, US-pilot.
Öppen kod[LICENS]
trainmeet-tkl
TypeScript · React · Vite · 0.6.5
Tågklarerarens terminal för Raspberry Pi med pekskärm, kioskinstallation och offline-cache.
Öppen kodMIT
trainmeet-tmbox
Arduino · C++ · PlatformIO · 0.7.6
Firmware för ESP32-S3, klassisk ESP32 och ESP8266, kopplingsscheman, hårdvaruunderlag för v2 och webbinstallerare.
Öppen kod[LICENS]
trainmeet-cloud
React · Python · SQLite · 2.13.2
Import, AI-tolkning, granskning, validering och publicering. Hostad på cloud.trainmeet.app, egen drift i Klubb-planen.
Hostad tjänstPrivat repo
trainmeet-iphone
Swift · SwiftUI · XcodeGen · 2.3.1
TMBox för iPhone. Distribueras via TestFlight.
AppPrivat repo
traincatalog
Django · React · PostgreSQL · 0.5.0
Fordonskatalog med vagnkort, NFC och AI. Hostad tjänst med Gratis och Plus.
Hostad tjänstPrivat repo

Server- och TMBox-repona ligger öppet och installeras direkt från GitHub, men saknar i skrivande stund en licensfil. [LICENS] ersätts med vald licens innan sajten publiceras.

Sätt att bidra

Du behöver inte kunna koda för att göra TrainMeet bättre.

Kör en träff och berätta

Det bästa bidraget är en fältrapport: vad hände, på vilken version, på vilken maskin, med vilka boxar. Skärmbilder av boxen och Drift hjälper mer än långa beskrivningar.

Rapportera fel

GitHub Issues i respektive repo. Ange version, plattform och steg att upprepa. Serverns Inställningar visar version och "vad är nytt".

Översätt

Fem språk i dag: svenska, danska, norska, engelska, tyska. Serverns texter ligger i en översättningsfil per rad. Boxens texter måste rymmas på sexton tecken, en rolig begränsning.

Bygg en hårdvaruprofil

Har klubbens boxar en annan pinkonfiguration? Lägg till en profil i TMBox-firmwaren, som esp32-benny och classic-safe. Ett kopplingsschema i README räcker för att komma igång.

Dela ert tidtabellsformat

Skicka en avidentifierad stations-PDF eller ett Excel-ark från er klubb. Varje nytt format gör Clouds importadaptrar säkrare för alla.

Rita en urtavla

Servern har redan elva analoga urtavlor. Saknar du din banas klocka? Skicka en skiss eller ett SVG.

Skriv dokumentation

Installationsguider på fler språk, en lathund för tågklarerare att lägga vid stationen, eller en video från er träff.

Pull requests

Små, avgränsade ändringar med tester. Versionen sätts automatiskt vid merge till main och hamnar i RELEASES.json, så servern kan uppdatera sig själv.

Så jobbar projekten

Principer som inte förhandlas

Servern är ensam auktoritetKlienter visar bilden och skickar tangenttryck. Ingen trafiklogik i boxar, terminaler eller appar.
AI får föreslå, aldrig publiceraNormalisering, mänsklig granskning, validering och ett uttryckligt beslut mellan AI och träff.
Systemet följer speletFlytta hit, hoppa fram, upptaget spår: reglerna hjälper, de stoppar inte.
Dokumentationen genereras ur motornBoxens flödessidor ritas av den riktiga 16×2-motorn. Ändras motorn faller testerna tills sidan är omgenererad.
Inte en järnvägssäkerhetsproduktEtt spelsystem för modelljärnväg, sagt rakt ut i varje README.
Kom igång med koden

Tre kommandon till en körande TKL

git clone https://github.com/beahead-ab/trainmeet-tkl.git cd trainmeet-tkl npm install && npm run dev # http://127.0.0.1:8790 · anropen går vidare till servern på 8787
git clone https://github.com/beahead-ab/trainmeet-server.git cd trainmeet-server # se README för lokal utveckling, Docker och tester
git clone https://github.com/beahead-ab/trainmeet-tmbox.git # firmware/esp8266 · firmware/esp32 · installer/ · docs/TMBOX-V2-HARDWARE.md

Utvecklingstakten är hög: över hundra serverreleaser sedan augusti 2026. Läs CHANGELOG innan du bygger på ett gränssnitt.

Välkommen in
Första issuen är den viktigaste.

Berätta vad som inte fungerade på er träff, eller vad ni saknar. Vi svarar i repot.

Öppna en issue Installera servern