signalk-chiplog 2.5.1 → 2.7.0

package/CHANGELOG.md

@@ -6,6 +6,64 @@ All notable changes to Chiplog are documented here. The format follows
 
 ## [Unreleased]
 
+## [2.7.0] - 2026-09-22
+
+### Added
+
+- **Heading changes are logged automatically.** A turn of 30° or more (configurable), held steady for a minute above 2
+  knots, is added to the timeline as the average heading it settled on. Can be turned off in settings.
+
+- **The retrospective analysis can read the Signal K History API.** Instead of connecting to an InfluxDB 1.x database
+  itself, Chiplog can now read whichever history provider the server has registered — signalk-to-influxdb2, QuestDB,
+  TimescaleDB — with no database credentials to set. Pick it with **History source** in the settings; InfluxDB 1.x stays
+  the default, so an existing installation is untouched.
+- **Engine and sail segments are reconstructed from an InfluxDB 1.x history too.** The retrospective analysis read the
+  engine RPMs but never listed the boat's engines, so a reconstructed passage carried no propulsion segment and no
+  engine hours.
+
+### Changed
+
+- **The 3D animation starts on the medium boat size.** The 3D view opened with the smallest of the three; it now opens
+  on the middle one, where the boat is large enough to be read. **Boat size** still offers all three.
+
+- **The 3D animation's boat is drawn as a cartoon.** The generated sailboat has been rebuilt: a fuller hull with a
+  proper sheer and overhangs, a planked deck with a covering board, a coachroof with portholes, a cockpit with a crew on
+  the weather rail, a roached mainsail with a stripe and a burgee at the masthead — all in flat colours with an inked
+  silhouette, so it still reads when the boat is only a hundred pixels long. Nothing changes for a crew who load their
+  own `.glb`.
+
+- **`navigation.state` is followed whatever its source.** Chiplog no longer prefers signalk-autostate's value over
+  another source of the same path: it uses the one Signal K resolves the path to. On a boat where the AIS transponder
+  and signalk-autostate both publish it, which one wins is settled in the server's source priorities — that is also
+  where a transponder left at "under way using engine" while moored is corrected.
+
+## [2.6.0] - 2026-09-20
+
+### Changed
+
+- **The animation's date range is kept in the address.** Picking a period updates the page's URL, so reloading the page
+  or sharing the link keeps the same dates.
+- **The boat no longer disappears when a passage leaves from where the last one arrived.** There is then no camera move
+  at all: the boat stays in the frame through the short rest and the next passage starts from it. It is still hidden
+  while the camera flies between two different places.
+- **The animation opens and closes on the whole navigation.** It starts on a view of everything that will be sailed,
+  zooms down to the first position in two seconds, and after the last arrival pulls back out to the whole navigation in
+  two seconds, the boat not drawn during either move: it appears where the sailing begins. The rest at the end of each
+  passage is shortened to a beat (0.3 s at ×1), so the boat no longer stands still for a second or more between
+  passages.
+
+### Added
+
+- **A 3D view of the animation.** The Animation page has a new _View_ switch: the same film, at the map's own scale and
+  with north at the top, seen by a camera tilted down onto a 3D sailboat, with the map laid flat under it. The boat
+  follows the general direction of the track rather than every sampled heading, yet turns with it at a tack or a
+  headland, heels and trims its sails to the wind, rides the waves with a pitch and a light roll, and you can frame it
+  closer or wider than the map and choose the boat's size. Load your own boat as a `.glb` file and it is used instead —
+  with its sails trimmed to the wind too, if their nodes are named `Mainsail` and `Jib` (the README has a guide to
+  preparing a model) — kept in that browser. **Export the video** films whichever view is showing (`-3d` in the file
+  name). The 3D view needs WebGL 2 and is loaded only when asked for; without it, the map view is used. It adds three.js
+  to the vendored libraries (about 600 KB, MIT).
+
 ## [2.5.1] - 2026-09-19
 
 ### Fixed
@@ -325,7 +383,9 @@ First release.
 - REST API under `/plugins/signalk-chiplog/api`, documented in [docs/API.md](docs/API.md).
 - Single SQLite database through Node's built-in `node:sqlite`: no native module to build.
 
-[Unreleased]: https://github.com/ricard33/signalk-chiplog/compare/v2.5.1...HEAD
+[Unreleased]: https://github.com/ricard33/signalk-chiplog/compare/v2.7.0...HEAD
+[2.7.0]: https://github.com/ricard33/signalk-chiplog/compare/v2.6.0...v2.7.0
+[2.6.0]: https://github.com/ricard33/signalk-chiplog/compare/v2.5.1...v2.6.0
 [2.5.1]: https://github.com/ricard33/signalk-chiplog/compare/v2.5.0...v2.5.1
 [2.5.0]: https://github.com/ricard33/signalk-chiplog/compare/v2.4.0...v2.5.0
 [2.4.0]: https://github.com/ricard33/signalk-chiplog/compare/v2.3.1...v2.4.0

package/README.md

@@ -8,7 +8,7 @@ sensors cannot know from a tablet at the helm: manoeuvres, notes and handwriting
   such as a lock or a lunch anchorage.
 - **GPS track**, distance, time under engine and under sail.
 - **Hourly instrument readings**, as on a paper log, plus readings at departure, arrival and each manoeuvre.
-- **Automatic events**: alarms, autopilot changes, strong wind, falling barometer.
+- **Automatic events**: alarms, autopilot changes, strong wind, falling barometer, held heading changes.
 - **Departure and arrival names**, looked up online and corrected once for good.
 - **Consultation webapp**: logbook by day, map, timeline, corrections, export.
 - **Replay a range of passages** on the map — an hour of sailing per second — and save it as an MP4 for a phone, a
@@ -87,9 +87,9 @@ A **passage** is one logbook entry: from leaving a berth or anchorage to arrivin
   which carries on once the boat moves.
 - **Power cuts and restarts.** If the server comes back after the boat has been still for longer than the tolerance, the
   passage is closed at its last movement. A short restart carries on with the same passage.
-- **Under way or stopped** comes from `navigation.state` when signalk-autostate provides it. Otherwise Chiplog averages
-  speed over ground over 3 minutes: under way above 1 knot, stopped below half a knot. This keeps a boat swinging at
-  anchor from starting passages.
+- **Under way or stopped** comes from `navigation.state` when something publishes it — signalk-autostate, typically.
+  Otherwise Chiplog averages speed over ground over 3 minutes: under way above 1 knot, stopped below half a knot. This
+  keeps a boat swinging at anchor from starting passages.
 
 A passage that was split in two — a stop just longer than the tolerance, for instance — can be merged back from the
 logbook webapp. The stop the merge folds away is kept on the timeline as its own line, naming the place, since it would
@@ -131,6 +131,8 @@ Added to the timeline without anyone touching anything:
 - **Wind** — true wind, averaged over 2 minutes, rising above 20 and 30 knots and falling back below them
   (configurable).
 - **Barometer** — a fall of 4 hPa or more over 3 hours (configurable).
+- **Heading changes** — a turn of 30° or more, held steady for a minute, above 2 knots (configurable, and can be turned
+  off).
 
 An alarm at anchor between two passages goes to the passage that ended there, as long as the boat is within 1 nautical
 mile of that arrival.
@@ -227,13 +229,19 @@ Open **Chiplog** from the Signal K webapps, or `/signalk-chiplog/`. Reading need
   distance and time, the flags of the countries visited, and the top 5 passages by duration, distance, average speed,
   top speed and wind. Countries come from the place names, so they need geocoding enabled and the boat online now and
   then; places named before this existed fill in by themselves.
-- **Animation** — pick a period and every passage in it replays on the map, one after another, the port time skipped.
-  The map follows the boat at a scale chosen for each passage — a short hop kept readable rather than magnified, a long
-  crossing allowed a wider view but never so wide the boat crawls across empty water — while a bubble shows the speed,
-  the distance covered since the start and the date. Play, pause and a slider over the animation's own time, at ×0,5,
-  ×1, ×2 or ×4. **Export MP4** saves it as a video in one of five shapes (Mobile 9:16, Portrait 3:4, Square 1:1,
-  Landscape 4:3, Widescreen 16:9). Everything happens in the browser: nothing is rendered or encoded on the Signal K
-  server, and the map tiles are the only thing downloaded.
+- **Animation** — pick a period (kept in the page's address, so a reload or a shared link keeps it) and every passage in
+  it replays on the map, one after another, the port time skipped. The film opens on the whole navigation and zooms down
+  to the first position in two seconds, and pulls back out to the whole navigation at the end. The map follows the boat
+  at a scale chosen for each passage — a short hop kept readable rather than magnified, a long crossing allowed a wider
+  view but never so wide the boat crawls across empty water — while a bubble shows the speed, the distance covered since
+  the start and the date. Play, pause and a slider over the animation's own time, at ×0,5, ×1, ×2 or ×4. **Export MP4**
+  saves it as a video in one of five shapes (Mobile 9:16, Portrait 3:4, Square 1:1, Landscape 4:3, Widescreen 16:9).
+  Everything happens in the browser: nothing is rendered or encoded on the Signal K server, and the map tiles are the
+  only thing downloaded. **View → 3D** shows the same film, at the map's own scale and with north still at the top, as a
+  camera tilted down onto a cartoon sailboat that heels and trims its sails to the wind and rides the waves, with the
+  map laid flat under it; frame it closer or wider than the map and pick the boat's size if you like, and load your own
+  boat as a `.glb` file — sails included — if you would rather see it (see
+  [Your own boat](#your-own-boat-in-the-3d-animation-)). The MP4 export then films the 3D view.
 - **Export** — download the whole logbook or a date range as a PDF logbook to print, JSON, CSV or GPX, and write the
   abandon-ship copy to the USB drive now (admin). The PDF is written in the webapp's language and the device's time
   zone.
@@ -246,6 +254,85 @@ shortcuts beside it; where any date is allowed, the calendar has an _Any date_ b
 
 **Helm entry** in the top bar opens the tablet entry app.
 
+### Your own boat in the 3D animation ⛵
+
+The 3D view draws a cartoon sailboat. To see yours instead, use **Boat → Use my own boat…** under the animation and pick
+a `.glb` file. The model is kept in **that browser only** (it is never sent to the logbook or the Signal K server), so
+it has to be loaded again on another device; **Use the default boat** puts the generic one back.
+
+**The file**
+
+|               |                                                                                                                                   |
+| ------------- | --------------------------------------------------------------------------------------------------------------------------------- |
+| Format        | Binary glTF 2.0 (`.glb`), one self-contained file — textures embedded                                                             |
+| Size          | 30 MB at most (a few MB is plenty: the boat is small on the film)                                                                 |
+| Not supported | Draco, Meshopt or KTX2 compression. Animations, cameras and lights inside the file are ignored — the view lights the scene itself |
+| Materials     | Ordinary glTF materials. Make the sails **double-sided**, or one face vanishes as they swing                                      |
+
+**Orientation, size and waterline**
+
+- **Y is up and the bow points towards +Z** — the glTF convention. Nothing else says which end is the front, so a boat
+  that sails backwards needs a half turn about the vertical axis before it is exported.
+- **Any unit.** The model is scaled so that its longest horizontal extent — length, or width if that is larger,
+  including a boom or a bowsprit — is one boat length, and centred in plan. A stray helper object far from the boat (a
+  ground plane, a light) enlarges that box and shrinks the boat: delete them before exporting.
+- **The lowest point of the model is taken as the bottom of the keel** and placed a twentieth of the boat's length under
+  the waterline, everything else above. The sea is drawn behind the boat and never cuts into it, so the hull is always
+  whole.
+- **The whole boat turns, heels, pitches and rides the waves** with no work on your part. Its size on screen is set by
+  the _Boat size_ buttons, not by the model.
+
+**Sails that move to the wind**
+
+Name the sail nodes and the view trims them like the default boat's: let out as the wind comes aft, and on the side away
+from it.
+
+| Sail     | Names recognised                                                    | Origin of the node                   | Turns by            |
+| -------- | ------------------------------------------------------------------- | ------------------------------------ | ------------------- |
+| Mainsail | `Mainsail`, `Main`, `Sail_Main`, `GrandVoile`, `GV`                 | On the mast, at the foot of the sail | The full sail angle |
+| Headsail | `Jib`, `Genoa`, `Headsail`, `Foresail`, `Sail_Jib`, `Foc`, `Génois` | On the forestay, at the tack         | 0.8 of it           |
+
+Case, spaces, punctuation and the number a modelling tool adds to a copy (`Mainsail.001`) do not matter.
+
+- **The sail is rotated about the vertical axis through the origin of its node.** Put that origin where the sail should
+  pivot — the mast, or the bow fitting for a jib — not at the middle of the cloth, or it will swing sideways.
+- **Model it at rest on the centreline**, the boom pointing aft (−Z). The view adds the trim angle to whatever rotation
+  the node already has.
+- **The angle** is about half the apparent wind angle, at least 4° and at most 88°, smoothed like the boat's heading.
+  The wind on the starboard side puts the sail to port, and the other way round. Where the track has no wind reading the
+  sails stay on the centreline.
+- **Put the boom, the sail and its fittings inside the sail node** so they turn together. Only the outermost node with a
+  recognised name is turned; anything nested in it goes along.
+- **The cloth is rigid.** It does not billow, and a camber does not swap sides with the tack: model it flat or
+  symmetrical.
+- **Nothing else is animated** — no flag, rudder or propeller.
+
+**From Blender**
+
+1. Model the boat with its bow towards **−Y** and Z up — Blender's own front — so it comes out towards +Z with Y up.
+2. Name the sail objects `Mainsail` and `Jib`.
+3. For each sail, put the 3D cursor on the mast foot (or the tack) and use **Object ▸ Set Origin ▸ Origin to 3D
+   Cursor**. Apply rotation and scale (**Ctrl+A**).
+4. Set the sail material to double-sided (**Backface Culling** off).
+5. **File ▸ Export ▸ glTF 2.0**, format **glTF Binary (.glb)**, **+Y Up** ticked, compression off; lights and cameras
+   need not be included.
+6. Load the file in the animation. The line under the boat says which sails were found — _Sails trimmed to the wind:
+   mainsail, jib_ — or _No sail recognised_ if a name is off.
+
+**When something is wrong**
+
+| What you see                     | Why, and what to do                                                                                           |
+| -------------------------------- | ------------------------------------------------------------------------------------------------------------- |
+| The boat sails backwards         | The bow points towards −Z. Turn the model 180° about the vertical axis and export again                       |
+| The boat lies on its side        | Exported with Z up. Export with **+Y Up**                                                                     |
+| The boat is tiny                 | Something far from it is in the file — a ground plane, a light. Remove it                                     |
+| _No sail recognised_             | The nodes are not named as in the table, or a wrapper node above them has a sail name and hides them          |
+| The sails do not move            | The track has no wind readings (there is no apparent wind angle), or the sail nodes are called something else |
+| A sail swings about an odd point | Its origin is not on the mast or the tack                                                                     |
+| One face of a sail disappears    | The material is single-sided                                                                                  |
+| _That file could not be read_    | It is not a `.glb`, or it uses Draco, Meshopt or KTX2 compression                                             |
+| The model is gone next time      | The browser's site data was cleared, or it is another browser or device. Load it again                        |
+
 ## The tablet entry app 📱
 
 Open `/signalk-chiplog/entry/` on the tablet, or follow **Helm entry** from the logbook. For an app-like, full-screen
@@ -333,36 +420,43 @@ a regular Signal K user account.
 
 In the Signal K admin, **Apps & Plugins → Configuration → Chiplog**.
 
-| Setting                                                          | Default                                       | What it does                                                                                                                                                                     |
-| ---------------------------------------------------------------- | --------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| Stop duration within which a new departure continues the passage | 30 min                                        | A passage closes when the boat stops; leaving again sooner reopens it, the stop kept as a stopover.                                                                              |
-| Under-way speed without navigation.state                         | 1 kn                                          | Used only without signalk-autostate: under way above it, stopped below half of it.                                                                                               |
-| Propulsion assumed without engine data                           | sail                                          | When nothing says whether the engine is running. Set to engine on a motorboat.                                                                                                   |
-| Instrument snapshot interval                                     | 60 min                                        | Readings on this clock boundary during a passage.                                                                                                                                |
-| Track point interval                                             | 15 s                                          | A track point at least this often while moving.                                                                                                                                  |
-| Place matching radius                                            | 200 m                                         | A departure or arrival this close to a known place takes its name.                                                                                                               |
-| Name departures and arrivals with online geocoding               | on                                            | Turn off to never send positions online; places are then named after their coordinates until corrected.                                                                          |
-| Geocoding service                                                | `https://nominatim.openstreetmap.org`         | Any Nominatim-compatible service, e.g. a self-hosted one.                                                                                                                        |
-| Read each journal line against the nearest landmark              | on                                            | Fetches the landmarks of the areas sailed through from OpenStreetMap, so each position is also given as a bearing and distance from one. Turn off to keep the coordinates alone. |
-| Landmark service (Overpass API)                                  | `https://overpass-api.de/api/interpreter`     | Any Overpass-compatible service, e.g. a self-hosted one.                                                                                                                         |
-| Fetch the tide forecast at departure                             | on                                            | Turn off to never send the departure position online; the passage page then shows no tide.                                                                                       |
-| Marine service                                                   | `https://marine-api.open-meteo.com/v1/marine` | Any Open-Meteo Marine-compatible service, e.g. a self-hosted one. Serves the tide, and the sea state and current of the weather forecast.                                        |
-| Fetch the marine weather forecast at departure                   | on                                            | Turn off to never send the departure position to the weather services; the passage page and the PDF then show no forecast.                                                       |
-| Weather service                                                  | `https://api.open-meteo.com/v1/forecast`      | Any Open-Meteo-compatible forecast service, e.g. a self-hosted one.                                                                                                              |
-| USB export directory                                             | —                                             | Where the abandon-ship copy is written, e.g. `/media/usb`. Empty turns the USB copy off.                                                                                         |
-| Automatic USB copy interval                                      | 15 min                                        | How often the USB copy is brought up to date. 0 turns the periodic copy off.                                                                                                     |
-| Copy to the USB drive at each arrival                            | on                                            | Brings the USB copy up to date as soon as a passage ends.                                                                                                                        |
-| Logbook language (PDF)                                           | en                                            | Language of the PDF logbooks on the USB drive (English or French).                                                                                                               |
-| Ship's time zone (PDF)                                           | the server's                                  | Time zone of the PDF logbooks on the USB drive, e.g. `Europe/Paris`.                                                                                                             |
-| Wind speed thresholds                                            | 20, 30 kn                                     | Logged when the 2-minute average true wind crosses them.                                                                                                                         |
-| Barometric drop warning                                          | 4 hPa / 3 h                                   | 0 turns it off.                                                                                                                                                                  |
-| InfluxDB host (retrospective analysis)                           | —                                             | Local or remote host of the InfluxDB 1.x database signalk-to-influxdb writes to. Empty turns the retrospective analysis page off.                                                |
-| InfluxDB port                                                    | 8086                                          |                                                                                                                                                                                  |
-| InfluxDB database                                                | —                                             |                                                                                                                                                                                  |
-| InfluxDB username / password                                     | —                                             | Leave empty if the database needs none.                                                                                                                                          |
-| InfluxDB protocol                                                | http                                          | `http` or `https`.                                                                                                                                                               |
-| InfluxDB query timeout                                           | 30 s                                          | Each retrospective query gives up and reports an error past this, instead of hanging against an unreachable or overloaded database.                                              |
-| InfluxDB vessel context                                          | this server's own                             | Only needed running the replay from a different Signal K server than the one that wrote the history, e.g. development pointed at a production database.                          |
+| Setting                                                          | Default                                       | What it does                                                                                                                                                                                                 |
+| ---------------------------------------------------------------- | --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| Stop duration within which a new departure continues the passage | 30 min                                        | A passage closes when the boat stops; leaving again sooner reopens it, the stop kept as a stopover.                                                                                                          |
+| Under-way speed without navigation.state                         | 1 kn                                          | Used only without signalk-autostate: under way above it, stopped below half of it.                                                                                                                           |
+| Propulsion assumed without engine data                           | sail                                          | When nothing says whether the engine is running. Set to engine on a motorboat.                                                                                                                               |
+| Instrument snapshot interval                                     | 60 min                                        | Readings on this clock boundary during a passage.                                                                                                                                                            |
+| Track point interval                                             | 15 s                                          | A track point at least this often while moving.                                                                                                                                                              |
+| Place matching radius                                            | 200 m                                         | A departure or arrival this close to a known place takes its name.                                                                                                                                           |
+| Name departures and arrivals with online geocoding               | on                                            | Turn off to never send positions online; places are then named after their coordinates until corrected.                                                                                                      |
+| Geocoding service                                                | `https://nominatim.openstreetmap.org`         | Any Nominatim-compatible service, e.g. a self-hosted one.                                                                                                                                                    |
+| Read each journal line against the nearest landmark              | on                                            | Fetches the landmarks of the areas sailed through from OpenStreetMap, so each position is also given as a bearing and distance from one. Turn off to keep the coordinates alone.                             |
+| Landmark service (Overpass API)                                  | `https://overpass-api.de/api/interpreter`     | Any Overpass-compatible service, e.g. a self-hosted one.                                                                                                                                                     |
+| Fetch the tide forecast at departure                             | on                                            | Turn off to never send the departure position online; the passage page then shows no tide.                                                                                                                   |
+| Marine service                                                   | `https://marine-api.open-meteo.com/v1/marine` | Any Open-Meteo Marine-compatible service, e.g. a self-hosted one. Serves the tide, and the sea state and current of the weather forecast.                                                                    |
+| Fetch the marine weather forecast at departure                   | on                                            | Turn off to never send the departure position to the weather services; the passage page and the PDF then show no forecast.                                                                                   |
+| Weather service                                                  | `https://api.open-meteo.com/v1/forecast`      | Any Open-Meteo-compatible forecast service, e.g. a self-hosted one.                                                                                                                                          |
+| USB export directory                                             | —                                             | Where the abandon-ship copy is written, e.g. `/media/usb`. Empty turns the USB copy off.                                                                                                                     |
+| Automatic USB copy interval                                      | 15 min                                        | How often the USB copy is brought up to date. 0 turns the periodic copy off.                                                                                                                                 |
+| Copy to the USB drive at each arrival                            | on                                            | Brings the USB copy up to date as soon as a passage ends.                                                                                                                                                    |
+| Logbook language (PDF)                                           | en                                            | Language of the PDF logbooks on the USB drive (English or French).                                                                                                                                           |
+| Ship's time zone (PDF)                                           | the server's                                  | Time zone of the PDF logbooks on the USB drive, e.g. `Europe/Paris`.                                                                                                                                         |
+| Wind speed thresholds                                            | 20, 30 kn                                     | Logged when the 2-minute average true wind crosses them.                                                                                                                                                     |
+| Barometric drop warning                                          | 4 hPa / 3 h                                   | 0 turns it off.                                                                                                                                                                                              |
+| Log heading changes                                              | on                                            | Turn off to leave heading changes out of the log.                                                                                                                                                            |
+| Heading change threshold                                         | 30°                                           | A change must be at least this large to be logged.                                                                                                                                                           |
+| Heading change tolerance                                         | 10°                                           | How much the new heading may wander while holding and still count as steady.                                                                                                                                 |
+| Heading change hold time                                         | 60 s                                          | How long the new heading must hold before it is logged.                                                                                                                                                      |
+| Heading change minimum speed                                     | 2 kn                                          | Below this speed over ground, the course is too noisy to log a change.                                                                                                                                       |
+| Heading change cooldown                                          | 5 min                                         | A new change is logged only once the last one is at least this old.                                                                                                                                          |
+| History source (retrospective analysis)                          | InfluxDB 1.x                                  | Select Signal K History API to read the server's own history provider, such as signalk-to-influxdb2 — no database connection needed. InfluxDB 1.x stays the default so existing installations are untouched. |
+| InfluxDB host (retrospective analysis)                           | —                                             | Shown only for the InfluxDB 1.x legacy source. Local or remote host of the database signalk-to-influxdb writes to. Empty turns the retrospective analysis page off.                                          |
+| InfluxDB port                                                    | 8086                                          |                                                                                                                                                                                                              |
+| InfluxDB database                                                | —                                             |                                                                                                                                                                                                              |
+| InfluxDB username / password                                     | —                                             | Leave empty if the database needs none.                                                                                                                                                                      |
+| InfluxDB protocol                                                | http                                          | `http` or `https`.                                                                                                                                                                                           |
+| Retrospective query timeout                                      | 30 s                                          | Each retrospective query gives up and reports an error past this, instead of hanging against an unreachable or overloaded history. Applies to either source.                                                 |
+| Vessel context (retrospective analysis)                          | this server's own                             | Only needed running the replay from a different Signal K server than the one that wrote the history, e.g. development pointed at a production database. Applies to either source.                            |
 
 ## Signal K data used 🔌
 
@@ -374,7 +468,7 @@ None of these is required except position and speed over ground; each feature us
 | Engine or sail            | `propulsion.*.revolutions`, `propulsion.*.state`, `navigation.state`                                                                                                                                                                                                                                                               |
 | Readings                  | `navigation.headingTrue` (or `headingMagnetic` + `magneticVariation`), `navigation.speedThroughWater`, `environment.wind.*`, `environment.depth.belowSurface` (or `belowTransducer`), `environment.outside.pressure`, `environment.outside.temperature`, `environment.water.temperature`, `navigation.log`, `propulsion.*.runTime` |
 | Boat status               | `tanks.*.*.currentLevel`, `.currentVolume`, `.capacity`, `.name`, `electrical.batteries.*.voltage`, `.current`, `.capacity.stateOfCharge`, `.temperature`, `.name`                                                                                                                                                                 |
-| Events                    | `notifications.*`, `steering.autopilot.state`, `.mode`, `.engaged`, `.target`, `environment.wind.speedTrue`, `environment.outside.pressure`                                                                                                                                                                                        |
+| Events                    | `notifications.*`, `steering.autopilot.state`, `.mode`, `.engaged`, `.target`, `environment.wind.speedTrue`, `environment.outside.pressure`, `navigation.headingTrue` (or `headingMagnetic` + `magneticVariation`)                                                                                                                 |
 
 ## Backups and abandon ship 🛟
 
@@ -400,9 +494,13 @@ stopped? The **Retrospective** page (admin access) reconstructs those passages f
 Chiplog runs live — the same thresholds, so a reconstructed passage is one Chiplog would have logged had it been running
 at the time.
 
-- **Requires [signalk-to-influxdb](https://github.com/tkurki/signalk-to-influxdb)** (a recommended companion plugin)
-  already having written the boat's data into an InfluxDB 1.x database — local or on another machine, set in **Apps &
-  Plugins → Configuration**: host, port, database, and a username/password if it needs one.
+- Choose a history source in **Apps & Plugins → Configuration**:
+  - **Signal K History API** (recommended) reads the server's active history provider, such as
+    [signalk-to-influxdb2](https://github.com/tkurki/signalk-to-influxdb2), without database credentials or storage
+    schema assumptions.
+  - **InfluxDB 1.x (legacy)** requires [signalk-to-influxdb](https://github.com/tkurki/signalk-to-influxdb) to have
+    written the boat's data into an InfluxDB 1.x database — local or on another machine — set with host, port, database,
+    and a username/password if it needs one.
 - Pick a **from** and **to** date on the Retrospective page and start it. It runs in the background — the page shows its
   progress — and can be cancelled at any point; a first quick pass finds when the boat moved, and only those stretches
   are then fetched and reconstructed, so weeks in port take next to no time. Once done, the page sums up what it added:
@@ -482,9 +580,10 @@ Chiplog works, but departures and arrivals are decided from speed only. The mess
 - **"has not been updated since…"** — the source named stopped publishing. signalk-autostate republishes every 10
   minutes while it receives position and speed: check that the GPS data reaches the server, and that the plugin is
   enabled.
-- **"is “default” (from nmea0183.AI)"** — another device publishes a navigational status Chiplog does not use, typically
-  the boat's own AIS transponder, and signalk-autostate's value is not there to take over. Check that signalk-autostate
-  is enabled; Chiplog prefers its value over any other source.
+- **"is “default” (from nmea0183.AI)"** — the source Signal K resolved `navigation.state` to publishes a navigational
+  status Chiplog does not use, typically the boat's own AIS transponder. Chiplog follows whichever source the server
+  picks, so the fix is on the server: check that signalk-autostate is enabled, and give it priority over the transponder
+  in Signal K's source priorities.
 
 ### Passages are not opening
 
@@ -539,10 +638,10 @@ context** in the plugin configuration.
 ### A retrospective analysis takes minutes then fails with no clear reason
 
 The InfluxDB server did not answer — unreachable, overloaded, a firewall or a VPN not connected. Each query now gives up
-after **InfluxDB query timeout** (30 seconds by default) with the connection problem it ran into, rather than hanging
-until some far longer, less informative failure; check that the server named in the plugin configuration is reachable
-from wherever Signal K runs, and that it is not overloaded — or raise the timeout if it is simply slow to answer a
-six-hour chunk.
+after **Retrospective query timeout** (30 seconds by default) with the connection problem it ran into, rather than
+hanging until some far longer, less informative failure; check that the server named in the plugin configuration is
+reachable from wherever Signal K runs, and that it is not overloaded — or raise the timeout if it is simply slow to
+answer a six-hour chunk.
 
 ### A retrospective analysis over several days makes the InfluxDB server unresponsive
 
@@ -565,6 +664,9 @@ between attempts; nothing is lost, it just takes longer to resolve.
 - **Offline charts** are not provided; the animation draws the tracks on a blank sea when there is no connection.
 - **The MP4 export needs a browser with WebCodecs** — Chrome, Edge, Safari 17 or Firefox 130 and later. Without it the
   animation still plays on screen, and the export button is simply not offered.
+- **The 3D view needs WebGL 2.** Without it the switch is greyed out and the map view is used. Heel, pitch and sail trim
+  are estimated from the wind — the logbook records none of them — and a boat model you load stays in that browser only,
+  so it has to be loaded again on another device.
 - **A long animation takes a while to export**: every frame waits for its map before it is drawn, so the video is the
   same whatever the connection was doing, but a long range means a lot of tiles. Turning the seamarks off halves them.
 - **One vessel per Signal K server**, and no per-crew-member authorship.

package/index.js

@@ -225,50 +225,121 @@ module.exports = function (app) {
         default: EVENT_DEFAULTS.pressureDropThreshold,
         minimum: 0
       },
-      influxHost: {
-        type: 'string',
-        title: 'InfluxDB host (retrospective analysis)',
+      headingChangeEnabled: {
+        type: 'boolean',
+        title: 'Log heading changes',
         description:
-          'For reconstructing past passages from a signalk-to-influxdb history (InfluxDB 1.x), local or remote. Leave empty to turn that feature off'
+          'Records a course change once it is held; turn off to leave heading changes out of the log',
+        default: EVENT_DEFAULTS.headingChangeEnabled
       },
-      influxPort: {
+      headingChangeThreshold: {
         type: 'number',
-        title: 'InfluxDB port',
-        default: INFLUX_DEFAULTS.influxPort
+        title: 'Heading change threshold (degrees)',
+        description: 'A change must be at least this large to be logged',
+        default: EVENT_DEFAULTS.headingChangeThreshold,
+        minimum: 1,
+        maximum: 180
       },
-      influxDatabase: {
-        type: 'string',
-        title: 'InfluxDB database'
+      headingChangeTolerance: {
+        type: 'number',
+        title: 'Heading change tolerance (degrees)',
+        description: 'How much the new heading may wander while holding and still count as steady',
+        default: EVENT_DEFAULTS.headingChangeTolerance,
+        minimum: 0
       },
-      influxUsername: {
-        type: 'string',
-        title: 'InfluxDB username',
-        description: 'Leave empty if the database needs none'
+      headingChangeHoldSeconds: {
+        type: 'number',
+        title: 'Heading change hold time (seconds)',
+        description: 'How long the new heading must hold before it is logged',
+        default: EVENT_DEFAULTS.headingChangeHoldSeconds,
+        minimum: 1
       },
-      influxPassword: {
-        type: 'string',
-        title: 'InfluxDB password',
-        format: 'password'
+      headingChangeMinSpeed: {
+        type: 'number',
+        title: 'Heading change minimum speed (knots)',
+        description: 'Below this speed over ground, the course is too noisy to log a change',
+        default: EVENT_DEFAULTS.headingChangeMinSpeed,
+        minimum: 0
+      },
+      headingChangeCooldownMinutes: {
+        type: 'number',
+        title: 'Heading change cooldown (minutes)',
+        description: 'A new change is logged only once the last one is at least this old',
+        default: EVENT_DEFAULTS.headingChangeCooldownMinutes,
+        minimum: 0
       },
-      influxProtocol: {
+      retrospectiveHistorySource: {
         type: 'string',
-        title: 'InfluxDB protocol',
-        enum: ['http', 'https'],
-        default: INFLUX_DEFAULTS.influxProtocol
+        title: 'History source for retrospective analysis',
+        description:
+          'Signal K reads the server’s own History API provider (signalk-to-influxdb2, for example), needing no database connection of its own — the better choice on a new installation. InfluxDB 1.x keeps the legacy direct database reader, and stays the default so installations already set up that way go on working untouched.',
+        enum: ['influxdb1', 'signalk'],
+        enumNames: ['InfluxDB 1.x (legacy)', 'Signal K History API'],
+        default: 'influxdb1'
       },
       influxQueryTimeoutSeconds: {
         type: 'number',
-        title: 'InfluxDB query timeout (seconds)',
+        title: 'Retrospective query timeout (seconds)',
         description:
-          'Each retrospective query is given up on and reported as an error past this, rather than hanging indefinitely against an unreachable or overloaded database',
+          'Each retrospective query is given up on and reported as an error past this, rather than hanging indefinitely against an unreachable or overloaded history. Applies to either history source',
         default: INFLUX_DEFAULTS.influxQueryTimeoutSeconds,
         minimum: 1
       },
       influxSelfContext: {
         type: 'string',
-        title: 'InfluxDB vessel context',
+        title: 'Vessel context (retrospective analysis)',
         description:
-          'Only needed running the replay from a different Signal K server than the one that wrote the history — e.g. a development instance pointed at a boat’s production database. The vessel context the data was tagged with, such as "vessels.urn:mrn:imo:mmsi:123456789"; a failed replay names the contexts actually found. Leave empty to use this server’s own (Signal K → Server → Vessel Identity)'
+          'Only needed running the replay from a different Signal K server than the one that wrote the history — e.g. a development instance pointed at a boat’s production database. The vessel context the data was tagged with, such as "vessels.urn:mrn:imo:mmsi:123456789"; a failed replay names the contexts actually found. Leave empty to use this server’s own (Signal K → Server → Vessel Identity). Applies to either history source'
+      }
+    },
+    // RJSF evaluates dependencies each time the selector changes. Keeping the
+    // InfluxDB fields out of the top-level properties hides them in History
+    // API mode and inserts them immediately after the source selector.
+    dependencies: {
+      retrospectiveHistorySource: {
+        oneOf: [
+          {
+            properties: {
+              retrospectiveHistorySource: { const: 'influxdb1' },
+              influxHost: {
+                type: 'string',
+                title: 'InfluxDB host (retrospective analysis)',
+                description:
+                  'For reconstructing past passages from a signalk-to-influxdb history (InfluxDB 1.x), local or remote. Leave empty to turn that feature off'
+              },
+              influxPort: {
+                type: 'number',
+                title: 'InfluxDB port',
+                default: INFLUX_DEFAULTS.influxPort
+              },
+              influxDatabase: {
+                type: 'string',
+                title: 'InfluxDB database'
+              },
+              influxUsername: {
+                type: 'string',
+                title: 'InfluxDB username',
+                description: 'Leave empty if the database needs none'
+              },
+              influxPassword: {
+                type: 'string',
+                title: 'InfluxDB password',
+                format: 'password'
+              },
+              influxProtocol: {
+                type: 'string',
+                title: 'InfluxDB protocol',
+                enum: ['http', 'https'],
+                default: INFLUX_DEFAULTS.influxProtocol
+              }
+            }
+          },
+          {
+            properties: {
+              retrospectiveHistorySource: { const: 'signalk' }
+            }
+          }
+        ]
       }
     }
   };
@@ -400,6 +471,16 @@ module.exports = function (app) {
         logbookTimeZone: config.logbookTimeZone || null,
         windSpeedThresholds: config.windSpeedThresholds ?? EVENT_DEFAULTS.windSpeedThresholds,
         pressureDropThreshold: config.pressureDropThreshold ?? EVENT_DEFAULTS.pressureDropThreshold,
+        headingChangeEnabled: config.headingChangeEnabled ?? EVENT_DEFAULTS.headingChangeEnabled,
+        headingChangeThreshold:
+          config.headingChangeThreshold ?? EVENT_DEFAULTS.headingChangeThreshold,
+        headingChangeTolerance:
+          config.headingChangeTolerance ?? EVENT_DEFAULTS.headingChangeTolerance,
+        headingChangeHoldSeconds:
+          config.headingChangeHoldSeconds ?? EVENT_DEFAULTS.headingChangeHoldSeconds,
+        headingChangeMinSpeed: config.headingChangeMinSpeed ?? EVENT_DEFAULTS.headingChangeMinSpeed,
+        headingChangeCooldownMinutes:
+          config.headingChangeCooldownMinutes ?? EVENT_DEFAULTS.headingChangeCooldownMinutes,
         influxHost: config.influxHost || null,
         influxPort: config.influxPort ?? INFLUX_DEFAULTS.influxPort,
         influxDatabase: config.influxDatabase || null,
@@ -408,7 +489,9 @@ module.exports = function (app) {
         influxProtocol: config.influxProtocol || INFLUX_DEFAULTS.influxProtocol,
         influxQueryTimeoutSeconds:
           config.influxQueryTimeoutSeconds ?? INFLUX_DEFAULTS.influxQueryTimeoutSeconds,
-        influxSelfContext: config.influxSelfContext || null
+        influxSelfContext: config.influxSelfContext || null,
+        retrospectiveHistorySource:
+          config.retrospectiveHistorySource === 'signalk' ? 'signalk' : 'influxdb1'
       };
 
       if (settings.logbookTimeZone && !isTimeZone(settings.logbookTimeZone)) {