mpv JSON IPC
mpv accepts JSON IPC commands through a configured local socket or named pipe.
Open maintainer documentationWHAT YOU CAN DOControl playback and seek · Read and set player properties
HOW IT WORKSLive app
PLATFORMSWindows · macOS · Linux
DOCUMENTED AGENTSSee compatibility details
Documented capabilities
- Control playback and seekDocumentation
- Read and set player propertiesDocumentation
Agent compatibility
| Agent | Compatibility | Basis |
|---|---|---|
| Claude Code | Not documented | The native interface is documented, but no setup for this coding agent is established by this source. |
| Codex | Not documented | The native interface is documented, but no setup for this coding agent is established by this source. |
| Cursor | Not documented | The native interface is documented, but no setup for this coding agent is established by this source. |
Setup route
Follow the linked maintainer documentation for installation, connection settings and supported versions.
A running mpv process started with an IPC server socket or named pipe and a compatible client.
Limitations
The IPC endpoint must be explicitly enabled. A coding agent needs a client or bridge to send protocol commands.