简体中文

Kotlin application for automatic live stream recording, with a browser extension for one-click control.

./gradlew build
java -jar build/libs/XhRec-all.jar

Then open https://localhost:8090 for the dashboard.

java -jar build/libs/XhRec-all.jar -p 12340 -f list.conf -post postprocessor.json -t /tmp/xhrec -o /out

One room per line. Lines starting with # or ; are inactive (not automatically recorded).

# https://stripchat.com/modelA q:720p limit:120
; https://stripchat.com/modelB q:240p
https://stripchat.com/modelC q:highest

If the requested quality is unavailable, the closest match is selected automatically.

Stream decryption key store. Created with defaults on first run if absent.

{
  "streamAuthKey": "default psch key, if failed to extract from master playlist",
  "maskSensitiveLogs": true,
  "decryptKeys": {
    "psch key 1": "decrypt key",
    "psch key 2": "decrypt key"
  }
}

User cookies for auto-payment. One cookie per line. Lines starting with # or ; are ignored.

Each cookie is validated against the platform API on startup to resolve the user's ID, name, and coin balance. When a private show requires payment, the system selects a user with sufficient coins.

# optional comments
cookie_string_here

https://localhost:8090 — manage rooms, view live status, and control recordings.

install

All endpoints return JSON unless noted. Parameters are passed as query strings.

| /mask/toggle | Toggle log masking on/off | | /mask/status | Get current mask status (true/false) |

{
  "Model Name": {
    "total": 10046,
    "success": 9933,
    "failed": 98,
    "bytesWrite": 1409108341,
    "running": {
      "https://...part3.mp4": {
        "type": "PROXY",
        "startAt": 1756357723403
      }
    }
  }
}

Defined in postprocessor.json. Processors run in sequence after a recording finishes.

Available in move destinations and shell arguments:

{
  "default": [
    { "type": "fix_stamp", "output": "out" },
    {
      "type": "move",
      "output": "out/[{{ROOM_ID}}]{{ROOM_NAME}}@{{RECORD_START}}-{{RECORD_END}} {{RECORD_DURATION_STR}}",
      "date_pattern": "yyyy-MM-dd HH:mm:ss"
    },
    { "type": "slice", "output": "out", "duration": "1m10s" },
    {
      "type": "shell",
      "noreturn": true,
      "remove_input": false,
      "date_pattern": "yyyy-MM-dd_HH-mm-ss",
      "cmd": [
        "ffmpeg", "-hide_banner", "-loglevel", "error", "-stats",
        "-i", "{{INPUT_ABS}}",
        "-vf", "thumbnail={{TOTAL_FRAMES_GUESS}}/400,scale=200:-1,tile=20x20",
        "-vframes", "1",
        "{{INPUT_DIR}}/{{INPUT_NAME_NOEXT}}.thumb.png",
        "-y"
      ]
    }
  ]
}

Logs are written to ./logs with daily rotation (xhrec.yyyy-MM-dd.log).

Sensitive information is replaced in log output by default. Static patterns (JWT tokens, cookies, auth URL parameters, proxy addresses) are masked with ***. Dynamic strings (model names, usernames) are registered at startup and replaced with a stable CRC32-based hash that persists within a session but changes on restart, allowing log correlation without revealing identities.

Masking can be toggled at runtime via the eye icon in the WebUI toolbar, or through the API:

curl -k https://localhost:8090/mask/toggle     # on/off
curl -k https://localhost:8090/mask/status     # current state

The setting persists to xhrec.json (maskSensitiveLogs field).

Prometheus metrics are exposed at /metrics. Example Grafana dashboard: