Troubleshooting
Connection refused
Section titled “Connection refused”Check that AstralOverlay is running and Notification API is enabled. WebSocket uses port 42070; UDP uses 42069. The API listens only on the local computer.
If XSOverlay or another process owns the port, stop that listener and restart the notification API or AstralOverlay.
WebSocket connects poorly or is rejected
Section titled “WebSocket connects poorly or is rejected”Include a nonempty client query parameter. Use ws://127.0.0.1:42070/?client=YourApp, not the documentation website address.
Connected, but no notification appears
Section titled “Connected, but no notification appears”- Use the exact command
SendNotification. - Encode
jsonDataas a string containing JSON. - Provide a nonempty title or content.
- Check notification visibility and silence settings.
- Check that opacity is greater than zero.
- Consider whether a burst is waiting in the queue.
A Python example cannot import websocket
Section titled “A Python example cannot import websocket”Install websocket-client in the same Python environment used to run the example. Its import name is websocket.
Layout loading closed my screens
Section titled “Layout loading closed my screens”Loading replaces the current screens and chat panels. An empty slot replaces them with an empty workspace.