Troubleshooting

Fresh

Common Issues

Plugin Not Appearing in Stream Deck

Steps:

1. Ensure npm run watch is running
2. Check terminal for build errors
3. Restart the Stream Deck application
4. Try running with elevated privileges (Windows)
5. Check the Stream Deck app logs for errors

Property Inspector Not Loading

1. Verify PropertyInspectorPath in manifest points to correct HTML file
2. Check the HTML file exists in .sdPlugin/ui/
3. Enable developer mode: streamdeck dev
4. Open http://localhost:23654/ to debug
5. Ensure PI is visible in Stream Deck (click on the action)

Deep Links Not Working

1. Verify plugin UUID matches the URL scheme
2. Check message length (max 2,000 characters)
3. For OAuth: use the Elgato redirect proxy if provider rejects custom schemes
4. For passive mode: ensure ?streamdeck=hidden parameter is included (SD 7.0+)

Settings Not Persisting

1. Ensure await is used with setSettings() calls
2. Check that settings object is JSON-serializable
3. For global settings: use streamDeck.settings.setGlobalSettings()
4. Verify event handlers are properly registered before streamDeck.connect()

Hot-Reload Not Working

1. Ensure npm run watch (not npm run build) is running
2. Check that file changes are in the src/ directory
3. Verify rollup config watches the correct directories
4. Try stopping and restarting the watch command

Log Locations

What	Windows	macOS
Plugin logs	.sdPlugin/logs/	.sdPlugin/logs/
SD App logs	%appdata%\Elgato\StreamDeck\logs\	~/Library/Logs/ElgatoStreamDeck/

Most recent log file is always index 0 (e.g., StreamDeck0.log).

Getting Help

• Marketplace Makers Discord - Community support
• Plugin Samples - Reference implementations
• Manifest Schema - Validation