@mentelm/pinanny

PiNanny is a Raspberry Pi nanny-cam: an Express server that streams HLS audio/video from the Pi camera (ffmpeg, fMP4 segments) with built-in WiFi provisioning via a setup access point. It runs as a systemd service under a dedicated pinanny system user.

Install

sudo npm install -g @mentelm/pinanny

Requires Node.js >= 18, Linux with systemd, ffmpeg, and NetworkManager (nmcli).

Quickstart

sudo pinanny service install

Then set a plaintext API password:

sudo pinanny reset-password api

CLI commands

| Command | Description | |---|---| | pinanny service install | Install the pinanny systemd service (user, polkit rule, unit file) and start it. Run with sudo. | | pinanny service uninstall | Stop and remove the systemd service, polkit rule, and legacy script symlinks. Run with sudo. | | pinanny service uninstall --purge | As above, and additionally remove the pinanny user, group, and /opt/pinanny data. | | pinanny reset-password [api\|wifi\|all] | Reset the API auth password (bcrypt-hashed) and/or the WiFi setup AP password (stored plaintext), then restart the service. No arg opens an interactive menu. Run with sudo. | | pinanny help | Show usage. |

The package itself is managed by npm (npm uninstall -g @mentelm/pinanny).