n8n-nodes-ninaapi

Community n8n nodes for N.I.N.A. (Nighttime Imaging 'N' Astronomy) via the ninaAPI plugin.
Automate your astrophotography workflow: control cameras, mounts, focusers, domes, polar alignment, sequences and more — all from n8n.

Nodes

Equipment

| Node | What it does | |------|-------------| | NINA Camera | Connect, capture images, plate-solve, set binning/readout, cool/warm, abort exposure | | NINA Mount | Slew, park/unpark, home, track, meridian flip, sync | | NINA Focuser | Move, stop, run autofocus, reverse direction | | NINA Filter Wheel | Change filter, list/add/remove filters | | NINA Dome | Open/close shutter, slew, park, follow mode, sync | | NINA Rotator | Move (sky / mechanical), reverse, stop | | NINA Flat Device | Set brightness, toggle light, open/close cover | | NINA Guider | Start/stop guiding, clear calibration, fetch guide graph | | NINA Safety Monitor | Read safe/unsafe state | | NINA Switch | Set switch value by index | | NINA Weather | Read temperature, humidity, pressure, cloud cover, dew point and more |

Application & Imaging

| Node | What it does | |------|-------------| | NINA Application | Switch tabs, take screenshots, read logs, list plugins | | NINA Sequence | Start/stop/reset, load by name, edit targets, skip items | | NINA Profile | List/switch profiles, read/change settings, get horizon | | NINA Image | Get images (by index), thumbnails, plate-solve, history | | NINA Framing | Set sky coordinates, slew, set rotation, moon separation | | NINA Live Stack | Start/stop, get stacked images per filter/target | | NINA Flats | Sky flats, auto-brightness, auto-exposure, trained flats |

Triggers & Polar Alignment

| Node | What it does | |------|-------------| | NINA Event Trigger | WebSocket trigger — fires on 34 NINA events (capture finished, autofocus, filter change, sequence, guider, safety, …) | | NINA TPPA | Three-Point Polar Alignment via WebSocket — start with full config, collect AzimuthError / AltitudeError / TotalError, stop/pause/resume |

Prerequisites

• N.I.N.A. ≥ 3.x
• ninaAPI plugin installed and running in N.I.N.A.
  Default address: http://localhost:1888

Installation

In n8n (recommended)

Settings → Community Nodes → Install → n8n-nodes-ninaapi

Manually

cd ~/.n8n/custom   # or your n8n custom nodes path
npm install n8n-nodes-ninaapi

Credentials

Add a NINA API credential with:

| Field | Default | Description | |-------|---------|-------------| | Host | localhost | Machine running N.I.N.A. with ninaAPI | | Port | 1888 | ninaAPI server port |

The credential test calls GET /version to verify connectivity.

Example Workflows

Automated Imaging Session

Schedule Trigger → NINA Mount (slew) → NINA Focuser (autofocus) 
  → NINA Camera (capture) → NINA Image (plate-solve) → Slack (notify)

Polar Alignment Assistant

Manual Trigger → NINA TPPA (start alignment, 120s)
  → IF lastMeasurement.TotalError < 1 → Done
  → ELSE → Telegram (send alignment errors)

Safety Shutdown

NINA Event Trigger (SAFETY-CHANGED) 
  → IF IsSafe=false 
  → NINA Mount (park) + NINA Dome (close) + NINA Camera (abort)

API Reference

This package targets ninaAPI v2 (/v2/api).
Full API documentation: https://christian-photo.github.io/github-page/projects/ninaAPI/v2/doc/api

License

MIT — see LICENSE