@myerscarpenter/quest-dev 1.4.1 → 2.0.0

package/.claude/settings.local.json

@@ -0,0 +1,7 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(pnpm build:*)"
+    ]
+  }
+}

package/.github/workflows/docs.yml

@@ -0,0 +1,45 @@
+name: Deploy Documentation
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - 'packages/cast2-protocol/docs/**'
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: true
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Pages
+        uses: actions/configure-pages@v5
+
+      - name: Build with Jekyll
+        uses: actions/jekyll-build-pages@v1
+        with:
+          source: packages/cast2-protocol/docs
+          destination: ./_site
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

package/.github/workflows/publish.yml

@@ -31,6 +31,9 @@ jobs:
       - name: Install dependencies
         run: pnpm install
 
+      - name: Build workspace packages
+        run: pnpm -r run build
+
       - name: Run tests
         run: pnpm test
 
@@ -43,4 +46,11 @@ jobs:
       - name: Create GitHub Release
         env:
           GH_TOKEN: ${{ github.token }}
-        run: gh release create ${{ github.ref_name }} --generate-notes
+        run: |
+          PREV_TAG=$(git describe --tags --abbrev=0 HEAD^ 2>/dev/null || echo "")
+          if [ -n "$PREV_TAG" ]; then
+            NOTES=$(git log --pretty=format:"- %s" "$PREV_TAG"..HEAD^)
+          else
+            NOTES="Initial release"
+          fi
+          gh release create "${{ github.ref_name }}" --notes "$NOTES"

package/README.md

@@ -23,6 +23,33 @@ npm install -g @myerscarpenter/quest-dev
   npm install -g @myerscarpenter/cdp-cli
   ```
 
+## Casting Setup
+
+quest-dev can cast your Quest's screen to your computer. This requires a casting APK that ships inside Meta Quest Developer Hub (MQDH).
+
+**One-time setup:**
+
+```bash
+quest-dev setup-cast
+```
+
+On macOS, this auto-detects MQDH if it's installed in `/Applications`. Otherwise, download MQDH first and point to it:
+
+```bash
+# macOS — .app bundle (easiest)
+quest-dev setup-cast "/Applications/Meta Quest Developer Hub.app"
+
+# macOS — .dmg download
+quest-dev setup-cast ~/Downloads/MetaQuestDeveloperHub.dmg
+
+# Windows/Linux — .exe.zip download (requires 7z)
+quest-dev setup-cast ~/Downloads/Meta-Quest-Developer-Hub.exe.zip
+```
+
+Download MQDH from: https://developer.oculus.com/meta-quest-developer-hub
+
+The APK is extracted once and cached at `~/.local/share/quest-dev/`. When you start casting, it's auto-installed on your Quest if needed.
+
 ## Usage
 
 ### Screenshot

package/build/cast/decoder.d.ts

@@ -0,0 +1,48 @@
+/**
+ * H.264 to JPEG frame decoder using a persistent ffmpeg subprocess.
+ *
+ * Spawns ffmpeg with H.264 stdin → MJPEG stdout, extracts individual
+ * JPEG frames by scanning for SOI (FF D8) / EOI (FF D9) markers.
+ */
+import { EventEmitter } from "node:events";
+/**
+ * Extract complete JPEG frames from a buffer.
+ * Returns extracted frames and the remaining unprocessed bytes.
+ */
+export declare function extractJpegFrames(buf: Buffer): {
+    frames: Buffer[];
+    remainder: Buffer;
+};
+export interface FrameDecoderEvents {
+    frame: [jpeg: Buffer];
+    error: [err: Error];
+}
+/**
+ * Persistent ffmpeg-based H.264 → JPEG decoder.
+ *
+ * Usage:
+ *   const decoder = new FrameDecoder();
+ *   decoder.start();
+ *   decoder.feed(nalData);
+ *   const jpeg = decoder.getFrame();
+ *   decoder.stop();
+ */
+export declare class FrameDecoder extends EventEmitter {
+    private proc;
+    private latestFrame;
+    private readBuffer;
+    private running;
+    /** Check that ffmpeg is available on PATH. */
+    static checkFfmpeg(): void;
+    /** Start the persistent ffmpeg decoder process. */
+    start(): void;
+    /** Feed H.264 NAL data to the decoder. */
+    feed(nalData: Buffer): void;
+    /** Get the latest decoded JPEG frame, or null if none available. */
+    getFrame(): Buffer | null;
+    /** Stop the decoder and kill the ffmpeg process. */
+    stop(): void;
+    /** Whether the decoder is currently running. */
+    get isRunning(): boolean;
+}
+//# sourceMappingURL=decoder.d.ts.map

package/build/cast/decoder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decoder.d.ts","sourceRoot":"","sources":["../../src/cast/decoder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAS3C;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG;IAC9C,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB,CAkCA;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACtB,KAAK,EAAE,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;CACrB;AAED;;;;;;;;;GASG;AACH,qBAAa,YAAa,SAAQ,YAAY;IAC5C,OAAO,CAAC,IAAI,CAA6B;IACzC,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,UAAU,CAA2B;IAC7C,OAAO,CAAC,OAAO,CAAS;IAExB,8CAA8C;IAC9C,MAAM,CAAC,WAAW,IAAI,IAAI;IAU1B,mDAAmD;IACnD,KAAK,IAAI,IAAI;IA2Cb,0CAA0C;IAC1C,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAgB3B,oEAAoE;IACpE,QAAQ,IAAI,MAAM,GAAG,IAAI;IAIzB,oDAAoD;IACpD,IAAI,IAAI,IAAI;IAcZ,gDAAgD;IAChD,IAAI,SAAS,IAAI,OAAO,CAEvB;CACF"}

package/build/cast/decoder.js

@@ -0,0 +1,152 @@
+/**
+ * H.264 to JPEG frame decoder using a persistent ffmpeg subprocess.
+ *
+ * Spawns ffmpeg with H.264 stdin → MJPEG stdout, extracts individual
+ * JPEG frames by scanning for SOI (FF D8) / EOI (FF D9) markers.
+ */
+import { spawn } from "node:child_process";
+import { EventEmitter } from "node:events";
+import which from "which";
+import { verbose } from "../utils/verbose.js";
+// JPEG markers
+const JPEG_SOI = 0xffd8;
+const JPEG_EOI_0 = 0xff;
+const JPEG_EOI_1 = 0xd9;
+/**
+ * Extract complete JPEG frames from a buffer.
+ * Returns extracted frames and the remaining unprocessed bytes.
+ */
+export function extractJpegFrames(buf) {
+    const frames = [];
+    let data = buf;
+    while (true) {
+        // Find SOI marker (FF D8)
+        let start = -1;
+        for (let i = 0; i < data.length - 1; i++) {
+            if (data[i] === 0xff && data[i + 1] === 0xd8) {
+                start = i;
+                break;
+            }
+        }
+        if (start < 0) {
+            // No SOI found — discard everything
+            return { frames, remainder: Buffer.alloc(0) };
+        }
+        // Find EOI marker (FF D9) after SOI
+        let end = -1;
+        for (let i = start + 2; i < data.length - 1; i++) {
+            if (data[i] === JPEG_EOI_0 && data[i + 1] === JPEG_EOI_1) {
+                end = i + 2; // include both EOI bytes
+                break;
+            }
+        }
+        if (end < 0) {
+            // Incomplete frame — keep from SOI onward
+            return { frames, remainder: data.subarray(start) };
+        }
+        frames.push(Buffer.from(data.subarray(start, end)));
+        data = data.subarray(end);
+    }
+}
+/**
+ * Persistent ffmpeg-based H.264 → JPEG decoder.
+ *
+ * Usage:
+ *   const decoder = new FrameDecoder();
+ *   decoder.start();
+ *   decoder.feed(nalData);
+ *   const jpeg = decoder.getFrame();
+ *   decoder.stop();
+ */
+export class FrameDecoder extends EventEmitter {
+    proc = null;
+    latestFrame = null;
+    readBuffer = Buffer.alloc(0);
+    running = false;
+    /** Check that ffmpeg is available on PATH. */
+    static checkFfmpeg() {
+        try {
+            which.sync("ffmpeg");
+        }
+        catch {
+            throw new Error("ffmpeg not found on PATH. Install ffmpeg to enable video decoding.");
+        }
+    }
+    /** Start the persistent ffmpeg decoder process. */
+    start() {
+        if (this.running)
+            return;
+        this.running = true;
+        this.readBuffer = Buffer.alloc(0);
+        this.proc = spawn("ffmpeg", [
+            "-loglevel", "error",
+            "-f", "h264", "-i", "pipe:0",
+            "-q:v", "3",
+            "-f", "image2pipe", "-vcodec", "mjpeg", "pipe:1",
+        ], { stdio: ["pipe", "pipe", "pipe"] });
+        this.proc.stdout.on("data", (chunk) => {
+            this.readBuffer = Buffer.concat([this.readBuffer, chunk]);
+            const { frames, remainder } = extractJpegFrames(this.readBuffer);
+            this.readBuffer = remainder;
+            if (frames.length > 0) {
+                this.latestFrame = frames[frames.length - 1];
+                this.emit("frame", this.latestFrame);
+            }
+        });
+        this.proc.stderr.on("data", (chunk) => {
+            verbose("ffmpeg stderr:", chunk.toString().trim());
+        });
+        this.proc.on("exit", (code) => {
+            verbose("ffmpeg decoder exited with code", code);
+            this.running = false;
+        });
+        this.proc.on("error", (err) => {
+            this.emit("error", err);
+            this.running = false;
+        });
+        verbose("Started persistent ffmpeg decoder");
+    }
+    /** Feed H.264 NAL data to the decoder. */
+    feed(nalData) {
+        if (!this.proc?.stdin?.writable)
+            return;
+        try {
+            this.proc.stdin.write(nalData);
+        }
+        catch {
+            verbose("Decoder pipe broken, restarting...");
+            this.stop();
+            this.start();
+            try {
+                this.proc?.stdin?.write(nalData);
+            }
+            catch {
+                // Give up on this NAL
+            }
+        }
+    }
+    /** Get the latest decoded JPEG frame, or null if none available. */
+    getFrame() {
+        return this.latestFrame;
+    }
+    /** Stop the decoder and kill the ffmpeg process. */
+    stop() {
+        this.running = false;
+        if (this.proc) {
+            try {
+                this.proc.stdin?.end();
+                this.proc.kill();
+            }
+            catch {
+                // Already dead
+            }
+            this.proc = null;
+        }
+        this.readBuffer = Buffer.alloc(0);
+    }
+    /** Whether the decoder is currently running. */
+    get isRunning() {
+        return this.running;
+    }
+}
+//# sourceMappingURL=decoder.js.map

package/build/cast/decoder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decoder.js","sourceRoot":"","sources":["../../src/cast/decoder.ts"],"names":[],"mappings":"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"}

package/build/cast/session.d.ts

@@ -0,0 +1,87 @@
+/**
+ * CastSession: manages TCP connections to Quest, protocol handshake,
+ * H.264 video decoding, pose control, and stay-awake lifecycle.
+ */
+import { EventEmitter } from "node:events";
+import { type LayerInfo, type PoseOffset, type PoseDelta, type PoseState } from "@myerscarpenter/cast2-protocol";
+export interface CastSessionOptions {
+    listenPort?: number;
+    width?: number;
+    height?: number;
+}
+export declare class CastSession extends EventEmitter {
+    private _listenPort;
+    private _connected;
+    private _running;
+    private server;
+    private controlSocket;
+    private videoSocket;
+    private controlSeq;
+    private subMagic;
+    private controlMsgSeq;
+    private sessionUuid;
+    private sessionTimestamp;
+    private questMsgSeq;
+    private decoder;
+    private currentSpsPps;
+    private currentIdr;
+    private _frameCount;
+    private _byteCount;
+    private startTime;
+    private _width;
+    private _height;
+    private _pose;
+    private _poseLoopTimer;
+    private _poseLoopActive;
+    private _eye;
+    private inputForwardingStarted;
+    private _layerId;
+    private _layerAutoSelected;
+    private _layers;
+    constructor(options?: CastSessionOptions);
+    get listenPort(): number;
+    get connected(): boolean;
+    get running(): boolean;
+    get frameCount(): number;
+    get byteCount(): number;
+    get width(): number;
+    get height(): number;
+    get pose(): PoseState;
+    get layers(): Map<number, LayerInfo>;
+    get layerId(): number;
+    get poseLoopActive(): boolean;
+    get eye(): number;
+    get elapsedSeconds(): number;
+    get fps(): number;
+    /** Bind the TCP server, trying successive ports on EADDRINUSE. */
+    bind(): Promise<void>;
+    private tryBind;
+    start(questIp?: string): Promise<void>;
+    stop(): Promise<void>;
+    restart(): Promise<void>;
+    adbSetup(questIp: string): Promise<void>;
+    startCastService(questIp: string): Promise<void>;
+    private waitForConnections;
+    private sendXrsp;
+    private nextSeq;
+    private handleVideo;
+    private processVideoPayload;
+    getScreenshot(): Buffer | null;
+    sendPose(pose: PoseState): void;
+    applyPoseDelta(delta: PoseDelta): void;
+    setPoseOffset(abs: PoseOffset): void;
+    /** Start periodic pose refresh at ~27 Hz (matching MQDH cadence). */
+    startPoseLoop(): void;
+    /** Stop periodic pose refresh. */
+    stopPoseLoop(): void;
+    sendDisplayConfig(width: number, height: number, eye?: number): void;
+    sendClick(x?: number, y?: number, layerId?: number, holdMs?: number): Promise<void>;
+    ensureInputForwarding(): void;
+    sendInputForwardingState(state: number): void;
+    resetView(): void;
+    sendSetProperty(name: string, value: string): void;
+    sendMud(typeId: number, payload?: Buffer): void;
+    sendRotation(pitch?: number, yaw?: number, forward?: number, strafe?: number): void;
+    private autoSelectLayer;
+}
+//# sourceMappingURL=session.d.ts.map

package/build/cast/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/cast/session.ts"],"names":[],"mappings":"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"}