LEEME

MPV‑SW‑Capture

MPV configurable y listo para usar en Windows, adaptado para capturadoras USB 3.0 para jugar tu propia consola real (como SW/2, u otra) con mínima latencia y con muchas funciones extra.

---

📋 Características

• Juega cualquier consola (Switch/2/PS/XB/Retro o cualquier otra consola compatible con HDMI) a través de tu capturadora USB usando MPV.
• Con mínima latencia – juega tu consola real con un retardo mínimo. Casi igual que conectarla directamente al TV.
• Portátil – copia/mueve y usa toda la carpeta en cualquier ubicación; funcionará allí sin reinstalación.
• Menú personalizado (accesible con clic derecho o una tecla) con:
  • Shaders – carga shaders para mejorar la calidad de imagen hasta 4K o cambiar a estilos retro (CRT, VHS, arcade CRT, etc.).
  • Formas – cambia la forma en que se ve la pantalla (CRT, VHS, arcade CRT, etc.).
  • Recorte (Crop) – recorta la ventana al tamaño exacto de un sistema NSO (GBA, NES, SNES, etc.).
  • Marcos (Bezels) – superpone bordes especiales (ej. marco SNES NSO) para una sensación auténtica.
  • Opciones de ventana – redimensionar, reposicionar, mantener siempre al frente, y más.
  • Capturas de pantalla – guarda automáticamente capturas en la carpeta de MPV.
  • Grabación de video – graba 30/60/90/120 segundos de video en buena calidad y tamaño reducido.
• Personalización del menú, reemplazo y adición de tus propios bezels y shaders.

⚙️ Cómo funciona (audio + video con mínima latencia)

MPV por sí solo puede introducir latencia perceptible al manejar audio y video desde una capturadora.
Esta configuración divide la carga:

• MPV maneja solo el video.
• ffplay (del paquete ffmpeg) maneja solo el audio.

Ambos programas se ejecutan en silencio, permanecen sincronizados y juntos ofrecen una experiencia con mínima latencia en audio y video.

📦 Requisitos

• Un PC con USB 3.0 (USB 2.0 funciona pero con peor rendimiento).
• Una capturadora que soporte 1080p60 y tenga loop-through (entrada + salida), por ejemplo: “4K Ultra HD USB 3.0 HD Video Capture (MS 2131)” o similar.
• Tu propia consola de videojuegos oficial.
• mpv player: no se distribuye en este repositorio. Descarga una versión adecuada (por ejemplo, builds oficiales para Windows de zhongfly: https://github.com/zhongfly/mpv-winbuild/releases, o paquetes de tu distro).
• ffmpeg/ffplay: no se distribuye en este repositorio. Descarga desde el proyecto oficial o un proveedor confiable (por ejemplo, Essentials en https://www.gyan.dev/ffmpeg/builds/).

Nota: mpv y ffmpeg/ffplay son dependencias de terceros con sus propias licencias (LGPL/GPL, etc.). Son necesarios para usar este proyecto pero no están incluidos en el repositorio ni en sus releases. Pero si puedes obtenerlos con el Installer incluído con este programa.

🛠️ Instalación v3.0.0+ (paso a paso)

1. Descargar archivos

   • Obtén MPV‑SW‑Capture (v3.0.0 o superior):
     • Descarga el último release de este repositorio (ZIP) en "Assets". Solo el archivo llamado MPV-SW-Capture-v.X.Y.Z.zip.

2. Preparar la carpeta

   • Crea una carpeta (ej. MPV-SW-Capture) donde quieras.
   • Abre el último release de MPV‑SW‑Capture y extrae todos los archivos en esa misma carpeta.

   Deberías terminar con algo como esto:

   MPV-SW-Capture/
   ├── bezels/
   ├── data/
   ├── scripts/
   ├── shaders/
   ├── tools/
   ├── Installer_MPV-SW-Capture.exe
   ├── Setup_MPV-SW-Capture.exe
   ├── input.conf
   ├── menu.conf
   └── mpv.conf
   

3. Configuración inicial

   Conexión

   • Conecta tu capturadora al PC usando USB 3.0 (o USB 2.0).
   • Conecta el HDMI de tu consola a la entrada de la capturadora.

   Archivo INSTALL

   • Dentro de la carpeta, ejecuta Installer_MPV-SW-Capture.exe. Encontrarás una ventana GUI similar a esta:
     
     Cambia cualquier opción que quieras o usa las predeterminadas.
   • Presiona "Instalar / Actualizar TODO" y espera a que el instalador termine su trabajo.

   Archivo SETUP

   • Ahora, dentro de la carpeta, ejecuta Setup_MPV-SW-Capture.exe. Encontrarás una ventana GUI similar a esta:
     
     Si quieres cambiar el idioma de la GUI a español, presiona el botón ES. Puedes cambiarlo cuando quieras.
   • Presiona "Scan Device"; se listarán todos los dispositivos de audio y video conectados actualmente. (Si no hay nada conectado, la lista estará vacía. Conecta tus dispositivos e intenta presionar el botón otra vez).
   • Elige el dispositivo de video en la lista y luego el de audio (debe ser del mismo tipo que la capturadora).
   • Elige formato de fecha, inicio automático de shaders especiales, tiempo predeterminado de grabación de video, crear acceso directo en el escritorio, para ajustar tus preferencias.
   • Cuando esté todo listo, presiona el botón verde "Apply Setup".
   • Si todo está correcto, recibirás un mensaje con los cambios.
   • OPCIONAL: Puedes traducir el MENÚ al español si quieres. Debes presionar "MENU: English <- -> Espanol". Puedes hacerlo sin usar las opciones principales (es independiente).

4. Iniciar la transmisión en MPV-SW-Capture

   • Ejecuta MPV-SW-Capture.exe (puedes crear un acceso directo en el escritorio por comodidad).
   • Si todo está configurado correctamente, verás tu consola con audio y video.
   • Para acceder al menú, haz clic derecho dentro de la ventana o presiona ESC. Doble clic activa/desactiva la pantalla completa.

Instalación MANUAL

Si quieres usar la forma antigua de instalar MPV-SW-Capture (que aún funciona), tienes problemas, o cualquier otra cosa, puedes encontrarla aquí: Instalación MANUAL

🖼️ Capturas / Ejemplos

Algunos ejemplos visuales de MPV-SW-Capture en funcionamiento:

Menú personalizado	Ejemplo de shader+forma
Menú de clic derecho / ESC con opciones de shaders, bezels, recorte, ventana y captura.	Ejemplo de un shader estilo CRT+Forma de Curvatura CRT aplicado a través de MPV‑SW‑Capture.

Ejemplo de bezel	Ejemplo de recorte
Ejemplo de bezel aplicado alrededor de la imagen capturada para una apariencia más auténtica.	Ventana recortada para coincidir con la resolución de GB en NSO, usando los preajustes de recorte. Perfecto si no quieres los bordes normales.

Ejemplo de ventana estirada	Ejemplo de combinación
Opción de Estirar Ventana activada para llenar más la pantalla manteniendo la captura visible.	Ejemplo de combinación de Shader+Recorte (a 4:3)+Estirar. El recorte no puede combinarse con Bezel.

Las imágenes de bezel incluidas en este proyecto son marcos genéricos estilo CRT/consola portátil (creados/editados para este proyecto) y no son assets oficiales de ninguna consola o videojuego. Son solo superposiciones decorativas.

❓ FAQ (Preguntas frecuentes)

Puedes encontrar la FAQ aquí: FAQ

📄 README in English

You can find it in the main page of MPV-SW-Capture: README

💖 Patrocinadores

Si MPV-SW-Capture te resulta útil, considera apoyar el desarrollo a través de GitHub Sponsors.
Los patrocinadores ayudan a mantener el proyecto y hacen posibles nuevas funciones.

También puedes apoyarme en Ko-fi:

📄 Licencia

Este proyecto (scripts Lua, archivos batch, bezels, documentación y shaders originales creados por TyRaS-SW) está licenciado bajo la Licencia MIT; consulta el archivo LICENSE.

Este repositorio también incluye shaders de terceros bajo sus propias licencias (licencias permisivas tipo BSD, la GNU Lesser General Public License (LGPL), licencias específicas de proveedores como la licencia AMD FidelityFX SDK y otros términos de origen). Consulta NOTICE.md y los encabezados de los archivos shader individuales para más detalles.

La licencia MIT de este repositorio se aplica solo al código original creado por TyRaS-SW. No vuelve a licenciar ni reemplaza los términos de los shaders de terceros o binarios externos (mpv, ffmpeg, etc.), que permanecen bajo sus respectivas licencias originales.

🏷️ Aviso sobre marcas registradas

Nintendo Switch y Nintendo Switch 2 son marcas registradas de Nintendo Co., Ltd.
Este proyecto no está afiliado, avalado ni patrocinado por Nintendo.