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]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) |
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 1screenshot — 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.pngFlujo 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