IPC Protocol Reference

{"command":["<method>","<arg1>","<arg2>",...],"request_id":<number>}

{"error":"success","request_id":<number>,"data":<value>}

{"error":"<message>","request_id":<number>,"data":null}

{"event":"start-file","request_id":0}

{"event":"property-change","id":1,"request_id":0,"name":"time-pos","data":43.1}

import json, socket

def ipc(command):
    s = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
    s.connect(("127.0.0.1", 32321))
    s.sendall((json.dumps(command) + "\n").encode())
    resp = s.makefile().readline()
    s.close()
    return json.loads(resp)

# Observe time position
ipc({"command": ["observe_property", 1, "time-pos"], "request_id": 1})

# Set volume and mute
ipc({"command": ["set", "volume", 70], "request_id": 2})
ipc({"command": ["set", "mute", False], "request_id": 3})

# Seek and adjust speed
ipc({"command": ["seek", 30, "absolute"], "request_id": 4})
ipc({"command": ["set", "speed", 1.5], "request_id": 5})

# Load YouTube URL
ipc({"command": ["loadfile",
  "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
  "replace"], "request_id": 6})

const net = require("net");

function ipc(command) {
  return new Promise((resolve, reject) => {
    const client = net.createConnection(32321, "127.0.0.1", () => {
      client.write(JSON.stringify(command) + "\n");
    });
    let data = "";
    client.on("data", (chunk) => {
      data += chunk.toString();
      if (data.endsWith("\n")) {
        resolve(JSON.parse(data.trim()));
        client.end();
      }
    });
    client.on("error", reject);
  });
}

async function main() {
  const props = await Promise.all([
    ipc({ command: ["get_property", "time-pos"], request_id: 1 }),
    ipc({ command: ["get_property", "duration"], request_id: 2 }),
    ipc({ command: ["get_property", "media-title"], request_id: 3 }),
  ]);
  console.log("Playback state:", props);
}

main();

#!/bin/bash
IPC="127.0.0.1 32321"

# Get current position
echo '{"command":["get_property","time-pos"],"request_id":1}' | nc -q0 $IPC

# Set A-B loop
echo '{"command":["set","ab-loop-a",10.5],"request_id":2}' | nc -q0 $IPC
echo '{"command":["set","ab-loop-b",45.2],"request_id":3}' | nc -q0 $IPC

# Take screenshot with subs
echo '{"command":["screenshot"],"request_id":4}' | nc -q0 $IPC

# Observe volume changes
echo '{"command":["observe_property",10,"volume"],"request_id":5}' | nc -q0 $IPC

# Keep connection open to receive events
nc -q-1 $IPC

function Send-IpcCommand {
    param([string]$Command)
    $client = New-Object System.Net.Sockets.TcpClient("127.0.0.1", 32321)
    $stream = $client.GetStream()
    $writer = New-Object System.IO.StreamWriter($stream)
    $reader = New-Object System.IO.StreamReader($stream)
    $writer.WriteLine($Command)
    $writer.Flush()
    $response = $reader.ReadLine()
    $client.Close()
    return $response | ConvertFrom-Json
}

# Usage
Send-IpcCommand '{"command":["get_property","media-title"],"request_id":1}'
Send-IpcCommand '{"command":["set","pause",true],"request_id":2}'
Send-IpcCommand '{"command":["loadfile","C:\Movies\clip.mp4","replace"],"request_id":3}'