-
Notifications
You must be signed in to change notification settings - Fork 0
Atajos y Macros
Dos formas de que un botón escriba en el teclado: enviar una combinación o reproducir una secuencia grabada.
| Atajo | Acción |
|---|---|
Ctrl+K |
Buscar cualquier botón |
Ctrl+Z |
Deshacer el último cambio |
1 … 8
|
Ir a la página N |
Esc |
Cerrar lo que esté abierto: búsqueda, editor, pantalla completa |
Ctrl+clic |
Seleccionar varios botones |
Ctrl+V |
Con el editor abierto: pegar una imagen del portapapeles como fondo |
La acción Atajo de teclado manda una combinación a la ventana que esté en
primer plano. Se escribe como se lee: Ctrl+C, Alt+Tab, Ctrl+Shift+Esc,
Win+D.
VirtualDeck quita el foco de su propia ventana antes de enviarla, para que llegue a la aplicación con la que se estaba trabajando y no a sí mismo.
En el paso Configurar de cualquier botón, la sección DISPARADORES
EXTERNOS permite asignarle una combinación del sistema, por ejemplo
Ctrl+Alt+1. Funciona esté VirtualDeck a la vista o escondido en la bandeja.
En esa misma sección, mostrar en el menú de la bandeja añade el botón al menú del icono de la bandeja, como acción rápida.
Un botón disparado por cualquiera de estas dos vías hace exactamente lo mismo que si se pulsara con el ratón: respeta el interruptor, el grupo, la secuencia de acciones y las variables.
Cualquier cosa que sepa abrir una URL puede pulsar un botón del deck: un acceso
directo del escritorio, una tarea programada de Windows, un archivo .bat, o
incluso otra aplicación.
| Enlace | Qué hace |
|---|---|
virtualdeck://press/<id> |
Pulsa el botón con ese identificador |
virtualdeck://press?label=Spotify |
Pulsa el primer botón con esa etiqueta |
virtualdeck://page/2 |
Cambia a la página 2 (la primera es la 1) |
virtualdeck://show |
Trae la ventana al frente |
La búsqueda por etiqueta no distingue mayúsculas ni acentos: musica
encuentra un botón llamado «Música».
Desde una consola o un .bat:
start "" "virtualdeck://press?label=Modo Streaming"Si VirtualDeck no estaba abierto, el enlace lo abre y después ejecuta la orden. Si ya lo estaba, la segunda copia se cierra sola y le pasa la orden a la que ya corría: nunca hay dos VirtualDeck a la vez.
Un botón disparado por enlace hace exactamente lo mismo que si se pulsara con el ratón.
Para lo que ya habla HTTP —Home Assistant, un script en otro equipo, otro panel— hay un servidor propio. Viene apagado: se activa en ⚙ → SERVIDOR LOCAL (HTTP), que también genera el token.
| Ruta | Qué hace |
|---|---|
GET /api/ping |
Comprueba que está vivo. No pide token |
GET /api/buttons |
Lista los botones con acción: id, etiqueta y página |
GET /api/press/<id> |
Pulsa ese botón |
GET /api/press?label=<etiqueta> |
Pulsa el primero con esa etiqueta |
GET /api/page/<n> |
Cambia de página |
El token va en la cabecera X-VD-Token, nunca en la dirección. No es un
capricho: cualquier página web que visite puede provocar una petición a
127.0.0.1 con solo poner una imagen, y si el token viajara en la URL bastaría
con acertarlo. Una cabecera propia obliga al navegador a pedir permiso antes, y
VirtualDeck no lo da.
curl -H "X-VD-Token: SU_TOKEN" http://127.0.0.1:8787/api/press/0-3El servidor sirve también una página pensada para el teléfono. Con PERMITIR LA RED LOCAL activado:
- En VirtualDeck, ⚙ → SERVIDOR LOCAL → EMPAREJAR TELÉFONO. Sale un código de seis cifras y la dirección que hay que escribir.
- En el teléfono, abra esa dirección (
http://<ip>:8787) y escriba el código. - La rejilla de botones aparece. Al tocar uno, el borde se enciende si el deck lo ejecutó y se pone rojo si algo falló.
El emparejamiento no manda el token en ningún enlace: el teléfono escribe una dirección corta y el código cruza una vez. Un enlace con el token dentro habría quedado en el historial del navegador y en cualquier captura de pantalla. El código dura cinco minutos, admite cinco intentos y se gasta al acertar.
Para desemparejar un teléfono: NUEVO TOKEN en los ajustes. Cualquier teléfono emparejado vuelve a pedir código la próxima vez.
Con PERMITIR LA RED LOCAL desactivado, el servidor solo responde a este equipo. Activado, responde a cualquiera de su red que tenga el token.
Conviene saber exactamente qué significa eso: la conexión no va cifrada y un botón puede ejecutar scripts. Es adecuado para una red doméstica; no lo es para una red compartida o pública.
Una macro es una lista de pasos: teclas, clics, movimientos del ratón, rueda y pausas.
El botón GRABAR del editor captura el teclado y el ratón de todo el sistema hasta que se pulsa DETENER.
- Los modificadores se graban con la tecla: pulsar
Ctrl+Cdeja un solo paso,Ctrl+C, no dos. - Los clics sobre la ventana de VirtualDeck no se graban. Son los del grabador, no los de la macro. Por eso, si solo se hace clic aquí dentro, la grabación sale vacía y lo dice.
- Las pausas entre pulsaciones se conservan tal como se hicieron.
Cada paso se puede editar, reordenar y borrar. Los tipos son:
| Paso | Qué hace |
|---|---|
| Tecla | Una tecla suelta: a, 5, {ENTER}, {F5}
|
| Combinación | Con modificadores: Ctrl+C, Alt+Tab
|
| Texto | Escribe una cadena entera |
| Clic ratón | En unas coordenadas de pantalla, con botón izquierdo, derecho o central |
| Mover ratón | Lleva el cursor a unas coordenadas |
| Scroll | Rueda arriba o abajo |
| Pausa | Espera los milisegundos indicados |
Las teclas con nombre van entre llaves: {ENTER}, {TAB}, {ESC},
{BACKSPACE}, {DELETE}, {UP}, {DOWN}, {LEFT}, {RIGHT}, {HOME},
{END}, {PGUP}, {PGDN} y {F1} a {F24}.
El campo repetir ejecuta la macro entera N veces seguidas.
- Una combinación que ya existe en otro programa → Atajo de teclado.
- Una secuencia de varios pasos, con esperas o con el ratón → Macro.
- Lanzar algo que no es teclado (un programa, una web, un script) → la acción correspondiente; ver Acciones.