signalk-chiplog 2.7.0 → 2.9.0

package/CHANGELOG.md

@@ -6,6 +6,77 @@ All notable changes to Chiplog are documented here. The format follows
 
 ## [Unreleased]
 
+## [2.9.0] - 2026-10-20
+
+### Added
+
+- **Online backup.** Turn **Back the logbook up online** on, paste the service address and the device token it gave your
+  boat, and Chiplog sends each passage — track, events, handwriting, readings, crew and forecasts — to the Ti Bord
+  service whenever there is a connection: every 15 minutes, at each departure and arrival, newest passage first. Only
+  what changed goes out, compressed, and a track that grew only sends its new points. Passages deleted or merged on
+  board are removed from the service too, and the places go with their position and country, which is how the service
+  tells the countries visited. Each run also says how many passages are on board, so that the service can show how far a
+  first backup is. Off by default; nothing leaves the boat while it is.
+- **Costly link.** A tick box for satellite or roaming: the online backup then sends only a summary of each passage and
+  a thinned-out track, a few kilobytes, at departures and arrivals and every six hours. Full tracks, readings, forecasts
+  and places wait until it is unticked, or until **Back up now** is chosen.
+- **A QR code beside the pairing code.** Scan it with a phone and the service opens with the code already filled in:
+  nothing to type from the chart table's screen.
+- **Restoring the logbook from the online service.** After a lost SD card or on a new computer, pair the new
+  installation with the same boat and the Export page offers the logbook the service kept: one button brings every
+  passage back — track, events, handwriting, readings, crew, forecasts and places — and the backup carries on where it
+  stopped, without sending anything again. Only an empty logbook can take one back; a restore cut short picks up by
+  itself.
+- **Pairing with the online service by a short code.** On the Export page, ask the service for a code, enter it on the
+  service signed in to your account, and the backup turns on by itself: no token to copy. The same card shows the last
+  backup and a **Back up now** button.
+- **A summary of each passage, by email.** Turn it on, give it your SMTP relay and a few addresses, and Chiplog mails
+  the day's run once the passage is over for good — once it has stayed closed past the delay within which leaving again
+  would have carried it on, so a lock or a lunch anchorage never sets one off. The mail opens on the map of the track,
+  drawn on the server over OpenStreetMap tiles (or your own tile server, or a plain background) and carried inside the
+  message rather than attached, and goes on with the departure and arrival places and times, the distance, the duration,
+  the time under way, under engine and under sail, the average and maximum speed and the maximum wind, in the logbook's
+  language and the ship's time zone. At sea the relay is usually out of reach: a passage stays on the list and is tried
+  again, less and less often, then the backlog goes out oldest first on the next connection, with anything older than a
+  week dropped. Switching the option on sends nothing retroactively, and `POST /entries/:id/summary-mail` sends one
+  passage's summary straight away to try the settings out.
+
+### Changed
+
+- **A new app icon:** a chartplotter at the chart table, its screen showing a route plotted across a chart, in place of
+  the open book. It is what the Signal K admin shows and what the tablet app installs on a home screen. The browser tab
+  and the logbook's own header get a simplified version of it — the chart, a stretch of coast and the route — because at
+  that size the plotter's case, grid and compass turn to mush. The tablet app's colour in the phone's task switcher
+  follows the icon's case rather than the old blue.
+- **Coming back from a passage lands where you left the logbook.** Going back — with the browser's back button, with
+  "Back to the logbook" or from the nav bar — reopened the logbook at the top of the page, with only the first page of
+  passages: whatever had been loaded with "Load older passages" was gone, and so was the place you had scrolled to. The
+  logbook is now put back as it was, the older pages included, and rendered from what it was showing rather than from an
+  empty page, so it comes back at its old height and the scroll goes straight back where it was instead of jumping once
+  the passages arrive. Every other page still opens at the top.
+- **A button takes you back to the top of the logbook.** Once you have scrolled a way down — further still with the
+  older pages loaded — a round button in the corner brings you back up, rather than scrolling back through a season.
+
+## [2.8.0] - 2026-10-01
+
+### Added
+
+- **A manual entry's time can be typed in or corrected.** A note can be written up after the fact with the time it
+  happened, and any manoeuvre, note or sketch the crew logged can be redated later from the logbook's timeline or from
+  the tablet — an entry still waiting for the connection included. Since such an entry was not made where it happened,
+  its position is read back from the track at that time and left empty when the track has nothing within 2 minutes of
+  it, along with the instrument readings taken when the button was pressed. A time outside the passage or in the future
+  is refused, and the departure manoeuvre that opened a passage is still moved through that passage's departure time.
+
+### Changed
+
+- **The tablet's confirmation banner no longer reads as a question.** Logging an entry put up two buttons the size of
+  the app's primary actions, "Add a comment" and "Undo", which looked like a dialog waiting for an answer — it was not
+  clear the entry was already in, nor that "Undo" deleted it rather than dismissing the banner. The banner now confirms
+  first (a check mark, or a clock for an entry held on the tablet), carries a close button and a bar draining over the
+  ten seconds it stays, and puts the two follow-ups below the message at a smaller size, the undo in red and labelled
+  with what it undoes.
+
 ## [2.7.0] - 2026-09-22
 
 ### Added
@@ -383,7 +454,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.7.0...HEAD
+[Unreleased]: https://github.com/ricard33/signalk-chiplog/compare/v2.9.0...HEAD
+[2.9.0]: https://github.com/ricard33/signalk-chiplog/compare/v2.8.0...v2.9.0
+[2.8.0]: https://github.com/ricard33/signalk-chiplog/compare/v2.7.0...v2.8.0
 [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

package/README.md

@@ -29,6 +29,8 @@ English and French, chosen from the browser's language.
 - [Configuration](#configuration-)
 - [Signal K data used](#signal-k-data-used-)
 - [Backups and abandon ship](#backups-and-abandon-ship-)
+- [Online backup](#online-backup-)
+- [Passage summary emails](#passage-summary-emails-)
 - [Retrospective analysis](#retrospective-analysis-)
 - [Importing from PostgSail](#importing-from-postgsail-)
 - [Privacy and online services](#privacy-and-online-services-)
@@ -214,8 +216,12 @@ Open **Chiplog** from the Signal K webapps, or `/signalk-chiplog/`. Reading need
   counter at departure and arrival and the hours run, and the tank levels and battery charge, voltage and current noted
   at departure), and the log: every reading and event in order, including handwritten notes. A passage in progress
   refreshes every minute. Each line's comment can be edited (read/write access); a manoeuvre or note the crew logged
-  themselves can also be deleted — automatic lines (alarms, autopilot, weather, corrections) can only be annotated.
-  Under each position, in grey, its bearing and distance from the nearest landmark.
+  themselves can also be **redated** and deleted — automatic lines (alarms, autopilot, weather, corrections) can only be
+  annotated. Correcting a time reads the position back from the track at that time, and leaves it empty when the track
+  has nothing within 2 minutes of it, since the entry was not made where it happened. A time outside the passage, or in
+  the future, is refused, and the departure manoeuvre that opened a passage is moved by changing that passage's
+  departure time in **Corrections** below. Under each position, in grey, its bearing and distance from the nearest
+  landmark.
 - **Corrections** (read/write access):
   - rename the departure, or the arrival once the passage is closed — a passage in progress has none yet to rename;
   - switch an engine period to sail or back;
@@ -355,9 +361,11 @@ change. One tap logs it with the time, the position and an instrument reading.
 
 - **Sail change** asks which sail went up: mainsail, genoa, jib, staysail, spinnaker, gennaker, code 0, storm jib, or
   any name you type.
-- A banner then confirms it for 10 seconds, with two big buttons:
-  - **Undo**, for a mistaken tap;
-  - **Add a comment**, e.g. "25 kn, second reef".
+- A banner then confirms it: a check mark, what was logged and at what time, and a bar along the bottom draining over
+  the 10 seconds it stays. Nothing is waiting on you — it goes on its own, or at once with the **×**. Under the message
+  sit two optional follow-ups:
+  - **Add a comment**, e.g. "25 kn, second reef";
+  - **Undo this entry**, in red, for a mistaken tap — it deletes the entry just logged.
 
 ### Departures open the passage
 
@@ -372,7 +380,8 @@ note once moored belongs to the passage that brought you there. Anywhere else, t
 
 ### Notes and handwriting
 
-- **Note** — type and tap **Log it**.
+- **Note** — type and tap **Log it**. Leave **Time** empty for now, or fill it in to write up something that happened
+  earlier; a note dated by hand takes its position from the track rather than from where you are standing.
 - **Handwriting** — takes over the whole screen, with a toolbar above the pad: fine pen, thick pen, highlighter, eraser,
   undo, and a choice of colour (kept to the theme's colour in night mode, to spare night vision). Pen pressure also sets
   the line width. The eraser removes only what it actually touches, splitting a stroke rather than deleting all of it;
@@ -385,7 +394,8 @@ export, not just on the tablet.
 ### Latest entries
 
 Below, the latest entries of the current passage (or of the last one) are listed with their time. Each can take a
-comment, and your own entries can be deleted; a note's text can be edited.
+comment, and your own entries can be redated and deleted; a note's text can be edited. An entry still waiting for the
+connection can be corrected too — the change travels with it.
 
 ### Night mode
 
@@ -420,43 +430,51 @@ 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.                                                                                                                                                                                              |
-| 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.                            |
+| 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.                                                                                                                                                    |
+| Email a summary of each passage                                  | off                                              | Mails the map and figures of each passage once it is definitively closed.                                                                                                                                    |
+| Summary recipients                                               | —                                                | One or more email addresses, separated by commas.                                                                                                                                                            |
+| Summary sender                                                   | —                                                | The address the summaries come from. Most relays insist it be one they are allowed to send for.                                                                                                              |
+| SMTP server                                                      | —                                                | The mail relay the summaries are handed to. Empty turns the summaries off.                                                                                                                                   |
+| SMTP port                                                        | 587                                              | 587 for submission with STARTTLS, 465 for implicit TLS, 25 for a local relay.                                                                                                                                |
+| SMTP security                                                    | STARTTLS                                         | STARTTLS, TLS, or none for a relay on the boat itself.                                                                                                                                                       |
+| SMTP user name / password                                        | —                                                | Leave empty if the relay needs no authentication.                                                                                                                                                            |
+| Map tiles for the summary                                        | `https://tile.openstreetmap.org/{z}/{x}/{y}.png` | The tiles the summary map is drawn over, e.g. a self-hosted server. Empty draws the track on a plain background.                                                                                             |
+| Logbook language (PDF and summary emails)                        | en                                               | Language of the PDF logbooks on the USB drive and of the summary emails (English or French).                                                                                                                 |
+| Ship's time zone (PDF and summary emails)                        | the server's                                     | Time zone of the PDF logbooks on the USB drive and of the summary emails, 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 🔌
 
@@ -486,6 +504,89 @@ None of these is required except position and speed over ground; each feature us
   - Each file is flushed to the drive before it appears, so pulling the drive out never leaves a half-written file.
   - The Export page shows the schedule, the last copy, the next one, and the last failure if any.
 - **The database** — `chiplog.sqlite` in the plugin's data folder can be copied while the plugin is stopped.
+- **Online** — see [Online backup](#online-backup-) below.
+
+## Online backup 🌐
+
+Keep a copy of the logbook off the boat, on the Ti Bord online service.
+
+1. On the **Export** page, under **Online backup**, enter the service address and choose **Get a pairing code**.
+2. On the service, signed in to your account, enter the code shown (e.g. `K7QF-3MXB`) and choose your boat — or scan the
+   QR code beside it with your phone, which opens the service with the code filled in. The code is valid for 15 minutes.
+3. The page soon says the boat is paired: Chiplog has saved the service address and its own token in the plugin
+   configuration and turned the backup on.
+
+You can also paste a token by hand: turn **Back the logbook up online** on in the plugin configuration, fill in the
+**Online service address** and the **Device token**.
+
+From then on, whenever the boat has a connection, Chiplog sends:
+
+- every passage with its track, events, handwritten notes, instrument readings, crew and forecasts — the newest first,
+  so the latest passages are safe first after a long time offline;
+- only what changed since the service last heard of it, compressed: a passage under way sends the points added since,
+  not its whole track again;
+- the removal of passages deleted or merged on board;
+- the places — names, positions and countries — whenever one is added, renamed or gets its country.
+
+It checks every 15 minutes (**Online backup interval**), straight away at each departure and arrival, and when you
+choose **Back up now** on the Export page, which also shows the last backup and the last failure. Out of reach of a
+network, it simply tries again later. The logbook on board stays the record: nothing ever comes back from the service to
+change it.
+
+### On a satellite link
+
+Tick **Costly link** on the Export page (or in the plugin configuration) when every kilobyte is paid for. Chiplog then
+sends only a summary of each passage and a thinned-out track — a few kilobytes — at departures and arrivals and every
+six hours: enough for the service to know where you went, and for those ashore to follow. Full tracks, instrument
+readings, forecasts and places wait on board. Untick it back in harbour and everything follows; or choose **Back up
+now** to send it all at once anyway.
+
+### Getting the logbook back
+
+Lost the SD card, or moved to a new computer? Install Chiplog, pair it with the same boat on the service, and the
+**Export** page offers the logbook the service kept: choose **Restore this logbook**. Every passage comes back with its
+track, events, notes, readings, crew and forecasts, and the backup carries on where it had stopped. A restore cut short
+by a lost connection picks up by itself. Restore **before** sailing with the new installation: only an empty logbook can
+take one back.
+
+## Passage summary emails 📧
+
+Get the day's run in your inbox — and let whoever follows the boat from ashore get it too — without opening the webapp.
+Turn **Email a summary of each passage** on, fill in the recipients, the sender and your SMTP relay, and Chiplog mails a
+summary of every passage once it is over for good.
+
+- **When.** A passage closes the moment the boat stops, but leaving again within the stop tolerance (30 min by default)
+  carries it on. The summary waits out that window, so it arrives once the arrival is final — not at every lock or lunch
+  anchorage. One mail per passage, never two.
+- **What it says.** The map of the track first, then the departure and the arrival with their place and local time, the
+  distance, the duration, the time under way, the time under engine and under sail, the average and maximum speed, and
+  the maximum wind — the same figures and wording as the passage page, in the **logbook language** and **ship's time
+  zone** set below.
+- **The map** is drawn on the server and travels inside the message, so it shows up in the mail rather than as an
+  attachment to open. Tiles come from OpenStreetMap by default; set your own tile server, or clear the setting to get
+  the track drawn on a plain background and send nothing to a tile server.
+- **Offline is fine.** At sea the relay is usually out of reach: Chiplog keeps the passage on its list and tries again,
+  less and less often, then sends the backlog oldest first as soon as there is a connection. A passage closed more than
+  a week ago is dropped — a summary that late is no longer news.
+- **Nothing retroactive.** Turning the option on does not mail your existing logbook; only passages ending afterwards
+  are summarised.
+- **Trying your settings.** The relay only gets used at the next arrival, so to check the configuration straight away,
+  ask for one passage's summary to be sent now:
+
+```bash
+TOKEN=$(curl -s -X POST http://localhost:3000/signalk/v1/auth/login \
+  -H 'content-type: application/json' \
+  -d '{"username":"admin","password":"…"}' | sed 's/.*"token":"\([^"]*\)".*/\1/')
+curl -X POST -H "Authorization: Bearer $TOKEN" \
+  http://localhost:3000/plugins/signalk-chiplog/api/entries/1/summary-mail
+```
+
+With Signal K security switched off, the `Authorization` header is not needed. The passage does not have to be the last
+one, and a summary already sent is sent again — this works whether or not the option itself is on, so the relay can be
+tried before turning the automatic summaries on.
+
+A refusal the relay would only repeat — a recipient it will not take, a password it will not accept — is written to the
+Signal K log and that passage is not retried; fix the settings and resend it with the command above.
 
 ## Retrospective analysis 🕓
 
@@ -555,11 +656,17 @@ node scripts/import-postgsail.js PostgSail_Trip.geojson --url http://boat.local:
   Open-Meteo by default — once, at departure. Nothing at all when it is off.
 - **Weather forecast.** With it on, the departure position of each passage is sent to the weather service and to the
   marine service — both the public Open-Meteo by default — once, at departure. Nothing at all when it is off.
+- **Passage summaries.** With them on, each summary is sent to the SMTP relay you configure — yours, not a service of
+  ours — and the map it carries is drawn from tiles fetched from the tile server you configure, OpenStreetMap's public
+  one by default. Nothing at all when they are off, and nothing goes to a tile server when the tile setting is empty.
 - **Maps.** The logbook webapp loads map tiles from OpenStreetMap and OpenSeaMap while the device viewing it is online.
   Offline, the track is still drawn, on a blank background.
 - **Retrospective analysis.** Running one queries the InfluxDB database set in the plugin configuration — the boat's
   own, local or remote, never a third party — for the Signal K history in the requested range.
-- **Nothing else** leaves the boat. There is no account, analytics or cloud service.
+- **Online backup.** With it on, every passage — track, events, handwritten notes, readings, crew and forecasts — and
+  every place, with its name, position and country, is sent to the online service at the address you configure, with the
+  device token it gave your boat. Nothing at all when it is off.
+- **Nothing else** leaves the boat. There is no analytics, and no account unless you choose the online backup.
 
 Map data and place names © OpenStreetMap contributors (ODbL); seamarks © OpenSeaMap; tide and weather data ©
 [Open-Meteo.com](https://open-meteo.com/) (CC BY 4.0).