Cross-platform capture backends (x11grab / avfoundation)
Los mantenedores suelen responder en 1 día
Nadie ha tomado este issue todavía.
Evaluación
- Dificultad
- 5/5
- Tiempo estimado
- Más de una semana
- Aptitud para principiantes
- 30/100
- Tipo de issue
- Nueva funcionalidad
- Claridad
- Bastante claro
- Estado de actividad
- Tranquilo
- Stack tecnológico
- typescript
- Área
- desktop
Línea de trabajo
Start with src/utils/targets.ts and trace how buildCaptureArgs, buildScreenshotArgs, and targetInputArgs construct capture arguments; then read src/utils/monitors.ts, src/utils/windows.ts, and src/utils/resolveTarget.ts for target resolution. Begin with the Linux x11grab video scope and use the pure argument builders with an injected platform to test full, monitor, and region targets. Done means those targets build the specified Linux arguments, while unsupported non-Windows window and system-audio requests return clear errors.
Escrito por el modelo de indexación a partir del texto del issue.
Descripción
Problem
Capture is Windows-only. start_recording and screenshot hardcode -f gdigrab (src/utils/targets.ts: buildCaptureArgs / buildScreenshotArgs / targetInputArgs), and target resolution uses Windows APIs (src/utils/monitors.ts via PowerShell, src/utils/windows.ts for window bounds, wired in src/utils/resolveTarget.ts).
The watch, edit, redact, and produce tools already run anywhere ffmpeg does. Only capture is pinned to Windows.
Proposed backends
Selected by process.platform:
win32-> gdigrab (current).linux-> x11grab:-f x11grab -framerate N -video_size WxH -i $DISPLAY+X,Y. Native offset/region, mirrors gdigrab closely (lowest-risk first target).darwin-> avfoundation:-f avfoundation -framerate N -i "<screen-index>". No native offset, so aregion:needs-vf crop=w:h:x:yover a full-screen grab; needs screen-recording permission (TCC); the screen device index comes fromffmpeg -f avfoundation -list_devices true -i "".
Architecture sketch
- Add a host-platform helper (overridable via env for tests).
- Refactor
targetInputArgsinto a backend-awarecaptureInputArgs(target, platform, monitors)and thread aplatformoption throughbuildCaptureArgs/buildScreenshotArgs, so the pure builders stay unit-testable for all three platforms on any host. - Per-platform monitor enumeration: keep Windows (
getMonitors), add Linux viaxrandrand macOS via the avfoundation device list. window:targets and systemaudiostay Windows-only initially (they needxdotool/ BlackHole / pulse), with a clear error on other platforms.
Suggested sequencing
- Linux (x11grab) first; scope to video
full/monitor/region. - macOS (avfoundation) as a follow-up.
Testing reality
The pure arg-builders are fully unit-testable by injecting platform. Actual x11grab / avfoundation runtime can only be verified on those OSes, not from the Windows dev box.
Scope decisions (from planning)
- Video
full/monitor/regioncross-platform;window:+ system audio stay Windows-only initially.
Recorded from a planning session; not yet scheduled for implementation.
- Lenguaje dominante
- TypeScript
- Estrellas
- 1
- Forks
- 4
- Merge medio
- 14 h 8 min
- PR fusionados (30 d)
- 48
Preparar el entorno
- Sin Dockerfile ni archivo de Docker Compose
- Tiene una plantilla de pull request
- Leer la guía de contribución
Primeros pasos
- Lee el issue completo y luego la guía de contribución del proyecto.
- Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
- Haz un fork del repositorio y trabaja en una rama.
- Abre un pull request que haga referencia al número del issue.
Más de TMHSDigital/screencast-mcp
-
effort: small good first issue priority: medium testing
Dificultad 2/5 1-3 horas Aptitud para principiantes 84/100
TMHSDigital/screencast-mcp#351 ·
Los mantenedores suelen responder en 1 día
-
bug effort: small priority: medium
Dificultad 2/5 1-3 horas Aptitud para principiantes 82/100
TMHSDigital/screencast-mcp#344 ·
Los mantenedores suelen responder en 1 día
-
bug effort: small good first issue priority: medium
Dificultad 2/5 1-3 horas Aptitud para principiantes 82/100
TMHSDigital/screencast-mcp#343 ·
Los mantenedores suelen responder en 1 día
-
effort: medium help wanted priority: medium testing
Dificultad 3/5 1-2 días Aptitud para principiantes 76/100
TMHSDigital/screencast-mcp#350 ·
Los mantenedores suelen responder en 1 día
-
effort: medium priority: medium testing
Dificultad 4/5 1-2 días Aptitud para principiantes 70/100
TMHSDigital/screencast-mcp#349 ·
Los mantenedores suelen responder en 1 día
Todos los issues de TMHSDigital/screencast-mcp
Issues similares
-
clawsweeper:fix-shape-clear clawsweeper:queueable-fix clawsweeper:source-repro impact:ux-friction issue-rating: 🦞 diamond lobster no-stale P3
Dificultad 2/5 1-3 horas Aptitud para principiantes 82/100
openclaw/openclaw#200365 · 1 comentario · 1 reacción ·
Los mantenedores suelen responder en 1 día
-
area-templates triage:bot-seen triage:needs-human
Dificultad 2/5 1-3 horas Aptitud para principiantes 75/100
microsoft/aspire#22356 · 1 comentario ·
Los mantenedores suelen responder en 1 día
-
Archiving an agent that is not loaded keeps its old updatedAtPosiblemente ocupada @luoph la tomó hoy. Abierto
Dificultad 2/5 1-3 horas Aptitud para principiantes 68/100
Los mantenedores suelen responder en 1 día
-
content triage
Dificultad 1/5 Menos de una hora Aptitud para principiantes 88/100
Los mantenedores suelen responder en 1 día
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 76/100
Los mantenedores suelen responder en 1 día