recap-capture 0.1.0__tar.gz

recap_capture-0.1.0/PKG-INFO

@@ -0,0 +1,89 @@
+Metadata-Version: 2.4
+Name: recap-capture
+Version: 0.1.0
+Summary: Headless screen and audio capture library and CLI for Windows
+License: MIT
+Keywords: screen-capture,audio-capture,windows,wgc,wasapi,ffmpeg
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Multimedia :: Sound/Audio :: Capture/Recording
+Classifier: Topic :: Multimedia :: Video :: Capture
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: comtypes>=1.4
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
+
+# recap
+
+Headless screen and audio capture library and CLI for Windows.
+
+## Features
+
+- Record an entire monitor via Windows Graphics Capture (WGC)
+- Record a single window via WGC (real window capture, not desktop crop)
+- Record system audio via WASAPI loopback
+- Video-only, audio-only, or audio+video modes
+- CLI tool (`recap`) and importable Python library
+- Uses FFmpeg for encoding/muxing only
+
+## Installation
+
+```bash
+pip install -e .
+```
+
+FFmpeg must be available on PATH or specified via `--ffmpeg`.
+
+## CLI Usage
+
+```bash
+# Check environment
+recap doctor
+
+# List available capture targets
+recap monitors
+recap windows
+recap devices
+
+# Record primary monitor with audio
+recap record --output recording.mp4
+
+# Record a specific window
+recap record --window-title "Notepad" --output notepad.mp4
+
+# Record video only
+recap record --video-only --output silent.mp4
+
+# Record audio only
+recap record --audio-only --output audio.wav
+
+# Record for 30 seconds
+recap record --duration 30 --output clip.mp4
+```
+
+## Library Usage
+
+```python
+from recap import Recorder, RecordingConfig
+
+config = RecordingConfig(output="recording.mp4")
+recorder = Recorder(config)
+recorder.start()
+# ... do work ...
+recorder.stop()
+recorder.wait()
+```
+
+## License
+
+MIT

recap_capture-0.1.0/README.md

@@ -0,0 +1,64 @@
+# recap
+
+Headless screen and audio capture library and CLI for Windows.
+
+## Features
+
+- Record an entire monitor via Windows Graphics Capture (WGC)
+- Record a single window via WGC (real window capture, not desktop crop)
+- Record system audio via WASAPI loopback
+- Video-only, audio-only, or audio+video modes
+- CLI tool (`recap`) and importable Python library
+- Uses FFmpeg for encoding/muxing only
+
+## Installation
+
+```bash
+pip install -e .
+```
+
+FFmpeg must be available on PATH or specified via `--ffmpeg`.
+
+## CLI Usage
+
+```bash
+# Check environment
+recap doctor
+
+# List available capture targets
+recap monitors
+recap windows
+recap devices
+
+# Record primary monitor with audio
+recap record --output recording.mp4
+
+# Record a specific window
+recap record --window-title "Notepad" --output notepad.mp4
+
+# Record video only
+recap record --video-only --output silent.mp4
+
+# Record audio only
+recap record --audio-only --output audio.wav
+
+# Record for 30 seconds
+recap record --duration 30 --output clip.mp4
+```
+
+## Library Usage
+
+```python
+from recap import Recorder, RecordingConfig
+
+config = RecordingConfig(output="recording.mp4")
+recorder = Recorder(config)
+recorder.start()
+# ... do work ...
+recorder.stop()
+recorder.wait()
+```
+
+## License
+
+MIT

recap_capture-0.1.0/pyproject.toml

@@ -0,0 +1,39 @@
+[build-system]
+requires = ["setuptools>=68.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "recap-capture"
+version = "0.1.0"
+description = "Headless screen and audio capture library and CLI for Windows"
+readme = "README.md"
+license = {text = "MIT"}
+requires-python = ">=3.10"
+keywords = ["screen-capture", "audio-capture", "windows", "wgc", "wasapi", "ffmpeg"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: Microsoft :: Windows",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Multimedia :: Sound/Audio :: Capture/Recording",
+    "Topic :: Multimedia :: Video :: Capture",
+]
+
+dependencies = [
+    "comtypes>=1.4",
+]
+
+[project.scripts]
+recap = "recap.cli:main"
+
+[project.optional-dependencies]
+dev = ["pytest>=7.0", "pytest-cov"]
+
+[tool.setuptools.packages.find]
+include = ["recap*"]

recap_capture-0.1.0/recap/__init__.py

@@ -0,0 +1,76 @@
+"""recap – headless screen and audio capture for Windows.
+
+Public API
+----------
+.. autoclass:: RecordingConfig
+.. autoclass:: Recorder
+.. autofunction:: list_monitors
+.. autofunction:: list_windows
+.. autofunction:: list_audio_devices
+.. autofunction:: find_ffmpeg
+.. autofunction:: validate_environment
+"""
+
+from __future__ import annotations
+
+import ctypes
+import sys
+
+__version__ = "0.1.0"
+
+# Enable DPI awareness so Win32 APIs return physical pixel coordinates ------
+if sys.platform == "win32":
+    try:
+        ctypes.windll.shcore.SetProcessDpiAwareness(2)  # Per-Monitor v2
+    except (AttributeError, OSError):
+        ctypes.windll.user32.SetProcessDPIAware()
+
+# Re-export public surface --------------------------------------------------
+from recap.config import RecordingConfig
+from recap.discovery import (
+    AudioDeviceInfo,
+    MonitorInfo,
+    WindowInfo,
+    list_audio_devices,
+    list_monitors,
+    list_windows,
+)
+from recap.exceptions import (
+    AudioCaptureError,
+    CaptureError,
+    ConfigError,
+    FFmpegError,
+    FFmpegNotFoundError,
+    RecapError,
+    VideoCaptureError,
+)
+from recap.ffmpeg import find_ffmpeg, validate_environment
+from recap.recorder import Recorder, RecorderState
+
+__all__ = [
+    # Version
+    "__version__",
+    # Config
+    "RecordingConfig",
+    # Recorder
+    "Recorder",
+    "RecorderState",
+    # Discovery
+    "list_monitors",
+    "list_windows",
+    "list_audio_devices",
+    "MonitorInfo",
+    "WindowInfo",
+    "AudioDeviceInfo",
+    # FFmpeg
+    "find_ffmpeg",
+    "validate_environment",
+    # Exceptions
+    "RecapError",
+    "FFmpegNotFoundError",
+    "FFmpegError",
+    "CaptureError",
+    "AudioCaptureError",
+    "VideoCaptureError",
+    "ConfigError",
+]