Settings

Workspace
System
API Keys 01
API keys are defined in the server config file (config.yaml). Restart the server after editing the file to apply changes.
Server 02
If set, this base URL is used in webhook URLs and other user-visible links instead of the auto-detected local IP. Example: https://myserver.example.com:8080
Change the server log verbosity at runtime. DEBUG shows the most detail; CRITICAL shows only fatal errors.
What happens to LED targets when the server shuts down. "Stop targets" runs the normal stop sequence so devices with auto-restore restore their prior state. "Nothing" leaves the lights showing the last frame.
IANA timezone every "real-time" daylight cycle reads its wall clock in. Empty (default) uses the server's system timezone.
Unsaved changes in External URL
Lifecycle DESTRUCTIVE 03
Server Logs
Live tail of server log output, filterable by level. Opens in a full-screen overlay.
Restart Server
Bounce the LedGrab process. Active capture and connected devices will pause for ~3 seconds.
Manual 01
Download Backup
Download all configuration (devices, targets, streams, templates, automations) as a single JSON file.
Restore Configuration
Upload a previously downloaded backup file to replace all configuration. The server will restart automatically.
Auto-Backup 02
Enable auto-backup
 
Saved Backups 03
Auto-backup files stored on the server. Download to save locally, or delete to free space.
Channels 4 EVENTS 01
Pick how each device event reaches you. "Snack" shows an in-app toast, "OS" shows a system notification (browser must be granted permission), "Both" shows both, "None" silences the event entirely.
Event
Snack
OS
Both
None
Device came online
Device went offline
New device found
Discovered device lost
Discovery 02
Background discovery
Continuously scan the LAN (mDNS) and serial bus for new LED devices. Disable to silence "device discovered/lost" events at the source. Restart the server to apply.
OS Permission 03
OS notification permission
The browser controls OS notification permission per site. Once denied, LedGrab can no longer ask again — you need to clear it in the browser. Click the site icon (lock) in the address bar → Site settings → Notifications → Allow, then reload.
 
Update Status 01
Current version:
Install type:
View Release Notes
What's new in the available version — read the changelog before applying.
Auto-Check Settings 02
Enable auto-check
Periodically check for new releases in the background.
This is the persistent audit log — structured records of every entity change, auth event, and system action. It is separate from the ephemeral (live server log tail, resets on disconnect).
Retention 01
Enable activity logging
When disabled, no new audit entries are recorded. Existing entries are preserved.
Entries older than this many days are pruned automatically. Set to 0 to disable age-based pruning (keep forever, up to the entry limit).
Maximum number of entries to keep. When this limit is reached, the oldest entries are pruned. Set to 0 for no limit.
Export 02
Export as CSV
Download the full audit log as a file. Large logs may take a moment to prepare.
Export as JSON
Download the full audit log as a file. Large logs may take a moment to prepare.
To export with filters applied, use the .
Clear Log DESTRUCTIVE 03
Clear all entries
Permanently delete all activity log entries. This action is audited — a single system entry records who cleared the log and when.
LOG · STREAM
Server Logs
WebSocket · /api/v1/system/logs/ws
LINES
0
WARN
0
ERR
0
STANDBY
▸ TAIL 

        

            

            
Awaiting log frames

            
Connect the WebSocket stream to begin tailing.

        

    







    
    
    

    

        

            

                
                Release Notes
                
                CHANGELOG
            

            

                
                    
                    TAG
                    —
                
                
                    PUBLISHED
                    —
                
                
                    PRE-RELEASE