Skip to content

Ocyss/srs-auth / .agents/skills/srs-develop

srs-develop

Verified

Develop, modify, debug, review, maintain, and explain the SRS and Oryx codebases and the SRS Docker image toolchain. Use for planned changes to the next-generation SRS Go proxy, SRS browser player, ossrs/dev-docker images, or Oryx Go backend, React dashboard, integrated runtime, packaging, installers, releases, and tests; bug maintenance; issue and pull-request triage; pull-request review; and Learn Code questions. The C++ SRS server is in maintenance mode, and planned Go origin and edge development is not yet supported. NOT for end-user support, usage questions, or configuration help — use srs-support for those.

FileKindSize
SKILL.mdskill md8.2 KB
references/develop-code.mdmarkdown15.1 KB
references/fix-a-bug.mdmarkdown6.6 KB
references/integration-tests.mdmarkdown2.9 KB
references/learn-code.mdmarkdown3.3 KB
references/oryx-issues.mdmarkdown218 B
references/oryx-local-development.mdmarkdown11.9 KB
references/review-a-pr.mdmarkdown3.5 KB
references/scan-issues.mdmarkdown993 B
references/scan-prs.mdmarkdown1.4 KB
references/srs-issues.mdmarkdown58.5 KB
references/version-and-changelog.mdmarkdown2.3 KB
scripts/browser-page-url-test.jsscript2.7 KB
scripts/gb28181-api-timeout-test.shscript5.3 KB
scripts/gb28181-create-session.shscript2.1 KB
scripts/gb28181-publish-stream.shscript3.9 KB
scripts/gb28181-tcp-disconnect-test.shscript4.3 KB
scripts/oryx-api-smoke-test.shscript4.2 KB
scripts/oryx-camera-test.shscript12.2 KB
scripts/oryx-forward-test.shscript10.9 KB
scripts/oryx-live-room-test.shscript10.2 KB
scripts/oryx-live-streaming-test.shscript12.6 KB
scripts/oryx-record-test.shscript10.4 KB
scripts/oryx-run-tests.shscript2.3 KB
scripts/oryx-stack-start.shscript5.2 KB
scripts/oryx-stack-stop.shscript1.8 KB
scripts/oryx-transcode-test.shscript9.8 KB
scripts/oryx-vlive-test.shscript12.0 KB
scripts/proxy-e2e-bearer-auth-test.shscript12.0 KB
scripts/proxy-e2e-cluster-test.shscript10.4 KB
scripts/proxy-e2e-edge-test.shscript10.6 KB
scripts/proxy-e2e-redis-test.shscript11.7 KB
scripts/proxy-e2e-srt-test.shscript9.5 KB
scripts/proxy-e2e-test.shscript5.7 KB
scripts/proxy-e2e-transmux-test.shscript7.3 KB
scripts/proxy-e2e-whip-test.shscript11.5 KB
scripts/proxy-utest.shscript1.5 KB
scripts/setup-ffmpeg-with-whip.shscript7.5 KB

scripts/gb28181-publish-stream.sh

View on GitHub
#!/bin/bash
# Simulate an external-SIP GB28181 publisher. It creates an SRS session through
# the publish API, sends RFC4571-framed RTP/PS over TCP, then disconnects.
set -euo pipefail

SCRIPT_DIR="$(cd -P "$(dirname "$0")" && pwd)"
GB_CREATE_SESSION="$SCRIPT_DIR/gb28181-create-session.sh"
API_URL="http://127.0.0.1:1985"
MEDIA_HOST="127.0.0.1"
MEDIA_PORT=""
STREAM_ID="gb-publish-stream-$$"
SSRC="47190001"
HOLD_SECONDS="0.2"

usage() {
  cat <<EOF
Usage: $0 [options]

Options:
  --api-url URL         SRS HTTP API base URL (default: $API_URL)
  --media-host HOST     GB media TCP host (default: $MEDIA_HOST)
  --media-port PORT     GB media TCP port (default: publish API response)
  --id ID               GB stream ID (default: $STREAM_ID)
  --ssrc SSRC           RTP SSRC in decimal (default: $SSRC)
  --hold SECONDS        Hold TCP open after sending (default: $HOLD_SECONDS)
  -h, --help            Show this help
EOF
}

while [[ $# -gt 0 ]]; do
  case "$1" in
    --api-url)
      API_URL="$2"
      shift 2
      ;;
    --media-host)
      MEDIA_HOST="$2"
      shift 2
      ;;
    --media-port)
      MEDIA_PORT="$2"
      shift 2
      ;;
    --id)
      STREAM_ID="$2"
      shift 2
      ;;
    --ssrc)
      SSRC="$2"
      shift 2
      ;;
    --hold)
      HOLD_SECONDS="$2"
      shift 2
      ;;
    -h|--help)
      usage
      exit 0
      ;;
    *)
      echo "Error: unknown option: $1" >&2
      usage >&2
      exit 1
      ;;
  esac
done

if ! command -v python3 >/dev/null 2>&1; then
  echo "Error: python3 is required" >&2
  exit 1
fi
if [[ ! -x "$GB_CREATE_SESSION" ]]; then
  echo "Error: GB session creation helper is not executable: $GB_CREATE_SESSION" >&2
  exit 1
fi

PUBLISH_RESPONSE=$("$GB_CREATE_SESSION" \
  --api-url "$API_URL" \
  --id "$STREAM_ID" \
  --ssrc "$SSRC")
echo "Publish response: $PUBLISH_RESPONSE"

read -r RESPONSE_CODE RESPONSE_PORT RESPONSE_IS_TCP <<EOF
$(printf '%s' "$PUBLISH_RESPONSE" | python3 -c '
import json
import sys

response = json.load(sys.stdin)
print(response.get("code", -1), response.get("port", ""), str(response.get("is_tcp", False)).lower())
')
EOF

if [[ "$RESPONSE_CODE" != "0" ]]; then
  echo "FAIL: publish API returned code $RESPONSE_CODE" >&2
  exit 1
fi
if [[ "$RESPONSE_IS_TCP" != "true" ]]; then
  echo "FAIL: publish API did not return a TCP media endpoint" >&2
  exit 1
fi
if [[ -z "$MEDIA_PORT" ]]; then
  MEDIA_PORT="$RESPONSE_PORT"
fi

echo "Connect RTP/PS over TCP: $MEDIA_HOST:$MEDIA_PORT"
python3 - "$MEDIA_HOST" "$MEDIA_PORT" "$SSRC" "$HOLD_SECONDS" <<'PY'
import socket
import struct
import sys
import time

host = sys.argv[1]
port = int(sys.argv[2])
ssrc = int(sys.argv[3])
hold_seconds = float(sys.argv[4])

if not 0 < ssrc <= 0xFFFFFFFF:
    raise SystemExit("SSRC must be between 1 and 4294967295")

# A PS pack and complete audio PES packet derived from the SRS GB28181 parser
# regression fixture. The PES payload contains two valid AAC-LC/44.1kHz/stereo
# ADTS silence frames, rather than placeholder bytes that trigger an ADTS
# warning in the GB muxer. Sending two PS packs makes SRS deliver the first one
# to the GB session and marks the media transport connected.
ps_header = bytes.fromhex("000001ba44686e4c9401013013feffff0000a005")
aac_adts = bytes.fromhex(
    "fff1508003dffcde02004c61766336322e32382e31303100422008c11838"
    "fff1508001bffc211004608c1c"
)
pes_optional_header = bytes.fromhex("8c8009211a1ba351fffffff8")
pes_packet_length = len(pes_optional_header) + len(aac_adts)
audio_pes = (
    bytes.fromhex("000001c0")
    + struct.pack("!H", pes_packet_length)
    + pes_optional_header
    + aac_adts
)
ps_pack = ps_header + audio_pes

with socket.create_connection((host, port), timeout=3) as conn:
    for sequence in (1, 2):
        rtp = struct.pack("!BBHII", 0x80, 0xE0, sequence, sequence * 90000, ssrc) + ps_pack
        conn.sendall(struct.pack("!H", len(rtp)) + rtp)
        time.sleep(0.05)
    time.sleep(hold_seconds)

print("GB TCP publisher disconnected")
PY
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 322kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 322kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 322kUpdated Claude CodeCodexVerifiedInstall
skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.Stars: 198kUpdated Claude CodeCodexVerifiedInstall