Lighting Triggers

Lighting triggers let the Nightlight react automatically when something important happens—like a new handshake capture, a device connection, or a WebUI login. This guide walks you through creating, testing, and managing triggers in the web interface.

Note: Requires firmware version 0.6 or later.

Open the Triggers Panel

1. Browse to the Nightlight WebUI in your browser.
2. Go to Lighting.
3. Switch to the Triggers tab at the top of the panel.

Create a Trigger

1. Name: Give your trigger a descriptive name (for example, Handshake Celebration).
2. Trigger: Pick the event that should fire the lighting effect. Available options include:
   • Crackable Handshake Found
   • Packet Capture Starts
   • Beacon Broadcast Starts
   • BLE Capture Starts
   • WebUI Login
   • Credentials Updated
   • Device Connects
   • SD Card Busy
3. Effect: Choose how the lights should respond. Effects include rainbow, rainbow fade, aurora, scanner and strobe
4. Color (if required): For static_color, use the built-in color picker or tap Use Current to reuse the live preview color.
5. Duration (optional): Set the duration in milliseconds for time-bound effects, or leave blank for defaults.
6. Enable immediately: Keep this checked if you want the trigger live right away.
7. Click Save Trigger.

Manage Existing Triggers

• Toggle: Use the switch inside each trigger card to enable or disable it without deleting.
• Preview: Press Preview to play the effect immediately for testing.
• Edit: Select Edit to open the trigger details, adjust settings, and press Update Trigger.
• Delete: Remove a trigger entirely using Delete.

Tips

• Priority: If multiple triggers share the same preset trigger name, the Nightlight runs the one with the highest ID. Keep a single trigger active per event for predictable results.
• Beacon operations: beacon_broadcast_start and beacon_broadcast_stop only fire when you launch or stop a beacon spam job from the WebUI.
• SD card busy: sd_card_busy is useful if you run captures that temporarily lock the SD card.

With a handful of triggers configured, your Nightlight can react automatically to recon activity, captures, or administrative changes—no manual clicks required once everything is set up.