How can I shutdown OBS over websockets?

[viggou]

When attempting to quit OBS with send("Shutdown") nothing happens. OBS returns "Your request type is not valid."

I also tried sending the request with empty requestData like this: send("Shutdown", {}) to see if it would work, but looks like the library isn't sending empty dicts (but it also shouldn't be the issue).

I think it's an issue with the module, but let me know if I'm missing something.

Python logs:

2025-07-21 16:41:34,546 [ERROR]: OBSSDKRequestError: Request Shutdown returned code 204. With message: Your request type is not valid.
Traceback (most recent call last):
  File "/opt/homebrew/lib/python3.13/site-packages/obsws_python/reqs.py", line 53, in send
    raise OBSSDKRequestError(
    ...<3 lines>...
    )
obsws_python.error.OBSSDKRequestError: Request Shutdown returned code 204. With message: Your request type is not valid.

OBS logs:

16:41:34.544: [obs-websocket] [WebSocketServer::onOpen] New WebSocket client has connected from [::1]:63485
16:41:34.544: [obs-websocket] [debug] [WebSocketServer::onOpen] Sending Op 0 (Hello) message:
16:41:34.544: {
16:41:34.544:   "d": {
16:41:34.544:     "authentication": {
16:41:34.544:       "challenge": "pjPBWnjzymkPx5EwAbGJKO6rFkleT7CkXkRuS8V0Ws8=",
16:41:34.544:       "salt": "PjCG9JWWpDOzanGvFExbRtQ6A56GkwyMFJzxV4qjdCs="
16:41:34.544:     },
16:41:34.544:     "obsStudioVersion": "31.1.1",
16:41:34.544:     "obsWebSocketVersion": "5.6.2",
16:41:34.544:     "rpcVersion": 1
16:41:34.544:   },
16:41:34.544:   "op": 0
16:41:34.544: }
16:41:34.544: [obs-websocket] [debug] [WebSocketServer::onMessage] Incoming message (decoded):
16:41:34.544: {
16:41:34.544:   "d": {
16:41:34.544:     "authentication": "Bj5HkyyPYaG//CVBaGXPDtcRDNiUZN45+VZMYugGWJY=",
16:41:34.544:     "eventSubscriptions": 0,
16:41:34.544:     "rpcVersion": 1
16:41:34.544:   },
16:41:34.544:   "op": 1
16:41:34.544: }
16:41:34.545: [obs-websocket] [debug] [WebSocketServer::onMessage] Outgoing message:
16:41:34.545: {
16:41:34.545:   "d": {
16:41:34.545:     "negotiatedRpcVersion": 1
16:41:34.545:   },
16:41:34.545:   "op": 2
16:41:34.545: }
16:41:34.545: [obs-websocket] [debug] [WebSocketServer::onMessage] Incoming message (decoded):
16:41:34.545: {
16:41:34.545:   "d": {
16:41:34.545:     "requestId": 618,
16:41:34.545:     "requestType": "Shutdown"
16:41:34.545:   },
16:41:34.545:   "op": 6
16:41:34.545: }
16:41:34.546: [obs-websocket] [debug] [WebSocketServer::onMessage] Outgoing message:
16:41:34.546: {
16:41:34.546:   "d": {
16:41:34.546:     "requestId": 618,
16:41:34.546:     "requestStatus": {
16:41:34.546:       "code": 204,
16:41:34.546:       "comment": "Your request type is not valid.",
16:41:34.546:       "result": false
16:41:34.546:     },
16:41:34.546:     "requestType": "Shutdown"
16:41:34.546:   },
16:41:34.546:   "op": 7
16:41:34.546: }
16:41:34.569: [obs-websocket] [WebSocketServer::onClose] WebSocket client `[::1]:63485` has disconnected with code `1006` and reason: End of File

[onyx-and-iris]

Hi, shutdown isn't a request in the obs websocket protocol.

Are you trying to use obs-shutdown-plugin which does register a shutdown command with the websocket plugin?

If so, then you need to use CallVendorRequest.

Here is a working example.

[viggou]

Yes sorry, I somehow missed that it's from a separate plugin. Thanks!