Ir al contenido
inicio / kit / display
DisplayServicio Kit

Display

Un escritorio Linux completo transmitido a cualquier navegador. Inicia cualquier aplicación X11 —Firefox, VS Code, GIMP, LibreOffice— y accede a ella desde una URL. Impulsado por Xpra con aceleración de hardware H264. Sin cliente VNC, sin cliente RDP, sin aplicación de escritorio. Solo una pestaña del navegador.

display-1 — HoodyConectado · H264
https://proj-dev-display-1.hoody.com/?sharing=true&encoding=h264
Firefox
código — main.py

1 import requests

2

3 r = requests.get(

4 '.../screenshot'

5 )

6 with open('f.png', 'wb') as f:

7 f.write(r.content)

8 # 1920x1080 PNG

alice
bob
1920 × 1080 · 2 usuarios
Aceleración de hardware H264·Sesión Xpra·Compartido: 2 clientes·~2.3 Mbps
inicio / kit / display / características
Cómo funciona

Cinco formas de usar Display

Display se adapta a tu forma de trabajo. Ejecuta un escritorio Linux completo en una pestaña, comparte con tu equipo, cápturalos programáticamente, incrustarlos en tu propia interfaz de usuario o ajústalos para conexiones de bajo ancho de banda —todo desde la misma URL.

display-1

Escritorio Linux completo

Ejecuta cualquier aplicación X11 —navegadores, IDE, editores de imágenes— en un contenedor aislado y transmítela a una pestaña del navegador. Sin VNC, sin RDP, sin cliente nativo.

# antes / después

- vncviewer usuario@servidor:5901 (instalar cliente, abrir puerto)

+ Abre https://display-1.hoody.com —funciona en cualquier dispositivo

# Comprueba que la pantalla está activa

$ curl /api/v1/health

> ["status": "ok"]

 

# Inspecciona la sesión

$ curl /api/v1/display/info

> [

> "display": 1,

> "resolution": "1920x1080",

> "encoding": "h264",

> "clients": 1

> ]

Escritorio1/5
inicio / kit / display / parámetros
Parámetros de URL

Una URL, más de 50 parámetros

Todo sobre una sesión de pantalla se controla mediante la URL. Cambia un interruptor a continuación y la URL se actualiza —luego ábrela, incrustarla en un iframe o envíala a un compañero.

https://proj-dev-display-1.hoody.com/
Abrir

Sesión

Quién puede conectarse, quién puede controlar, si reconectar en desconexiones.

Medios y características

Sonido, sincronización del portapapeles, transferencia de archivos, impresión —bloquea o abre.

Codificación

H264 para movimiento, WebP para balance, PNG sin pérdidas, JPEG para enlaces medidos.

Límite de ancho de banda

Límite duro en bytes por segundo. 0 significa ilimitado.

Distribución del teclado

Código de distribución. Usa swap_keys=true en macOS para el mapeo Cmd→Ctrl.

[count, plural, =0 [Sin anulaciones — usando valores predeterminados] one [# anulación aplicada] other [# anulaciones aplicadas]]'
inicio / kit / display / api
API HTTP

Cada píxel es una respuesta HTTP

Captura pantallazos, transmite miniaturas y configura la sesión con parámetros de consulta. La pantalla es direccionable, observable y programable de principio a fin.

Ver todos los endpoints
display-api.sh

# Capture the live desktop as a PNG

curl -X GET \

https://proj-dev-display-1.hoody.com/api/v1/display/screenshot \

-H "Authorization: Bearer $TOKEN" \

-o frame.png

 

# Or get base64 + metadata in JSON

curl "https://proj-dev-display-1.hoody.com/api/v1/display/screenshot?base64=true" \

-H "Authorization: Bearer $TOKEN"

 

# Response:

# {

# "image": { "data": "iVBORw0KG..." },

# "info": {

# "full": { "width": 1920, "height": 1080 },

# "timestamp": "1730659200000"

# }

# }

inicio / kit / display / más
Casos de uso

Escritorios bajo demanda

Un escritorio direccionable por URL abre flujos de trabajo que nunca fueron prácticos antes. Sin instalaciones, sin clientes, sin bloqueos de sistema operativo.

Uso de computadora con IA

Agentes que hacen clic, escriben y leen píxeles. La API de captura de pantalla alimenta modelos de visión; teclado y ratón son HTTP. Dale a Claude o GPT un escritorio Linux completo con una URL.

display-1.hoody.com● ai-agent
POST /api/v1/display/screenshot → vision model

Escritorios de trabajo remoto

Un escritorio por empleado, administrado centralmente, accesible desde cualquier dispositivo. Los datos nunca salen del contenedor. Incorpora en segundos —comparte una URL.

Entornos de desarrollo

Cursor, VS Code, JetBrains, navegadores completos —todo se ejecuta en el contenedor, no en la computadora portátil. Abre una URL en un Chromebook y tienes una estación de trabajo senior.

Aplicaciones SaaS de escritorio

Envía software solo de Linux a cualquier navegador. Herramientas CAD heredadas, aplicaciones científicas, terminales de comercio —envuélvelas en un contenedor y cobra por URL.

Tableros de monitoreo

Miniaturas de 320 píxeles te permiten colocar decenas de escritorios en vivo en una única vista. Actualiza cada 5 segundos, marca anomalías, profundiza en la pantalla completa con un clic.

Presentaciones compartidas

?sharing=true&readonly=true convierte cualquier escritorio en una transmisión. El presentador conduce, la audiencia ve —sin software de compartir pantalla requerido.

# broadcast URL
?sharing=true&readonly=true
8 2 1viewers / presenters / muted
inicio / kit / display / endpoints
API HTTP

13 endpoints, observabilidad completa

Capturas de pantalla, miniaturas, metadatos de sesión y controles de estado. Cada endpoint devuelve datos JSON estructurados o datos de imagen sin procesar con autenticación de token de portador.

Capturas de pantalla

5 endpoints

curl .../screenshot -o frame.png → 1920x1080 PNG

GET
/api/v1/display/screenshotCaptura PNG de resolución completa
GET
/api/v1/display/screenshot/lastÚltima captura de pantalla capturada
GET
/api/v1/display/screenshot/:tsCaptura de pantalla histórica por marca de tiempo
GET
/api/v1/display/screenshot/infoCaptura y devuelve solo metadatos
GET
/api/v1/display/screenshot/last/infoMetadatos para la última captura

Miniaturas

5 endpoints

curl .../thumbnail/last → 320px preview JPEG

GET
/api/v1/display/thumbnailVista previa de 320 píxeles, bajo ancho de banda
GET
/api/v1/display/thumbnail/lastÚltima miniatura
GET
/api/v1/display/thumbnail/:tsMiniatura histórica
GET
/api/v1/display/thumbnail/infoSolo metadatos de miniatura
GET
/api/v1/display/thumbnail/last/infoMetadatos para la última miniatura

Información y metadatos

2 endpoints

curl .../display/info → {display: 1, screenshots: [...]}

GET
/api/v1/display/infoID de pantalla + lista de capturas de pantalla
GET
/api/v1/display/screenshotsTodas las capturas de pantalla con metadatos

Estado

1 endpoint

curl .../health → {status: "ok"}

GET
/api/v1/healthControl de estado del servicio
inicio / kit / display / más
Capacidades

Todo integrado

Cada característica está lista para usar. Sin complementos, sin controladores, sin instalaciones de cliente.

Aceleración de hardware

Codificación de video H264 a 2–5 Mbps para movimiento suave. JPEG a 100–500 Kbps para enlaces medidos. WebP, PNG y RGB sin procesar también disponibles.

?encoding=h264?encoding=webp?encoding=jpeg?encoding=png

Sincronización del portapapeles

Copia en tu computadora portátil, pega en el escritorio remoto —y viceversa. Se admiten texto sin formato, texto enriquecido y formatos UTF-8.

?clipboard=true?clipboard=false

Dispositivos táctiles

Tocar, pellizcar y desplazarse con dos dedos funcionan de inmediato. Añade ?keyboard=true para un teclado virtual en pantalla en teléfonos y tablets.

?keyboard=true?swap_keys=true

Reconexión automática

?reconnect=true restaura la sesión cuando el Wi-Fi cambia o tu computadora portátil se despierta. El escritorio sigue ejecutándose en el servidor mientras estás fuera.

?reconnect=true

Modo de solo lectura

?readonly=true bloquea la entrada para acceso de solo vista. Perfecto para paneles, presentaciones y distribución de enlaces de demostración.

?readonly=true?steal=false

Banderas de características

Alterna sonido, impresión, portapapeles y transferencia de archivos de forma independiente. Bloquea un entorno para seguridad o elimina funciones para rendimiento.

?sound=false?printing=false?file_transfer=false
inicio / kit / display / comenzar

Pon un escritorio en una URL

Display es uno de los 14 servicios de Kit que se envían con cada contenedor de Hoody. Sin instaladores, sin clientes, sin VPN —solo una pestaña del navegador.

Leer la documentación