obs-scene-capture

Capture PNG stills from OBS scenes or sources via obs-websocket protocol.

Updated Mar 8, 2026
One-click install
npx skills add https://github.com/helix4u/hermes-agent-private --skill obs-scene-capture
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obs-scene-capture
Source: https://github.com/helix4u/hermes-agent-private/tree/main/skills/integrations/obs-scene-capture
Command: npx skills add https://github.com/helix4u/hermes-agent-private --skill obs-scene-capture

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires obsws-python, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill allows you to treat OBS (Open Broadcaster Software) as a local screenshot API, enabling the capture of still images from your configured scenes or individual sources.

Core Features & Use Cases

  • Scene Listing: Discover all available scenes within OBS.
  • Source Inspection: List the sources within a specific OBS scene.
  • Image Capture: Capture PNG stills from scenes or sources.
  • Automated Workflows: Save captured images to a specified directory for further processing or sharing.
  • Use Case: Automatically capture a screenshot of your "Main Monitor" scene in OBS and save it to a temporary directory for inclusion in a report.

Quick Start

List all scenes available in OBS by running the following command.

Frequently Asked Questions about obs-scene-capture

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I capture a screenshot of an OBS scene programmatically?

You can capture OBS scene screenshots programmatically by using the obs-websocket protocol to request PNG stills from your configured scenes. This Skill sends capture commands directly to the running OBS instance.

Can I capture images from individual sources within an OBS scene?

Yes, you can capture images from individual sources within an OBS scene. The Skill supports source inspection, allowing you to list elements in a scene and capture PNG stills from specific sources.

Do I need the WebSocket server enabled to capture OBS scene images?

Yes, you need the WebSocket server enabled in a running OBS instance. The Skill relies on the obsws-python library to communicate with OBS via the obs-websocket protocol for all capture operations.

What is the best way to automate saving OBS screenshots to a directory?

The best way to automate saving OBS screenshots is to use this Skill to capture scene stills and specify a target directory. It enables automated workflows that save PNG images for further processing or reporting.

How do I list all available scenes in OBS for image capture?

You can list all available scenes in OBS using the scene listing feature. This allows you to discover configured scenes programmatically before selecting one for image capture.

Does this approach work for capturing live streaming scenes as still images?

Yes, this approach works for capturing live streaming scenes as still images. It treats OBS as a local screenshot API, enabling you to grab PNG stills from live scenes during an active broadcast.