En moderne, fullstendig webapplikasjon for å kontrollere tredemøllen din via Bluetooth (FTMS) og spore treningsøkter. Optimalisert for desktop, tablet og mobil.

• Bluetooth FTMS-kontroll: Koble til tredemølle via FTMS (Fitness Machine Service)
• Manuell kontroll: Juster hastighet (0.1-14.0 km/t) og stigning (0-12%) i sanntid
• Tre visningsmoduser: Fokus, Oversikt, og Minimal for ulike preferanser
• Live statistikk: Se hastighet, distanse, tid, puls, kalorier og effekt
• Automatisk BLE-reconnect: Kobler til igjen automatisk ved frakobling (eksponentiell backoff, maks 5 forsøk)
• Drift-deteksjon: Sender BLE-kommandoer på nytt hvis faktisk != mål

• 38 profesjonelle treningsøkter fordelt på 3 nivåer:
  • Beginner (23): Couch to 5K (9 uker), Steady State, Standard intervaller, Motbakke intro
  • Intermediate (9): VO2max 5x3, Threshold 2x10, Tempo 20 min, Hill Repeats, Pyramide
  • Advanced (8): VO2max 6x4, Speed 400m x12, Threshold 3x12, Hill Sprints, Long Runs
• Egendefinerte økter: Lag og rediger dine egne treningsøkter med flere segmenter
• Automatisk kjøring: Appen styrer hastighet og stigning automatisk gjennom segmentene
• Lydvarsler: Pip ved segmentbytte, stigende tone ved fullført økt (Web Audio API)
• Smart filtrering: Søk på difficulty, tags (c25k, vo2max, threshold, etc.) og varighet
• Auto-stopp: Når tredemøllen stoppes fysisk, avsluttes økten automatisk uten bekreftelse

• Tre visninger: Oversikt, Økter, og Trender
• Total statistikk: Samlet distanse, tid, kalorier og antall økter
• Personlige rekorder: Beste pace, lengste distanse, lengste økt, flest kalorier
• Gjennomsnitt per økt: Automatisk beregning av gjennomsnittsverdier
• Treningsdata-graf: Interaktiv graf med fart, puls og stigning over tid (Chart.js)
• Datofilter: Filtrer økter etter tidsperiode (7 dager, denne mnd, 3 mnd, egendefinert)
• Per-segment feedback: Se gjennomsnittsfart, puls og tid per segment etter fullført økt
• Eksport: Last ned øktdata som JSON, CSV eller TCX
• Slett økter: Fjern testøkter fra historikken

• OAuth 2.0: Koble til Strava-kontoen din direkte fra appen
• Manuell opplasting: Last opp enkeltøkter til Strava med ett klikk
• Automatisk opplasting: Aktiver auto-sync for å laste opp automatisk etter hver økt
• TCX-format: Genererer komplett TCX med hastighet, puls, distanse og tid
• Duplicate-beskyttelse: Bruker external_id for å unngå duplikater
• Token refresh: Automatisk fornyelse av utløpte tokens

Merk: Strava API støtter ikke å sette aktivitetsprivacy. Sett "Default Activity Privacy" til "Only You" i Strava-innstillingene for private økter.

• FTMS puls-støtte: Mottar pulsdata fra FTMS-protokollen
• Separat pulsbelte: Koble til Bluetooth-pulsbelte (f.eks. Polar H10) for bedre nøyaktighet
• Smart visning: Skjuler pulsvisning automatisk når ingen gyldig puls er tilgjengelig
• Gjennomsnittspuls: Beregner gjennomsnitt kun fra gyldige målinger

• Fullt responsiv: Optimalisert for mobil, tablet (iPad) og desktop
• View-only dashboard (/view.html): Sanntidsvisning for iPad/iPhone som ikke støtter Web Bluetooth
  • Mottar data via WebSocket fra kontrollpanelet
  • Viser hastighet, stigning, puls, distanse, tid, kalorier
  • HR-sone-farger basert på maks puls
  • Tilkoblingsstatus med feilmelding
• PWA-støtte: Installerbar som app med offline-støtte (Service Worker)
• Apple Web App: Fungerer som standalone app på iOS/iPadOS
• Touch-optimalisert: Store knapper (min 44x44px), bedre spacing

• 100% lokal: Kjører kun lokalt på ditt hjemmenettverk
• Ingen cloud: Ingen data sendes til eksterne servere (unntatt valgfri Strava-sync)
• Lokal database: Alt lagres i SQLite på din maskin
• Web Bluetooth sikkerhet: Krever brukerinteraksjon for tilkobling
• HTTPS: Selvgenerert SSL-sertifikat for sikker kommunikasjon

• Node.js versjon 14 eller nyere
• Tredemølle med Bluetooth FTMS-støtte (f.eks. Ronning x27 Pro, kompatibel med Zwift/Kinomap)

*iOS støtter ikke Web Bluetooth API. Bruk view-only dashboard (/view.html) for å se sanntidsdata fra en aktiv økt. Kontroll og historikk er tilgjengelig via nettleser.

1. Klon repositoryet:

git clone https://github.com/mlervaag/treadmill-controller.git
cd treadmill-controller

2. Installer avhengigheter:

npm install

3. Start serveren:

npm start

4. Åpne i nettleser:

• Gå til http://localhost:3001 i Chrome/Edge/Opera
• Koble til tredemøllen via Bluetooth
• Begynn å trene!

# Fra Windows:
scp -r . pi@192.168.1.12:~/treadmill-controller/

ssh pi@192.168.1.12
cd ~/treadmill-controller
mkdir -p certs
openssl req -x509 -newkey rsa:4096 -nodes -out certs/server.crt -keyout certs/server.key -days 365

cp .env.example .env
# Rediger med dine Strava API-nøkler

docker compose build
docker compose up -d

STRAVA_CLIENT_ID=din_client_id
STRAVA_CLIENT_SECRET=din_client_secret
APP_URL=https://192.168.1.12:3001

1. Start serveren: npm start
2. Åpne appen: http://localhost:3001 i Chrome/Edge/Opera
3. Koble til: Klikk "Koble til Tredemølle" og velg din tredemølle
4. Tren!: Du er klar til å kjøre

• PC med Bluetooth: https://192.168.1.12:3001 — Kontroller tredemøllen
• iPad/iPhone: https://192.168.1.12:3001/view.html — Se sanntidsdata
• Android: https://192.168.1.12:3001 — Full kontroll

For enheter uten Web Bluetooth-støtte:

1. Åpne https://192.168.1.12:3001 i Safari og godta sertifikatet
2. Gå til https://192.168.1.12:3001/view.html
3. Tilkoblingsstatus:
   • 🟢 Tilkoblet — WebSocket fungerer, venter på aktiv økt
   • 🟡 Kobler til... — Prøver å koble til serveren
   • 🔴 Frakoblet — Sjekk at sertifikatet er godkjent i nettleseren

1. Velg mal: Gå til "Treningsøkter" → velg fra 38 profesjonelle maler
2. Lag din egen: Klikk "+ Ny Økt" og definer segmenter
3. Rediger: Klikk "Rediger" på egendefinerte økter for å endre
4. Start: Klikk "Last økt" på en mal, deretter "Start" i Kontroll-fanen
5. Lydvarsler: Appen piper ved segmentbytte og spiller en melodi ved fullføring

• Graf: Klikk "📊 Graf" for å se fart/puls over tid
• Eksport: JSON, CSV eller TCX per økt
• Strava: Klikk "🔶 Strava" for å laste opp enkeltøkter
• Segmenter: Se detaljert feedback per segment

treadmill-controller/
├── server.js                  # Express server (~1250 linjer): API, WebSocket, Strava, eksport
├── package.json               # npm konfigurasjon
├── templates.json             # 38 standard treningsøkter
├── migrate.js                 # Database migrations (ALTER TABLE)
├── deploy-to-pi.sh            # Bash deploy-skript for Raspberry Pi
├── Dockerfile                 # Docker container build
├── docker-compose.yml         # Docker Compose med volumes og env
├── .env.example               # Miljøvariabel-mal
├── LICENSE                    # ISC lisens
├── CLAUDE.md                  # AI-instrukser for Claude Code
├── .cursorrules               # AI-instrukser for Cursor
├── .windsurfrules             # AI-instrukser for Windsurf
├── .github/
│   └── copilot-instructions.md # AI-instrukser for GitHub Copilot
├── STRAVA_INTEGRATION.md      # Teknisk Strava-dokumentasjon
├── ROADMAP.md                 # Planlagte funksjoner og veikart
├── data/                      # Database (git-ignored)
│   └── treadmill.db           # SQLite database
├── certs/                     # SSL-sertifikater (git-ignored)
│   ├── server.key
│   └── server.crt
├── docs/                      # Brukerveiledninger
│   ├── HOME_USAGE_GUIDE.md    # Komplett bruksanvisning
│   ├── WEB_BLUETOOTH_SETUP.md # Web Bluetooth oppsettguide
│   └── RASPBERRY_PI_SETUP.md  # Raspberry Pi deployment guide
├── scripts/                   # Hjelpeskript (PowerShell)
│   ├── deploy-to-pi.ps1       # Deploy til Raspberry Pi
│   ├── enable-https.ps1       # Aktiver HTTPS-sertifikater
│   ├── start-server.ps1       # Start serveren
│   ├── stop-server.ps1        # Stopp serveren
│   ├── backup-database.ps1    # Sikkerhetskopier database
│   └── restore-database.ps1   # Gjenopprett database fra backup
└── public/                    # Frontend
    ├── index.html             # Hovedside med full UI
    ├── style.css              # Responsiv dark-theme styling
    ├── app.js                 # Frontend logikk (~3000 linjer)
    ├── ftms.js                # FTMS Bluetooth-protokoll
    ├── hrm.js                 # Heart Rate Monitor Bluetooth
    ├── view.html              # View-only dashboard for iPad/iPhone
    ├── manifest.json          # PWA manifest
    └── sw.js                  # Service Worker for offline

id, name, description, difficulty, is_template, tags, created_at

id, workout_id, segment_order, duration_seconds, speed_kmh, incline_percent, segment_name

id, workout_id, started_at, completed_at, total_distance_km, total_time_seconds,
avg_heart_rate, calories_burned, heart_rate_source, strava_activity_id, strava_upload_status

id, session_id, timestamp, speed_kmh, incline_percent, distance_km, heart_rate, segment_index

id, athlete_id (UNIQUE), access_token, refresh_token, expires_at, scope, athlete_name, connected_at

Applikasjonen bruker Bluetooth Low Energy FTMS-standarden, samme som brukes av Zwift, Kinomap, Peloton, etc.

FTMS Service:         00001826-0000-1000-8000-00805f9b34fb
Treadmill Data:       00002acd-0000-1000-8000-00805f9b34fb
Control Point:        00002ad9-0000-1000-8000-00805f9b34fb
Machine Status:       00002ada-0000-1000-8000-00805f9b34fb
Heart Rate Service:   0000180d-0000-1000-8000-00805f9b34fb

• ✅ Sørg for at tredemøllen er slått på og Bluetooth aktivert
• ✅ Sjekk at tredemøllen ikke er koblet til annen enhet/app
• ✅ Prøv "Scan alle enheter"-knappen

• ❌ Safari/Firefox støtter ikke Web Bluetooth
• ❌ iOS støtter ikke Web Bluetooth — bruk /view.html i stedet
• ✅ Lokal bruk: http://localhost:3001
• ✅ Raspberry Pi: https://PI-IP:3001 med HTTPS

• ✅ Åpne https://PI-IP:3001 i Safari først og godta sertifikatet
• ✅ Deretter åpne https://PI-IP:3001/view.html
• ✅ Sjekk at det er en aktiv økt på kontroll-PCen

• ✅ Sjekk at Strava er koblet til (grønt i Historikk-fanen)
• ✅ Økten må ha datapunkter (tomme økter kan ikke lastes opp)
• ✅ Sjekk at .env har riktig STRAVA_CLIENT_ID og STRAVA_CLIENT_SECRET
• ✅ Sjekk at "Authorization Callback Domain" i Strava er satt til Pi-ens IP

• Backend: Node.js, Express 5, WebSocket (ws), better-sqlite3
• Frontend: Vanilla JavaScript (ES6+), HTML5, CSS3, Chart.js 4
• Bluetooth: Web Bluetooth API, FTMS Protocol, Heart Rate Service
• Integrasjoner: Strava API v3 (OAuth 2.0, TCX upload)
• Infrastruktur: Docker, Raspberry Pi, HTTPS (self-signed)
• PWA: Service Worker, Web App Manifest
• Lyd: Web Audio API (oscillator-baserte varsler)
• Design: Responsive, Mobile-first, Dark theme

• HOME_USAGE_GUIDE.md — Komplett bruksanvisning for daglig bruk
• WEB_BLUETOOTH_SETUP.md — Guide for å sette opp Web Bluetooth
• RASPBERRY_PI_SETUP.md — Raspberry Pi deployment og drift
• STRAVA_INTEGRATION.md — Teknisk dokumentasjon for Strava-integrasjonen
• ROADMAP.md — Planlagte funksjoner og fremtidig utvikling
• CLAUDE.md — AI-instrukser for Claude Code
• .cursorrules — AI-instrukser for Cursor
• .windsurfrules — AI-instrukser for Windsurf
• copilot-instructions.md — AI-instrukser for GitHub Copilot

PowerShell-skript i scripts/-mappen for vanlige oppgaver:

Se ROADMAP.md for komplett veikart. Oppsummering:

• Strava-integrasjon (OAuth, TCX-opplasting, auto-sync)
• Treningsdata-graf (Chart.js med fart/puls/stigning)
• Lydvarsler (segmentbytte, fullføring)
• Eksport (JSON, CSV, TCX)
• Datofilter for historikk
• Workout-redigering
• Auto BLE-reconnect
• Per-segment feedback
• PWA med offline-støtte
• View-only dashboard for iPad/iPhone

• Heart Rate Zone Training — Pulsbasert adaptiv trening med brukerprofil (høy prioritet)
• Workout Builder — Visuell drag-and-drop segment-creator
• Avansert Analyse — Treningsbelastning (TSS/TRIMP), fitness-trender
• Flerbruker-støtte — Flere brukerprofiler med individuell statistikk
• Stemme-feedback — Talevarsler under trening

ISC License — se LICENSE for detaljer.

• Web Bluetooth API for trådløs tredemøllekontroll
• FTMS-standarden for Bluetooth fitness-maskin-kommunikasjon
• Chart.js for interaktive grafer
• Strava API v3 for treningssynkronisering

Denne applikasjonen kontrollerer fysisk treningsutstyr. Bruk på eget ansvar. Sørg alltid for at du har kontroll over tredemøllen og at nødstoppfunksjonen er tilgjengelig. Forfatteren er ikke ansvarlig for skader eller uhell som følge av bruk av denne programvaren.

Laget med ❤️ for løpere som elsker tech