jva-capture 0.1.0

Screen recording interface for JVA01-Capture device using ffmpeg

jva-capture

Screen recording interface for the JVA01-Capture device using ffmpeg on macOS.

Installation

pip install jva-capture

Or with uv:

uv add jva-capture

ffmpeg must be installed separately:

brew install ffmpeg

Usage

from jva_capture import JVACapture

# Basic usage
capture = JVACapture("output.mkv")
capture.start()
# ... run your experiment ...
capture.stop()

# As context manager
with JVACapture("output.mkv") as capture:
    # ... run your experiment ...
    pass

Parameters

Parameter	Default	Description
output_path	(required)	Path where video file will be saved
device_name	"JVA01-Capture"	Name of the AVFoundation capture device
framerate	60	Recording framerate (fps)
preset	"medium"	ffmpeg encoding preset (ultrafast, fast, medium, slow)

Requirements

• macOS (uses AVFoundation)
• Python >= 3.11
• ffmpeg installed and available in PATH
• JVA01-Capture device connected

License

MIT