signalk-skydancer

Send your boat's Signal K telemetry to Skydancer Marine.

This plugin is intentionally tiny: it has zero runtime dependencies and uses the fetch API built into Node 18+. It subscribes to standard Signal K battery, tank, and propulsion paths, converts supported numeric values into Skydancer's telemetry vocabulary, and posts them to Skydancer with your boat key.

Install

After Curtis publishes the package, install it from the Signal K Appstore:

1. Open Signal K admin on the Cerbo.
2. Go to Appstore.
3. Search for skydancer.
4. Install signalk-skydancer.
5. Restart Signal K if the admin UI asks you to.

Configure

In the plugin settings:

• Ingest URL: leave the default https://app.skydancermarine.com/api/v2/telemetry/ingest.
• Boat key: paste the telemetry key from Skydancer. The key is sent only in the X-Skydancer-Telemetry-Key header.
• Flush interval: default is 30 seconds. The minimum is 10 seconds.
• Choose whether to send batteries, tanks, and engines.

What It Sends

The plugin sends only mapped numeric telemetry readings:

• Battery voltage, current, state of charge, and temperature.
• Tank current level.
• Engine or generator temperature and oil-pressure style pressure readings.

It does not send your full Signal K state tree, navigation history, routes, credentials, or arbitrary metadata. Unknown paths and non-numeric values are skipped before upload so they cannot poison a telemetry batch.

Offline Behavior

If Skydancer or the boat's internet connection is unavailable, the plugin keeps a bounded in-memory retry buffer of the most recent readings and tries again on the next flush. The buffer is intentionally memory-only in v0; disk buffering is planned for a later version.

Development

Run the mapping tests:

npm test

Syntax-check the plugin:

node --check index.js
node --check mapping.js