De la caja a la primera carrera.
Todo lo que necesitas para jugar tu consola en tu Mac: el equipo, la instalación, los ajustes de cada consola, los controles y qué hacer si la pantalla se queda en negro.
Qué necesitas
- Una Mac con macOS 14 Sonoma o posterior, con Apple silicon o Intel.
- Una capturadora USB que funcione como dispositivo de video estándar (UVC). La mayoría de las que se venden para consolas lo son, desde los adaptadores HDMI a USB más pequeños hasta Elgato y AVerMedia. Si funciona en Photo Booth o QuickTime sin instalar un driver, funciona en plugview. Mira las tarjetas compatibles.
- Un cable HDMI de tu consola a la entrada HDMI de la tarjeta.
- Un puerto USB 3 de la propia Mac. Los hubs y los puertos USB 2 pueden bajar los cuadros por segundo o cortar la imagen.
La tarjeta pone los límites: una tarjeta que captura 1080p a 60 fps muestra 1080p60 aunque la consola mande 4K. plugview siempre elige el modo más fluido que ofrece la tarjeta, así que 1080p60 le gana a 4K30.
Instalar
Homebrew no está disponible por ahora. Nuestro alojamiento de código está caído para nosotros, así que brew install falla por el momento. Las descargas de abajo son la misma versión 0.3.0, servida desde plugview.app.
La app, descargada
Descarga plugview-macos-app.zip, descomprímelo y mueve plugview.app a Aplicaciones. La app incluye el comando plugview: abre la app una vez y enlázalo con sudo ln -sf /Applications/plugview.app/Contents/MacOS/plugview /usr/local/bin/plugview.
Solo el comando
curl -fsSL https://plugview.app/download/plugview-macos-universal.tar.gz | tar -xz
sudo install plugview-*/plugview /usr/local/bin/Instala la app o el comando, no los dos. Si tienes ambos, gana el que esté primero en tu PATH.
Aún sin notarizar. plugview todavía no está firmado con un Apple Developer ID, así que la primera vez que lo abres macOS dice que no puede verificar la app. Abre Configuración del Sistema › Privacidad y seguridad, baja hasta el final y haz clic en Abrir de todos modos. Esto se hace una vez por instalación o actualización. Mientras tanto, el comando plugview que viene con la app tampoco abre. Después de cada actualización macOS vuelve a pedir acceso a la cámara y al micrófono. La firma y la notarización llegan antes de cualquier función de pago.
La primera vez
Para macOS una capturadora es una cámara con micrófono, así que plugview necesita dos permisos. Te explica para qué antes de que macOS los pida.
- Cámara: muestra la imagen de tu capturadora. plugview nunca enciende la cámara de tu Mac.
- Micrófono: reproduce el sonido de tu consola. plugview nunca escucha el micrófono de tu Mac.
Si le dijiste que no a la cámara, plugview muestra un botón que abre Configuración del Sistema › Privacidad y seguridad › Cámara. Activa plugview ahí y elige Salir y volver a abrir: macOS aplica el cambio solo después de reiniciar la app. Sin micrófono, plugview muestra la imagen sin sonido.
Si lo abres desde una terminal, los permisos son de la app de terminal (Terminal, iTerm, Warp…), no de plugview.
Conecta tu consola
Salida HDMI de la consola → entrada HDMI de la capturadora → USB de la tarjeta → Mac. Abre plugview antes o después de conectar; encuentra la tarjeta solo.
Nintendo Switch y Switch 2 Configuración completa →
Pon la consola en su dock y conecta la salida HDMI del dock a la tarjeta. Los juegos no tienen protección anticopia, así que no hay nada que desactivar. Si los colores se ven deslavados o muy oscuros, ajusta Configuración de la consola › Salida de TV › Rango RGB según tu tarjeta: prueba primero Rango limitado y luego Rango completo.
PlayStation 5 Configuración completa →
La PS5 cifra su salida HDMI (HDCP) y una capturadora no muestra nada hasta que lo desactivas. Con la PS5 conectada a una TV, abre Configuración › Sistema › HDMI (en algunas regiones, Ajustes) y desactiva Habilitar HDCP. Después conéctala a la tarjeta.
PlayStation 4 y PS4 Pro
Abre Configuración › Sistema (o Ajustes) y desmarca Habilitar HDCP.
En ambas PlayStation, las apps de video como Netflix necesitan HDCP activado para reproducir.
Xbox Series X|S y Xbox One Configuración completa →
Los juegos de Xbox nunca tienen protección anticopia, así que aparecen de inmediato. Las apps de video (Netflix, Disney+…) activan la protección y la imagen se pone en negro mientras están abiertas. Es la consola, no plugview.
Steam Deck y PC portátiles Configuración completa →
Conecta un dock o un adaptador de USB-C a HDMI a la entrada HDMI de la tarjeta. La portátil ve la tarjeta como una pantalla externa; elige una resolución y frecuencia que la tarjeta soporte (1920×1080 a 60 Hz es lo seguro).
Consolas retro y cámaras
La tarjeta necesita señal HDMI: las consolas antiguas pasan por un adaptador HDMI o un escalador. Las cámaras necesitan una salida HDMI limpia, sin los menús ni las marcas de enfoque encima.
Ajustes de salida de la consola
Configura la consola a una resolución y frecuencia que tu tarjeta capture. Si la consola manda un modo que la tarjeta no lee, casi todas las tarjetas no muestran nada. 1080p a 60 Hz funciona con casi cualquier tarjeta.
Jugar
El video llena la ventana, sin barra de título. Mueve el mouse para ver los botones de la ventana y la barra de controles; desaparecen cuando el mouse se queda quieto, para que nada tape el juego.
- Sonido: silenciar y volumen. Haz clic en cualquier parte de la barra de volumen, o desplázate sobre la barra de controles.
- Captura: el botón de la cámara (o S) guarda el cuadro actual en PNG a resolución completa en Imágenes › plugview.
- Resolución: el botón con el modo actual (por ejemplo
1080p60) abre la lista de modos de la tarjeta. Colores de rango completo, abajo, corrige tarjetas que mandan negros grises y colores deslavados; déjalo apagado si la imagen ya se ve bien. - Dispositivo de captura: aparece cuando hay más de una tarjeta conectada. plugview recuerda tu elección.
- Pantalla completa.
Arrastra el video para mover la ventana. Cambia su tamaño desde un borde; mantiene la forma del video y recuerda su tamaño y posición. El menú View tiene Actual Size, Zoom In, Zoom Out y Keep on Top (la app está en inglés).
| Tecla | Acción |
|---|---|
| F o ⌃⌘F | Pantalla completa |
| Esc | Salir de pantalla completa |
| M | Silenciar o activar el sonido |
| ↑ ↓ | Subir o bajar el volumen 10 % |
| S | Guardar una captura |
| ⌘+ ⌘− | Acercar o alejar la ventana |
| ⌘0 | Tamaño real (un pixel del video por pixel de pantalla) |
| ⌥⌘T | Mantener la ventana encima (se recuerda) |
| ⌘M | Minimizar |
| ⌘W | Cerrar la ventana (plugview sigue en la barra de menús) |
| Q o ⌘Q | Salir |
La pantalla no entra en reposo mientras la ventana de plugview está abierta, aunque un control no sea teclado ni mouse.
Menos latencia
plugview manda los cuadros directo del driver de captura a la pantalla; el resto del retraso viene de lo que está alrededor. Ejecuta plugview --measure: muestra los cuadros por segundo que tu tarjeta entrega de verdad y el retraso en cada paso, y te dice qué cambiar.
- Sonido con cable. Usa las bocinas de la Mac o audífonos con cable. Los audífonos Bluetooth agregan 150 ms o más, y el sonido llega tarde.
- USB 3, sin hub. Conecta la tarjeta directo a la Mac.
- Pantalla completa. Presiona F.
- Frecuencia compatible. Usa una frecuencia de pantalla múltiplo de los cuadros del juego: 60 o 120 Hz para juegos a 60 fps. A 100 Hz los cuadros duran tiempos desiguales en pantalla.
- Formato nativo. plugview prefiere el formato propio de la tarjeta, 4:2:2 sin comprimir, que no necesita conversión. Las tarjetas que solo mandan MJPEG en resoluciones altas agregan un paso de decodificación; una resolución menor sin comprimir suele ser más rápida.
Línea de comandos
La app también instala el comando plugview. Desde una terminal abre la misma ventana. Las opciones y mensajes del comando están en inglés.
plugview # primera capturadora USB, con su audio
plugview -f # empezar en pantalla completa
plugview --list # ver dispositivos de video y audio
plugview --measure # cuadros por segundo y latencia, con consejos
plugview -d "Cam Link" -a "Cam Link" # elegir dispositivos por nombre
plugview --no-audio # solo video
plugview -v 50 # empezar con volumen al 50 %
plugview --mode 1280x720@60 # elegir el modo de captura (ver --list)| Opción | Qué hace |
|---|---|
-d, --device <nombre> | Dispositivo de video (parte de su nombre o su ID único). Por defecto: la primera capturadora USB encontrada. |
-a, --audio <nombre> | Entrada de audio a reproducir. Por defecto: la que pertenece al dispositivo de video. |
--no-audio | No reproducir audio. |
-v, --volume <0-100> | Volumen inicial en porcentaje. Por defecto: 100. |
-f, --fullscreen | Empezar en pantalla completa. |
--mode <WxH@fps> | Modo de captura, por ejemplo 1280x720@60; también aplica a --measure. Por defecto: el modo más fluido del dispositivo. |
-l, --list | Listar dispositivos de video y audio, con los modos de cada dispositivo de video, y salir. |
--measure | Medir la latencia de la captura unos segundos, y salir. |
-h, --help | Mostrar la ayuda. |
--version | Mostrar la versión. |
Solución de problemas
Pantalla negra, o "WAITING FOR SIGNAL" con la tarjeta conectada
- PlayStation: desactiva HDCP (ve Conecta tu consola).
- Las apps de video de cualquier consola tienen protección anticopia y se ven en negro. Los juegos sí funcionan.
- Configura la consola a 1080p a 60 Hz, un modo que todas las tarjetas leen.
- Revisa que la tarjeta aparezca en
plugview --list. Si no aparece, prueba otro puerto USB y otro cable.
No hay sonido
- Revisa Configuración del Sistema › Privacidad y seguridad › Micrófono y activa plugview.
- Ejecuta
plugview --listy pasa la entrada de audio de la tarjeta:plugview --audio "<nombre>". plugview no adivina cuando hay varias entradas de audio USB conectadas. - Revisa el volumen en la barra de controles y que M no lo haya silenciado.
"cannot be added to the capture session"
Otra app está usando la tarjeta: OBS, Zoom, QuickTime, una pestaña del navegador. Ciérrala y plugview lo intenta de nuevo.
Imagen entrecortada o pocos cuadros por segundo
Ejecuta plugview --measure. Muestra los cuadros por segundo que la tarjeta entrega de verdad. Conecta la tarjeta a un puerto USB 3 de la Mac, lejos de hubs.
Colores deslavados o muy oscuros
Ajusta el rango RGB de la consola según la tarjeta: en Switch, Configuración de la consola › Salida de TV › Rango RGB, primero Rango limitado.
No aparece un iPhone o una cámara virtual
Es a propósito: la Cámara de Continuidad y las cámaras virtuales de apps de streaming nunca se eligen solas. Para usar una, nómbrala desde una terminal: plugview -d "iPhone".
Volver a pedir los permisos
Restablécelos y abre plugview; los pide otra vez:
tccutil reset Camera app.plugview.plugview
tccutil reset Microphone app.plugview.plugview¿Sigues atorado? Abre un issue con la salida de plugview --list y plugview --measure. Puedes escribir en español.
Desinstalar
brew uninstall --cask plugview # la app
brew uninstall plugview # o solo el comando¿Descargaste el zip? Mueve plugview.app a la papelera. Para borrar también el tamaño de ventana guardado, la tarjeta elegida y los permisos:
defaults delete app.plugview.plugview
tccutil reset Camera app.plugview.plugview
tccutil reset Microphone app.plugview.plugview