Mastering the CaptureGem CLI

While the CaptureGem UI is great for casual use, power users often need more control. The Command-Line Interface (CLI) allows you to automate recordings, switch profiles via scripts, and run the app on headless Linux servers.

1. Getting Started

The CaptureGem binary can be called directly from your terminal. On Windows, locate `CaptureGem.exe`. On Linux/macOS, ensure the binary is in your `$PATH`.

# Basic version check
capturegem --version

2. Headless Background Execution

For 24/7 recording servers, running without a GUI is essential. Use the `--headless` flag to start CaptureGem as a background process.

capturegem --headless --config ./config.json

3. Profile & Config Switching

You can maintain different configurations for different types of recording (e.g., 4K specific vs. mass archiving) and switch between them instantly.

# Start with a specific high-quality profile
capturegem --config profiles/4k-optimized.json

# Start with a low-bandwidth proxy profile
capturegem --config profiles/proxy-only.json

4. Automation Scripting

Integrate CaptureGem into your workflow with simple scripts.

Bash Example (Linux/macOS)

#!/bin/bash
# Check if CaptureGem is already running
if ! pgrep -x "capturegem" > /dev/null
then
    echo "Starting CaptureGem in headless mode..."
    capturegem --headless --config /etc/capturegem/default.json &
fi

PowerShell Example (Windows)

# Auto-restart if the process crashes
while ($true) {
    if (!(Get-Process "CaptureGem" -ErrorAction SilentlyContinue)) {
        Write-Host "Restarting CaptureGem..."
        Start-Process "C:\Apps\CaptureGem.exe" -ArgumentList "--headless"
    }
    Start-Sleep -Seconds 60
}

5. CLI Argument Reference