@myerscarpenter/quest-dev 1.0.8 → 1.2.0

package/build/commands/stay-awake.js

@@ -0,0 +1,234 @@
+/**
+ * Quest stay-awake command
+ * Keeps Quest screen awake by setting screen timeout to 24 hours
+ * Restores original timeout on exit (Ctrl-C)
+ */
+import { checkADBPath } from '../utils/adb.js';
+import { execCommand } from '../utils/exec.js';
+import { execSync, spawn } from 'child_process';
+import * as os from 'os';
+import * as fs from 'fs';
+/**
+ * Get current screen timeout setting
+ */
+async function getScreenTimeout() {
+    const output = await execCommand('adb', ['shell', 'settings', 'get', 'system', 'screen_off_timeout']);
+    return parseInt(output.trim(), 10);
+}
+/**
+ * Set screen timeout (in milliseconds)
+ */
+async function setScreenTimeout(timeout) {
+    await execCommand('adb', ['shell', 'settings', 'put', 'system', 'screen_off_timeout', timeout.toString()]);
+}
+/**
+ * Disable Quest proximity sensor (keeps screen on even when not worn)
+ */
+async function disableProximitySensor() {
+    await execCommand('adb', ['shell', 'am', 'broadcast', '-a', 'com.oculus.vrpowermanager.prox_close']);
+}
+/**
+ * Enable Quest proximity sensor (re-enable normal behavior)
+ * Note: automation_disable actually RE-ENABLES normal proximity sensor automation
+ */
+async function enableProximitySensor() {
+    await execCommand('adb', ['shell', 'am', 'broadcast', '-a', 'com.oculus.vrpowermanager.automation_disable']);
+}
+/**
+ * Wake the Quest screen
+ */
+async function wakeScreen() {
+    await execCommand('adb', ['shell', 'input', 'keyevent', 'KEYCODE_WAKEUP']);
+}
+/**
+ * Child watchdog process - polls for parent death and cleans up
+ */
+export async function stayAwakeWatchdog(parentPid, originalTimeout) {
+    const pollInterval = 5000; // Check every 5 seconds
+    const checkParent = setInterval(() => {
+        try {
+            // Check if parent process still exists
+            process.kill(parentPid, 0);
+            // Parent still alive, continue polling
+        }
+        catch {
+            // Parent is dead - perform cleanup
+            console.log('Parent process died, restoring Quest settings...');
+            clearInterval(checkParent);
+            // Restore settings synchronously
+            try {
+                execSync(`adb shell settings put system screen_off_timeout ${originalTimeout}`, { stdio: 'ignore' });
+                execSync(`adb shell am broadcast -a com.oculus.vrpowermanager.automation_disable`, { stdio: 'ignore' });
+                // Cleanup PID file
+                const pidFile = `${os.homedir()}/.quest-dev-stay-awake.pid`;
+                try {
+                    fs.unlinkSync(pidFile);
+                }
+                catch { }
+                console.log(`Screen timeout restored to ${originalTimeout}ms (${Math.round(originalTimeout / 1000)}s)`);
+                console.log('Proximity sensor re-enabled');
+            }
+            catch (err) {
+                console.error('Failed to restore settings:', err.message);
+            }
+            process.exit(0);
+        }
+    }, pollInterval);
+}
+/**
+ * Main stay-awake command handler
+ */
+export async function stayAwakeCommand(idleTimeout = 300000) {
+    // Check prerequisites
+    checkADBPath();
+    // Check devices without verbose output
+    try {
+        const output = await execCommand('adb', ['devices']);
+        const lines = output.trim().split('\n').slice(1);
+        const devices = lines.filter(line => line.trim() && !line.includes('List of devices'));
+        if (devices.length === 0) {
+            console.error('Error: No ADB devices connected');
+            process.exit(1);
+        }
+    }
+    catch (error) {
+        console.error('Error: Failed to list ADB devices');
+        process.exit(1);
+    }
+    // PID file management
+    const pidFilePath = `${os.homedir()}/.quest-dev-stay-awake.pid`;
+    // Check for existing process
+    if (fs.existsSync(pidFilePath)) {
+        const existingPid = parseInt(fs.readFileSync(pidFilePath, 'utf-8'));
+        try {
+            process.kill(existingPid, 0); // Test if process exists
+            console.error(`Error: stay-awake is already running (PID: ${existingPid})`);
+            process.exit(1);
+        }
+        catch {
+            // Process dead, cleanup stale PID file
+            fs.unlinkSync(pidFilePath);
+        }
+    }
+    // Get original timeout
+    let originalTimeout;
+    try {
+        originalTimeout = await getScreenTimeout();
+        console.log(`Original screen timeout: ${originalTimeout}ms (${Math.round(originalTimeout / 1000)}s)`);
+    }
+    catch (error) {
+        console.error('Failed to get current screen timeout');
+        process.exit(1);
+    }
+    // Write PID file
+    try {
+        fs.writeFileSync(pidFilePath, process.pid.toString());
+    }
+    catch (error) {
+        console.warn('Failed to write PID file, hook will not work');
+    }
+    // Spawn child watchdog process
+    let childProcess = null;
+    try {
+        childProcess = spawn(process.execPath, [
+            process.argv[1], // quest-dev script path
+            'stay-awake-watchdog',
+            '--parent-pid', process.pid.toString(),
+            '--original-timeout', originalTimeout.toString()
+        ], {
+            detached: true,
+            stdio: 'ignore'
+        });
+        childProcess.unref(); // Allow parent to exit without waiting for child
+    }
+    catch (error) {
+        console.warn('Failed to spawn watchdog child process');
+    }
+    // Wake screen and disable proximity sensor
+    try {
+        await wakeScreen();
+        console.log('Quest screen woken up');
+        await disableProximitySensor();
+        console.log('Proximity sensor disabled');
+    }
+    catch (error) {
+        console.error('Failed to wake screen or disable proximity sensor:', error.message);
+    }
+    // Set timeout to 24 hours (86400000ms)
+    const longTimeout = 86400000;
+    try {
+        await setScreenTimeout(longTimeout);
+        console.log(`Screen timeout set to 24 hours`);
+        console.log(`Quest will stay awake (idle timeout: ${Math.round(idleTimeout / 1000)}s). Press Ctrl-C to restore original settings.`);
+    }
+    catch (error) {
+        console.error('Failed to set screen timeout');
+        process.exit(1);
+    }
+    // Idle timer mechanism
+    let idleTimerHandle = null;
+    let cleanupInProgress = false;
+    const resetIdleTimer = () => {
+        if (idleTimerHandle)
+            clearTimeout(idleTimerHandle);
+        idleTimerHandle = setTimeout(() => {
+            console.log('\nIdle timeout reached, exiting...');
+            cleanup();
+        }, idleTimeout);
+    };
+    // Set up cleanup on exit (must be synchronous for signal handlers)
+    const cleanup = () => {
+        if (cleanupInProgress)
+            return; // Guard against double-cleanup
+        cleanupInProgress = true;
+        // Clear idle timer
+        if (idleTimerHandle)
+            clearTimeout(idleTimerHandle);
+        // Kill child watchdog
+        if (childProcess) {
+            try {
+                childProcess.kill();
+            }
+            catch { }
+        }
+        console.log('\nRestoring original settings...');
+        try {
+            // Remove PID file
+            try {
+                fs.unlinkSync(pidFilePath);
+            }
+            catch { }
+            // Restore Quest settings
+            execSync(`adb shell settings put system screen_off_timeout ${originalTimeout}`, { stdio: 'ignore' });
+            execSync(`adb shell am broadcast -a com.oculus.vrpowermanager.automation_disable`, { stdio: 'ignore' });
+            console.log(`Screen timeout restored to ${originalTimeout}ms (${Math.round(originalTimeout / 1000)}s)`);
+            console.log(`Proximity sensor re-enabled`);
+        }
+        catch (error) {
+            console.error('Failed to restore settings:', error.message);
+        }
+        process.exit(0);
+    };
+    // Handle Ctrl-C and termination
+    process.on('SIGINT', cleanup);
+    process.on('SIGTERM', cleanup);
+    process.on('SIGHUP', cleanup);
+    // Handle SIGUSR1 for activity reset
+    process.on('SIGUSR1', () => {
+        console.log('Activity detected, resetting idle timer');
+        resetIdleTimer();
+    });
+    // Start idle timer
+    resetIdleTimer();
+    // Keep process running with an interval that does nothing
+    console.log('Keeping Quest awake...');
+    setInterval(() => {
+        // Do nothing, just keep process alive
+    }, 60000); // Check every minute
+    // Prevent process from exiting
+    await new Promise((resolve) => {
+        // This will only resolve when cleanup is called
+        process.on('exit', () => resolve());
+    });
+}
+//# sourceMappingURL=stay-awake.js.map

package/build/commands/stay-awake.js.map

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

package/build/index.js

@@ -10,6 +10,9 @@ import { fileURLToPath } from 'url';
 import { dirname, join } from 'path';
 import { screenshotCommand } from './commands/screenshot.js';
 import { openCommand } from './commands/open.js';
+import { startCommand, stopCommand, statusCommand, tailCommand } from './commands/logcat.js';
+import { batteryCommand } from './commands/battery.js';
+import { stayAwakeCommand, stayAwakeWatchdog } from './commands/stay-awake.js';
 // Read version from package.json
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const packageJson = JSON.parse(readFileSync(join(__dirname, '../package.json'), 'utf-8'));
@@ -35,14 +38,20 @@ const cli = yargs(hideBin(process.argv))
     .alias('help', 'h')
     .epilog('Requires ADB and Quest connected via USB. Sets up CDP on port 9223 for cdp-cli.');
 // Screenshot command
-cli.command('screenshot <output>', 'Take a screenshot from Quest and save to local file', (yargs) => {
-    return yargs.positional('output', {
-        describe: 'Output file path (e.g., ~/screenshots/test.jpg)',
+cli.command('screenshot <directory>', 'Take a screenshot from Quest and save to directory with auto-generated filename', (yargs) => {
+    return yargs
+        .positional('directory', {
+        describe: 'Output directory path (e.g., ~/screenshots)',
         type: 'string',
         demandOption: true
+    })
+        .option('caption', {
+        describe: 'Caption to embed in JPEG COM metadata',
+        type: 'string',
+        alias: 'c'
     });
 }, async (argv) => {
-    await screenshotCommand(argv.output);
+    await screenshotCommand(argv.directory, argv.caption);
 });
 // Open command
 cli.command('open <url>', 'Open URL in Quest browser (sets up CDP debugging port forwarding)', (yargs) => {
@@ -56,9 +65,79 @@ cli.command('open <url>', 'Open URL in Quest browser (sets up CDP debugging port
         describe: 'Close all other tabs before opening',
         type: 'boolean',
         default: false
+    })
+        .option('browser', {
+        describe: 'Browser package name (e.g., com.oculus.browser, org.chromium.chrome)',
+        type: 'string',
+        default: 'com.oculus.browser',
+        alias: 'b'
+    });
+}, async (argv) => {
+    await openCommand(argv.url, argv.closeOthers, argv.browser);
+});
+// Logcat command
+cli.command('logcat <action>', 'Capture Android logcat to files (CRITICAL: always start before testing to avoid losing crash logs)', (yargs) => {
+    return yargs
+        .positional('action', {
+        describe: 'Action to perform',
+        type: 'string',
+        choices: ['start', 'stop', 'status', 'tail'],
+        demandOption: true
+    })
+        .option('filter', {
+        describe: 'Logcat filter expression (e.g., "*:W" for warnings+, "chromium:V *:S" for chromium only)',
+        type: 'string'
+    });
+}, async (argv) => {
+    const action = argv.action;
+    const filter = argv.filter;
+    switch (action) {
+        case 'start':
+            await startCommand(filter);
+            break;
+        case 'stop':
+            await stopCommand();
+            break;
+        case 'status':
+            await statusCommand();
+            break;
+        case 'tail':
+            await tailCommand();
+            break;
+        default:
+            console.error(`Unknown action: ${action}`);
+            process.exit(1);
+    }
+});
+// Battery command
+cli.command('battery', 'Show Quest battery percentage and charging status', () => { }, async () => {
+    await batteryCommand();
+});
+// Stay-awake command
+cli.command('stay-awake', 'Keep Quest screen awake (sets 24hr timeout, restores on Ctrl-C)', (yargs) => {
+    return yargs.option('idle-timeout', {
+        describe: 'Idle timeout in milliseconds (default: 300000 = 5 minutes)',
+        type: 'number',
+        default: 300000,
+        alias: 'i'
+    });
+}, async (argv) => {
+    await stayAwakeCommand(argv.idleTimeout);
+});
+// Stay-awake watchdog (internal subcommand, spawned by stay-awake parent)
+cli.command('stay-awake-watchdog', false, // Hide from help
+(yargs) => {
+    return yargs
+        .option('parent-pid', {
+        type: 'number',
+        demandOption: true
+    })
+        .option('original-timeout', {
+        type: 'number',
+        demandOption: true
     });
 }, async (argv) => {
-    await openCommand(argv.url, argv.closeOthers);
+    await stayAwakeWatchdog(argv.parentPid, argv.originalTimeout);
 });
 // Parse and execute
 cli.parse();

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;GAGG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,iCAAiC;AACjC,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC1D,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAC5B,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,iBAAiB,CAAC,EAAE,OAAO,CAAC,CAC1D,CAAC;AACF,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC;AAEpC,aAAa;AACb,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;KACrC,UAAU,CAAC,WAAW,CAAC;KACvB,OAAO,CAAC,OAAO,CAAC;KAChB,KAAK,CAAC,+BAA+B,CAAC;KACtC,aAAa,CAAC,CAAC,EAAE,4BAA4B,CAAC;KAC9C,MAAM,EAAE;KACR,IAAI,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE;IACxB,IAAI,GAAG,EAAE,CAAC;QACR,OAAO,CAAC,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IACnC,CAAC;IACD,IAAI,GAAG,EAAE,CAAC;QACR,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IACD,OAAO,CAAC,KAAK,CAAC,+CAA+C,CAAC,CAAC;IAC/D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC;KACD,IAAI,EAAE;KACN,KAAK,CAAC,MAAM,EAAE,GAAG,CAAC;KAClB,MAAM,CAAC,iFAAiF,CAAC,CAAC;AAE7F,qBAAqB;AACrB,GAAG,CAAC,OAAO,CACT,qBAAqB,EACrB,qDAAqD,EACrD,CAAC,KAAK,EAAE,EAAE;IACR,OAAO,KAAK,CAAC,UAAU,CAAC,QAAQ,EAAE;QAChC,QAAQ,EAAE,iDAAiD;QAC3D,IAAI,EAAE,QAAQ;QACd,YAAY,EAAE,IAAI;KACnB,CAAC,CAAC;AACL,CAAC,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;IACb,MAAM,iBAAiB,CAAC,IAAI,CAAC,MAAgB,CAAC,CAAC;AACjD,CAAC,CACF,CAAC;AAEF,eAAe;AACf,GAAG,CAAC,OAAO,CACT,YAAY,EACZ,mEAAmE,EACnE,CAAC,KAAK,EAAE,EAAE;IACR,OAAO,KAAK;SACT,UAAU,CAAC,KAAK,EAAE;QACjB,QAAQ,EAAE,2EAA2E;QACrF,IAAI,EAAE,QAAQ;QACd,YAAY,EAAE,IAAI;KACnB,CAAC;SACD,MAAM,CAAC,cAAc,EAAE;QACtB,QAAQ,EAAE,qCAAqC;QAC/C,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,KAAK;KACf,CAAC,CAAC;AACP,CAAC,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;IACb,MAAM,WAAW,CAAC,IAAI,CAAC,GAAa,EAAE,IAAI,CAAC,WAAsB,CAAC,CAAC;AACrE,CAAC,CACF,CAAC;AAEF,oBAAoB;AACpB,GAAG,CAAC,KAAK,EAAE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/build/utils/adb.d.ts

@@ -16,23 +16,23 @@ export declare function isPortListening(port: number): Promise<boolean>;
 /**
  * Idempotently set up ADB port forwarding for a given port
  */
-export declare function ensurePortForwarding(port: number): Promise<void>;
+export declare function ensurePortForwarding(port: number, browser?: string): Promise<void>;
 /**
- * Check if Quest browser is running
+ * Check if browser is running
  */
-export declare function isBrowserRunning(): Promise<boolean>;
+export declare function isBrowserRunning(browser?: string): Promise<boolean>;
 /**
- * Launch Quest browser with a URL using am start
+ * Launch browser with a URL using am start
  */
-export declare function launchBrowser(url: string): Promise<boolean>;
+export declare function launchBrowser(url: string, browser?: string): Promise<boolean>;
 /**
  * Get CDP port
  */
-export declare function getCDPPort(): number;
+export declare function getCDPPort(browser?: string): Promise<number>;
 /**
  * Set up only CDP forwarding (for external URLs that don't need reverse forwarding)
  */
-export declare function ensureCDPForwarding(): Promise<void>;
+export declare function ensureCDPForwarding(browser?: string): Promise<void>;
 /**
  * Check if USB file transfer is authorized on Quest
  * After reboot, user must click notification to allow file access
@@ -43,4 +43,9 @@ export declare function checkUSBFileTransfer(): Promise<void>;
  * Screenshots cannot be taken when the display is off
  */
 export declare function checkQuestAwake(): Promise<void>;
+/**
+ * Get Quest battery status
+ * Returns percentage and charging state in one line
+ */
+export declare function getBatteryStatus(): Promise<string>;
 //# sourceMappingURL=adb.d.ts.map

package/build/utils/adb.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adb.d.ts","sourceRoot":"","sources":["../../src/utils/adb.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAkBrC;AAoBD;;GAEG;AACH,wBAAsB,eAAe,CAAC,UAAU,SAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAqCtE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAiB9D;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA0CtE;AAED;;GAEG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,OAAO,CAAC,CAOzD;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAmBjE;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED;;GAEG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CA8BzD;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC,CAe1D;AAED;;;GAGG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAUrD"}
+{"version":3,"file":"adb.d.ts","sourceRoot":"","sources":["../../src/utils/adb.ts"],"names":[],"mappings":"AAAA;;GAEG;AAiEH;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAiBrC;AAoBD;;GAEG;AACH,wBAAsB,eAAe,CAAC,UAAU,SAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAqCtE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAiB9D;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,MAA6B,GACrC,OAAO,CAAC,IAAI,CAAC,CA8Cf;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,GAAE,MAA6B,GAAG,OAAO,CAAC,OAAO,CAAC,CAO/F;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,MAA6B,GAAG,OAAO,CAAC,OAAO,CAAC,CAmBzG;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,OAAO,GAAE,MAA6B,GAAG,OAAO,CAAC,MAAM,CAAC,CAGxF;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,GAAE,MAA6B,GACrC,OAAO,CAAC,IAAI,CAAC,CAkCf;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC,CAe1D;AAED;;;GAGG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAUrD;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC,CAyCxD"}