What problem does it solve?
Running the Elodin Editor for visual testing or demo capture normally requires a physical display, which is unavailable on headless Linux GPU servers and CI machines. This Skill runs the editor inside Gamescope's headless compositor and captures screenshots or video through PipeWire and GStreamer.
Core Features & Use Cases
- Automated capture script: Uses
scripts/elodin_capture.sh to run preflight checks, select a GPU path, start Gamescope, record, validate output is non-blank, and clean up child processes.
- Manual capture workflow: Provides step-by-step Gamescope, gamescopectl screenshot, and GStreamer PipeWire recording commands for debugging capture infrastructure.
- Encoder selection and validation: Detects and validates hardware encoders (NVENC, VA-API) with a tested x264 software fallback, including blank-frame rejection.
- Use Case: Record a 10-second MP4 of the cube-sat simulation on a headless NVIDIA server by running the capture script with a custom port to avoid conflicts with a running editor.
Quick Start
Run the elodin capture script with a duration, output path, and a simulation example such as examples/cube-sat/main.py inside the nix develop shell.