← zurück zum Tool ← back to tool

Changelog

SSI Logbook QR Importer

Projektkontext
Die MySSI-App von SSI unterstützt den direkten Import von Tauchgängen nur von Mares-Tauchcomputern via Bluetooth. Taucher mit anderen Geräten (Shearwater, Garmin, Suunto, Apeks etc.) hatten keine Möglichkeit, ihre Tauchgänge ins SSI-Logbuch zu übertragen.

Durch Reverse Engineering des SSI QR-Code-Formats – das eigentlich für die Buddy-zu-Buddy-Übertragung zwischen SSI-Nutzern gedacht ist – entstand dieser Importer als freies Community-Tool, das diese Lücke schliesst.

Dies ist Sachas erstes Vibe-Coding-Projekt, entwickelt zusammen mit Claude (Anthropic).

Hosting: sachathomet.ch – Community-Projekt, nicht kommerziell.

Unterstützte Exportformate:
FormatGeräte
UDDF / XMLShearwater Cloud, Subsurface, Garmin, Suunto, Apeks, …
SQLite .dbShearwater Desktop (neues + altes Schema)
Garmin .fit / .zipGarmin Descent, MK-Serie, … · Suunto EON Core, D5, D6i, …
Project context
The SSI MySSI app supports direct dive import only from Mares dive computers via Bluetooth. Divers using other devices (Shearwater, Garmin, Suunto, Apeks etc.) had no way to transfer their dives to the SSI logbook.

By reverse-engineering the SSI QR code format – originally designed for buddy-to-buddy transfer between SSI users – this importer was created as a free community tool to fill that gap.

This is Sacha's first vibe-coding project, developed together with Claude (Anthropic).

Hosting: sachathomet.ch – community project, non-commercial.

Supported export formats:
FormatDevices
UDDF / XMLShearwater Cloud, Subsurface, Garmin, Suunto, Apeks, …
SQLite .dbShearwater Desktop (new + legacy schema)
Garmin .fit / .zipGarmin Descent, MK series, … · Suunto EON Core, D5, D6i, …
v4.1 2026-04-13
  • Diver Tools Navbar: Alle öffentlichen Tools (SSI QR Importer, SSI Site Scanner, Gewichtsrechner) haben nun eine gemeinsame sticky Top-Navigationleiste. Das aktive Tool wird mit einem Unterstrich hervorgehoben. Unterstützt Light- und Dark-Mode via var(--accent).
  • Site Scanner → QR Importer Integration: Im SSI Site Scanner gespeicherte Tauchplätze (localStorage Key ssi_sites) werden beim Start des QR Importers automatisch geladen und im Region-Dropdown als eigene Gruppe «📍 Meine Sites» angezeigt. Bereits im hardcodierten DIVE_SITES-Array vorhandene IDs werden nicht dupliziert.
  • Neues Tool – Scuba Gewichtsrechner (scuba-gewichtsrechner.html): Berechnet das benötigte Bleigewicht basierend auf Körpergewicht, Körperfettanteil, Neoprenanzug-Typ und Flasche (Stahl/Alu, verschiedene Grössen). Salzwasser / Süsswasser umschaltbar. Metrisch / Imperial umschaltbar. Zweisprachig DE/EN.
  • Neues Tool – SSI Buddy QR Generator (ssi-buddy-qr-generator.html): Erstellt Buddy-QR-Codes im SSI-Format (buddy;masterID;firstName:…;lastName:…;email:…;leaderNr:…) zum Teilen der eigenen SSI-ID. Internes Tool, nicht öffentlich verlinkt.
  • Diver Tools Navbar: All public tools (SSI QR Importer, SSI Site Scanner, Weight Calculator) now share a sticky top navigation bar. The active tool is highlighted with an underline. Supports light and dark mode via var(--accent).
  • Site Scanner → QR Importer integration: Dive sites saved in the SSI Site Scanner (localStorage key ssi_sites) are automatically loaded when the QR Importer starts and appear in the region dropdown as a dedicated group "📍 My Sites". IDs already present in the hardcoded DIVE_SITES array are not duplicated.
  • New tool – Scuba Weight Calculator (scuba-gewichtsrechner.html): Calculates required lead weight based on body weight, body fat, wetsuit type, and tank (steel/aluminium, various sizes). Salt/fresh water toggle. Metric/imperial toggle. Bilingual DE/EN.
  • New tool – SSI Buddy QR Generator (ssi-buddy-qr-generator.html): Generates buddy QR codes in SSI format (buddy;masterID;firstName:…;lastName:…;email:…;leaderNr:…) for sharing your SSI ID. Internal tool, not publicly linked.
v4.0 2026-04-09
  • Das Projekt wächst über den einzelnen QR Importer hinaus. Mit dem Gewichtsrechner und dem Buddy QR Generator entsteht eine Suite von Tauch-Tools unter dem Dach «Diver Tools».
  • Alle Tools teilen dasselbe Design-System (CSS-Variablen, Dark Mode, Schriften) und sind unter sachathomet.ch/ssi-logbook-qr-importer/ erreichbar.
  • The project has grown beyond a single QR importer. With the weight calculator and buddy QR generator, a suite of diving tools is taking shape under the "Diver Tools" umbrella.
  • All tools share the same design system (CSS variables, dark mode, fonts) and are hosted at sachathomet.ch/ssi-logbook-qr-importer/.
v3.3 2026-04-02
  • Suunto FIT: Tiefe wurde als 0 m angezeigt – Suunto-Geräte schreiben die Maximaltiefe in session-Feld 141 (max_depth_suunto) und Durchschnittstiefe in Feld 140 (avg_depth_suunto), beide in Millimetern. Diese Felder fehlten bisher komplett im Parser: weder in MESG_DEFS (→ wurden ignoriert) noch in FIELD_SCALES (→ Scale mm→m fehlte) noch im Session-Fallback (→ depth_m: 0 hardcodiert).
  • Fix: Felder 140 und 141 in MESG_DEFS[18] ergänzt, Scale-Faktor 1000 (mm→m) in FIELD_SCALES[18] hinzugefügt, Session-Fallback liest jetzt sess.max_depth_suunto statt fix 0.
  • Beispiel: Suunto EON Core, Feld 141 = 18570 raw → 18570 / 1000 = 18.6 m ✓
  • Getestet mit: Suunto EON Core (.fit-Export via Suunto App)
  • Suunto FIT: depth was shown as 0 m – Suunto devices write maximum depth into session field 141 (max_depth_suunto) and average depth into field 140 (avg_depth_suunto), both in millimetres. These fields were entirely missing from the parser: absent from MESG_DEFS (→ silently ignored), absent from FIELD_SCALES (→ mm→m conversion missing), and the session fallback had depth_m: 0 hard-coded.
  • Fix: Added fields 140 and 141 to MESG_DEFS[18], added scale factor 1000 (mm→m) to FIELD_SCALES[18], session fallback now reads sess.max_depth_suunto instead of a fixed 0.
  • Example: Suunto EON Core, field 141 = 18570 raw → 18570 / 1000 = 18.6 m ✓
  • Tested with: Suunto EON Core (.fit export via Suunto App)
v3.2 2026-04-02
  • Falsche Tauchzeit (z.B. 47 062 min statt 47 min) – dive_summary.bottom_time (Feld 11) wird von Garmin in Millisekunden gespeichert. Der Scale-Faktor 1000 fehlte im Parser. Fix: FIELD_SCALES[268][11] = 1000 ergänzt.
  • Falsche Startzeit – Sekundäreffekt desselben Bugs: Die Startzeit wurde als Endzeit − 2 824 000 Sekunden berechnet statt Endzeit − 2 824 Sekunden, was ein Datum Jahrzehnte in der Vergangenheit ergab. Mit korrektem Scale stimmt die Startzeit jetzt.
  • Doppelter Tauchgang – bestimmte Garmin-Firmware-Versionen schreiben zwei identische dive_summary-Messages pro Aktivität. Fix: Deduplizierung nach datetime|divetime am Ende der dive_summary-Verarbeitung.
  • Limitations: Sternebewertung (★★★★★) als nicht übertragbar dokumentiert – das SSI QR-Format unterstützt kein Rating-Feld.
  • Credits: Beta-Tester Jens, Achim und Yves im Disclaimer namentlich erwähnt.
  • Wrong dive time (e.g. 47,062 min instead of 47 min) – dive_summary.bottom_time (field 11) is stored by Garmin in milliseconds. The scale factor 1000 was missing from the parser. Fix: added FIELD_SCALES[268][11] = 1000.
  • Wrong start time – secondary effect of the same bug: the start time was calculated as end time − 2,824,000 seconds instead of end time − 2,824 seconds, resulting in a date decades in the past. With the correct scale the start time is now accurate.
  • Duplicate dive – certain Garmin firmware versions write two identical dive_summary messages per activity. Fix: deduplication by datetime|divetime at the end of the dive_summary processing.
  • Limitations: Star rating (★★★★★) documented as not transferable – the SSI QR format does not support a rating field.
  • Credits: Beta testers Jens, Achim and Yves mentioned by name in the disclaimer.
v3.1 2026-04-02
  • Suunto FIT: Tiefe wurde nicht importiert – Suunto-Geräte (EON Core, D5, D6i etc.) schreiben im FIT-Format keine dive_summary-Message (Garmin-spezifisch). Stattdessen landen Tiefendaten in herstellerspezifischen Feldern der session-Message: Feld 141 = Maximaltiefe (uint32, mm), Feld 140 = Durchschnittstiefe (uint32, mm). Der Parser kannte diese Felder bisher nicht und lieferte depth_m: 0.
  • Fix: MESG_DEFS und FIELD_SCALES für session (mesgNum 18) um Felder 140 (avg_depth_suunto) und 141 (max_depth_suunto) mit Skala 1000 (mm → m) erweitert. Der Session-Fallback nutzt jetzt diese Werte für Tiefe und XR-Autoerkennung.
  • Garmin nicht betroffen: Garmin-Dateien verwenden dive_summary-Messages und durchlaufen diesen Pfad gar nicht.
  • Getestet mit: Suunto EON Core (.fit-Export via Suunto App)
  • Suunto FIT: depth was not imported – Suunto devices (EON Core, D5, D6i etc.) do not write a dive_summary message in the FIT format (that is Garmin-specific). Instead, depth data is stored in manufacturer-specific fields of the session message: field 141 = max depth (uint32, mm), field 140 = avg depth (uint32, mm). The parser did not know these fields and returned depth_m: 0.
  • Fix: MESG_DEFS and FIELD_SCALES for session (mesgNum 18) extended with fields 140 (avg_depth_suunto) and 141 (max_depth_suunto) at scale 1000 (mm → m). The session fallback path now uses these values for depth and XR auto-detection.
  • Garmin unaffected: Garmin files use dive_summary messages and never reach this code path.
  • Tested with: Suunto EON Core (.fit export via Suunto app)
v3 2026-04-01
  • dive_type-Werte vollständig korrigiert – die bisherigen Werte stimmten nicht. Korrekte, verifizierte Tabelle (via echte MySSI-QR-Codes + Community-Bestätigung):
    WertBedeutung
    0OC – Open Circuit / Scuba
    2XR – Extended Range
    4SCR – Semi Closed Rebreather
    6Freedive
    8CCR – Closed Circuit Rebreather
  • UDDF-Parser: opencircuit → 0, closedcircuit → 8, semiclosedcircuit → 4, freedive → 6
  • Shearwater CCR-Erkennung: ShearwaterDiveModeType:1 → 8 (CCR)
  • SQLite-Parser: dive_type wurde gar nicht gesetzt – jetzt Standard 0 (OC)
  • FIT-Parser: CCR-Erkennung via helium_content > 0 → 8 (war fälschlich 3)
  • XR-Autoerkennung in allen drei Parsern (UDDF, FIT, SQLite): OC-Tauchgänge werden automatisch als XR (2) klassifiziert, wenn Tiefe > 40 m, Deko-Stop vorhanden (UDDF) oder mehr als 1 Gas (UDDF, FIT)
  • Freediving-Support: dive_type:6 wird generiert und erkannt
  • Manueller Typ-Override pro Tauchgang: Dropdown OC / XR / Freedive / SCR / CCR
  • Anzeige-Labels in der Liste: · XR, · SCR, · Freedive, · CCR
  • dive_type values fully corrected – previous values were wrong. Correct, verified table (via real MySSI QR codes + community confirmation):
    ValueMeaning
    0OC – Open Circuit / Scuba
    2XR – Extended Range
    4SCR – Semi Closed Rebreather
    6Freedive
    8CCR – Closed Circuit Rebreather
  • UDDF parser: opencircuit → 0, closedcircuit → 8, semiclosedcircuit → 4, freedive → 6
  • Shearwater CCR detection: ShearwaterDiveModeType:1 → 8 (CCR)
  • SQLite parser: dive_type was never set – now defaults to 0 (OC)
  • FIT parser: CCR detection via helium_content > 0 → 8 (was incorrectly 3)
  • XR auto-detection in all three parsers (UDDF, FIT, SQLite): OC dives are automatically classified as XR (2) when depth > 40 m, deco stop present (UDDF), or more than 1 gas (UDDF, FIT)
  • Freediving support: dive_type:6 is generated and detected
  • Manual type override per dive: dropdown OC / XR / Freedive / SCR / CCR
  • Display labels in the list: · XR, · SCR, · Freedive, · CCR
v2 2026-03-31
  • Garmin FIT-Import: Vollständiger binärer FIT-Parser (keine externe Bibliothek) – unterstützt .fit-Dateien direkt sowie .zip-Archive
  • Liest dive_summary, session, record-Messages
  • Korrekte Zeitberechnung: Garmin speichert Endzeit → Startzeit = timestamp - bottom_time
  • Garmin-Epoch (ab 31.12.1989) → UTC-Konvertierung
  • Tiefen-Skalierung (mm → m), Temperaturen aus Record-Waypoints
  • CCR-Erkennung via dive_gas.helium_content > 0
  • Regionsfilter: Zweistufige Auswahl – erst Region, dann Tauchplatz
  • 74 Tauchplätze mit SSI-IDs: Schweiz, Ägypten (Sharm el Sheikh inkl. Thistlegorm / Shark & Yolanda / Jackson Reef, El Quseir), Bonaire, Malta, Philippinen (Dauin, Moalboal), Island (Silfra), Kroatien, Mexiko, Fuerteventura
  • Temperaturen Min/Max (watertemp_c / watertemp_max_c) aus Waypoints extrahiert
  • Kollabierbare Parameter-Panels pro Tauchgang (Wetter, Einstieg, Gewässer etc.)
  • Zweisprachig DE/EN – Sprache automatisch aus Browser erkannt
  • Fortschrittsbalken beim ZIP-Export
  • iOS Safari Fix: .uddf und .db waren im Datei-Picker nicht wählbar → zweiter <input> mit accept="*/*" als Fallback
  • Offline-fähig: Alle Libraries (QRCode, JSZip, sql.js) vollständig inline eingebettet
  • Garmin FIT import: Full binary FIT parser (no external library) – supports .fit files directly and .zip archives
  • Reads dive_summary, session, and record messages
  • Correct time calculation: Garmin stores end time → start time = timestamp - bottom_time
  • Garmin epoch (from 1989-12-31) → UTC conversion
  • Depth scaling (mm → m), temperatures from record waypoints
  • CCR detection via dive_gas.helium_content > 0
  • Region filter: Two-step selection – choose region, then dive site
  • 74 dive sites with SSI IDs: Switzerland, Egypt (Sharm el Sheikh incl. Thistlegorm / Shark & Yolanda / Jackson Reef, El Quseir), Bonaire, Malta, Philippines (Dauin, Moalboal), Iceland (Silfra), Croatia, Mexico, Fuerteventura
  • Min/max temperatures (watertemp_c / watertemp_max_c) extracted from waypoints
  • Collapsible parameter panels per dive (weather, entry, water type etc.)
  • Bilingual DE/EN – language auto-detected from browser
  • Progress bar during ZIP export
  • iOS Safari fix: .uddf and .db files were not selectable in the file picker → second <input> with accept="*/*" as fallback
  • Offline capable: All libraries (QRCode, JSZip, sql.js) fully inlined
v1.3 2026-03
  • SQLite .db-Import via sql.js (WebAssembly, inline eingebettet)
  • Unterstützt neues Schema (dive_details + log_data JSON) und altes Schema (dive_details + dive_logs)
  • Temperatur aus JSON-Blob (calculated_values_from_samples.MinTemp)
  • Workflow vereinfacht: .db-Datei direkt aus Shearwater Cloud Desktop ziehen, kein UDDF-Export mehr nötig
  • Pfadhinweise für Mac und Windows direkt im Tool
  • SQLite .db import via sql.js (WebAssembly, fully inlined)
  • Supports new schema (dive_details + log_data JSON) and legacy schema (dive_details + dive_logs)
  • Temperature from JSON blob (calculated_values_from_samples.MinTemp)
  • Simplified workflow: drag the .db file directly from Shearwater Cloud Desktop, no UDDF export needed
  • File path hints for Mac and Windows shown directly in the tool
v1.2 2026-03
  • Tauchplatz-Dropdown pro Tauchgang (hardcoded DIVE_SITES-Array in JS)
  • Konfigurationsbereich umbenannt zu «SSI Buddy & DivePro Konfiguration»
  • user_master_id / user_firstname / user_lastname optional (für Self-Import)
  • user_leader_id klar als «eigene SSI Pro ID» beschriftet
  • Dive site dropdown per dive (hardcoded DIVE_SITES array in JS)
  • Configuration section renamed to "SSI Buddy & DivePro Configuration"
  • user_master_id / user_firstname / user_lastname optional (for self-import)
  • user_leader_id clearly labelled as "your own SSI Pro ID"
v1.1 2026-03
  • QRCode-Library gewechselt: qrcodejs (cdnjs) unterstützt QRCode.toCanvas() nicht → gewechselt auf qrcode npm-Paket, inline eingebettet
  • JSZip inline eingebettet – keine externen Abhängigkeiten mehr
  • Tool funktioniert vollständig offline und via file://
  • QR code library replaced: qrcodejs (cdnjs) does not support QRCode.toCanvas() → switched to the qrcode npm package, inlined
  • JSZip inlined – no more external dependencies
  • Tool works fully offline and via file://
v1.0 2026-03 · Erstes Release 2026-03 · First release
  • Reverse Engineering des SSI QR-Code-Formats (semikolon-delimitiert): dive;noid;dive_type;datetime;divetime;depth_m;site;…
  • UDDF-Import (XML): Parser für Shearwater Cloud UDDF-Exporte (generisch: funktioniert auch mit Suunto, Garmin, Apeks etc.)
  • QR-Code-Generierung pro Tauchgang
  • ZIP-Export aller QR-Codes
  • Tauchgang-Auswahl per Checkbox (Alle/Keiner)
  • Navigation zwischen QR-Codes im Modal (Vor/Zurück)
  • Einzeldownload als PNG
  • Drag & Drop + Datei-Picker
  • Reverse engineering of the SSI QR code format (semicolon-delimited): dive;noid;dive_type;datetime;divetime;depth_m;site;…
  • UDDF import (XML): parser for Shearwater Cloud UDDF exports (generic: also works with Suunto, Garmin, Apeks etc.)
  • QR code generation per dive
  • ZIP export of all QR codes
  • Dive selection via checkbox (select all / none)
  • Navigation between QR codes in modal (prev/next)
  • Individual download as PNG
  • Drag & drop + file picker
SSI Site ID Scanner Begleit-Tool Companion tool

Eigenständiges Tool zum Ermitteln von SSI Tauchplatz-IDs via QR-Code-Scan. Da SSI keine öffentliche API für Tauchplatz-IDs bereitstellt, müssen diese manuell aus bestehenden QR-Codes eines Tauchgangs ausgelesen werden.

  • Kamera-Scanner: QR-Codes direkt mit der Gerätekamera scannen
  • Manueller Import: QR-Code-Text direkt einfügen und parsen
  • Tauchplatz-Liste: Gescannte Plätze mit Name und Region speichern
  • JSON-Export: Direkt verwendbares JSON für das DIVE_SITES-Array
  • Persistenz: Gesammelte Plätze bleiben via localStorage gespeichert
  • Zweisprachig DE/EN

Standalone tool for retrieving SSI dive site IDs via QR code scan. Since SSI provides no public API for dive site IDs, they must be read manually from existing dive QR codes.

  • Camera scanner: scan QR codes directly with the device camera
  • Manual import: paste and parse QR code text directly
  • Dive site list: save scanned sites with name and region
  • JSON export: ready-to-use JSON for the DIVE_SITES array
  • Persistence: collected sites are saved via localStorage
  • Bilingual DE/EN