Referencia CLI de OverRec
OverRec incluye un modo CLI sin interfaz gráfica para scripting y automatización.
OverRec.exe cli <comando> [opciones]monitors — Listar pantallas
OverRec.exe cli monitors [--all]Sin --all, imprime una lista compacta de ID/resolución.
Con --all, imprime detalles completos: resolución, posición absoluta, factor de escala, frecuencia de actualización, rotación y si es la pantalla principal.
Ejemplo de salida (--all):
ID Resolution Abs Position Scale Hz Rot Primary
0 1920x1080 (0, 0) 1 60 0° yes
1 2560x1440 (1920, 0) 1 144 0°window — Encontrar una ventana por palabra clave del título
OverRec.exe cli window [--all] [<palabra clave...>]Lista todas las ventanas visibles cuyo título contiene todas las palabras clave dadas (sin distinción de mayúsculas). El WindowID impreso se usa con el comando snap.
Sin --all, imprime una lista compacta de ID/título.
Con --all, también muestra el número de monitor, la ubicación y el tamaño. La ubicación muestra max o min en lugar de coordenadas para ventanas maximizadas/minimizadas.
Ejemplos:
OverRec.exe cli window chrome
OverRec.exe cli window visual studio
OverRec.exe cli window --all noteEjemplo de salida (por defecto):
WindowID Title
------------------------------------------------------------
657846 Google Chrome
329812 Visual Studio CodeEjemplo de salida (--all):
WindowID Mon Location Size Title
--------------------------------------------------------------------------------
657846 0 0,0 1920x1080 Google Chrome
329812 0 max 1920x1080 Visual Studio Code
131070 1 1920,0 1280x720 NotepadConsejo: ejecuta
OverRec.exe cli windowsin palabras clave para listar todas las ventanas visibles.
snap — Mover y redimensionar una ventana
OverRec.exe cli snap --windowid ID --location X,Y --size WxH [--monitor ID]Mueve y redimensiona la ventana identificada por --windowid a la posición y tamaño dados. Los márgenes de sombra DWM se corrigen automáticamente para que el marco visible quede exactamente en las coordenadas solicitadas.
| Opción | Descripción |
|---|---|
--windowid ID | Identificador de ventana de OverRec.exe cli window |
--location X,Y | Esquina superior izquierda en píxeles |
--size WxH | Ancho × Alto en píxeles |
--monitor ID | Opcional. Desplaza --location relativo al origen superior izquierdo de ese monitor |
Ejemplos:
# Ajustar a coordenadas absolutas de pantalla
OverRec.exe cli snap --windowid 657846 --location 0,0 --size 1920x1080
# Ajustar al cuarto superior izquierdo del monitor 1
OverRec.exe cli snap --windowid 657846 --location 0,0 --size 1280x720 --monitor 1draw — Mostrar un rectángulo superpuesto
OverRec.exe cli draw --location X,Y --size WxH [--color COLOR] [--timeout SECS] [--monitor ID] [--grid SIZE] [--grid-line dotted|dashed|solid]Abre una superposición transparente a pantalla completa y dibuja un rectángulo. Permanece visible hasta que se cierra la ventana o transcurre el tiempo límite.
| Opción | Descripción |
|---|---|
--location X,Y | Esquina superior izquierda relativa al monitor |
--size WxH | Ancho × Alto en píxeles |
--color COLOR | Color del borde: red, green, blue, yellow, white, black, o #RRGGBB (por defecto: blue) |
--timeout SECS | Cierre automático tras N segundos |
--monitor ID | Monitor donde dibujar (por defecto: 0) |
--grid SIZE | Superpone una cuadrícula de medición etiquetada con celdas de SIZE píxeles (mínimo 10) |
--grid-line ESTILO | Estilo de las líneas: dotted (punteado, por defecto), dashed (discontinuo) o solid (sólido) |
Ejemplos:
OverRec.exe cli draw --location 100,100 --size 800x600
OverRec.exe cli draw --location 0,0 --size 1920x1080 --color "#FF4400" --timeout 3
OverRec.exe cli draw --location 200,200 --size 400x300 --monitor 1
OverRec.exe cli draw --location 256,211 --size 955x692 --grid 200 --color red
OverRec.exe cli draw --location 0,0 --size 1920x1080 --grid 100 --grid-line solidscreenshot — Capturar una región a archivo o portapapeles
OverRec.exe cli screenshot --location X,Y --size WxH [--output path.png] [--no-clipboard] [--monitor ID]Captura la región de pantalla especificada. Por defecto la imagen se copia al portapapeles; usa --output para guardar en un archivo en su lugar (o además).
| Opción | Descripción |
|---|---|
--location X,Y | Esquina superior izquierda relativa al monitor |
--size WxH | Ancho × Alto en píxeles |
--output path.png | Guardar en archivo (debe terminar en .png) |
--no-clipboard | No copiar al portapapeles |
--monitor ID | Monitor del que capturar (por defecto: 0) |
Ejemplos:
# Copiar al portapapeles
OverRec.exe cli screenshot --location 0,0 --size 1920x1080
# Guardar solo en archivo
OverRec.exe cli screenshot --location 100,200 --size 800x600 --output capture.png --no-clipboard
# Guardar y copiar
OverRec.exe cli screenshot --location 0,0 --size 1280x720 --output shot.pngrecord — Grabar una región a GIF o MP4
OverRec.exe cli record --location X,Y --size WxH --output file.gif|file.mp4 --timeout SECS [--fps N] [--monitor ID] [--ffmpeg PATH] [--async]Graba la región de pantalla especificada en un GIF animado o un MP4 H.264. Por defecto el comando espera hasta que expira el tiempo y el archivo se finaliza; usa --async para iniciar un proceso en segundo plano y volver de inmediato.
La codificación GIF está integrada. MP4 requiere FFmpeg (ffmpeg en el PATH por defecto, o --ffmpeg PATH). En Windows, la captura MP4 usa Desktop Duplication y la región debe caber dentro de un único monitor sin rotación.
| Opción | Descripción |
|---|---|
--location X,Y | Esquina superior izquierda relativa al monitor |
--size WxH | Ancho × Alto en píxeles |
--output FILE | Ruta de salida terminada en .gif o .mp4 |
--timeout SECS | Obligatorio. Detener y finalizar tras N segundos |
--fps N | Fotogramas por segundo de 1 a 240 (por defecto: 10) |
--monitor ID | Monitor cuya esquina superior izquierda se usa como origen |
--ffmpeg PATH | Solo MP4. Ruta del ejecutable de FFmpeg |
--async | Grabar en un proceso en segundo plano y volver de inmediato |
Ejemplos:
# Grabar una región a GIF durante 10 segundos
OverRec.exe cli record --location 0,0 --size 1280x720 --output demo.gif --timeout 10
# Grabar a MP4 H.264 a 30 fps
OverRec.exe cli record --location 0,0 --size 1920x1080 --output demo.mp4 --timeout 15 --fps 30
# Iniciar una grabación en segundo plano y volver de inmediato
OverRec.exe cli record --location 0,0 --size 1280x720 --output demo.mp4 --timeout 20 --fps 30 --asyncmcp — Ejecutar un servidor MCP
OverRec.exe cli mcp [--host ADDR] [--port PORT] [--stdio]Inicia un servidor Model Context Protocol que expone cada comando de la CLI como una herramienta, para que agentes de IA (Claude Code, Claude Desktop y otros) puedan capturar pantallas, dibujar superposiciones, grabar la pantalla y ajustar ventanas directamente.
| Opción | Descripción |
|---|---|
--host ADDR | Solo HTTP. Dirección de enlace (por defecto: 127.0.0.1) |
--port PORT | Solo HTTP. Puerto TCP (por defecto: 7820) |
--stdio | Usar el transporte stdio en lugar de HTTP |
Hay dos transportes disponibles: HTTP transmisible (por defecto) en POST http://HOST:PORT/mcp, y stdio (--stdio) para clientes que lanzan el servidor como proceso hijo.
Registrar con Claude Code:
# HTTP — inicia el servidor y luego añádelo
OverRec.exe cli mcp
claude mcp add --transport http overrec http://127.0.0.1:7820/mcp
# stdio — Claude Code lanza y gestiona el proceso
claude mcp add overrec -- OverRec.exe cli mcp --stdioFlujo de trabajo típico
# 1. Encuentra tus monitores
OverRec.exe cli monitors --all
# 2. Encuentra la ventana que quieres ajustar
OverRec.exe cli window chrome
# 3. Ajústala a la mitad izquierda del monitor 0
OverRec.exe cli snap --windowid 657846 --location 0,0 --size 960x1080
# 4. Opcionalmente dibuja un rectángulo de referencia para verificar el área
OverRec.exe cli draw --location 0,0 --size 960x1080 --timeout 2
# 5. Toma una captura de pantalla de esa área
OverRec.exe cli screenshot --location 0,0 --size 960x1080 --output left-half.png