Repository navigation
Guía‐Administrador Video
Administrador de Opciones de Video es una herramienta gráfica (GUI) para Windows que te permite editar y personalizar fácilmente las opciones de video que usa MPV-SW-Capture.
Con esta herramienta puedes:
- Ajustar parámetros clave como el tamaño del buffer, resolución, FPS, hilos, escala de ventana, decodificación por hardware y más.
- Aplicar cambios directamente al archivo
MPV-SW-Capture.batsin editarlo manualmente. - Restaurar la configuración predeterminada con un clic.
- Guardar tu configuración personalizada en un archivo JSON para respaldo o intercambio.
- Importar configuraciones personalizadas desde archivos JSON.
- Cambiar el idioma de la interfaz entre inglés y español.
- Abre la carpeta
tools. - Abre el archivo
MSC_Video_Manager.exe.
Al abrir el programa, verás una ventana con el siguiente diseño:
- Botones EN / ES para cambiar el idioma de la interfaz entre inglés y español.
Muestra las rutas que el programa está utilizando:
- Carpeta raíz: raíz del proyecto.
-
Carpeta tools: carpeta
tools/(donde se almacena el archivo JSON). -
Archivo BAT: ruta al archivo
MPV-SW-Capture.batque se modificará (ubicado en/data). -
JSON personalizado: ruta al archivo
user-video_options.jsondonde se guardan tus configuraciones personalizadas (entools/).
Aquí puedes ajustar los principales parámetros de video que usa MPV. Cada opción incluye una breve descripción (que aparece debajo del control) para ayudarte a entender su efecto.
| Opción | Descripción | Valores disponibles |
|---|---|---|
| Tamaño del buffer de video | Define el tamaño del buffer que usa MPV antes de reproducir. Valores bajos reducen el lag; valores altos mejoran la estabilidad. | 32M, 64M (por defecto), 128M, 256M, 512M, 768M, 1024M |
| Resolución de video | Fuerza la resolución predeterminada. "1920x1080" (1080p) es la opción más estable. Usa "1280x720" si tienes lag en 1080p. | 1280x720, 1920x1080 (por defecto), 2048x1152, 2560x1440, 3840x2160 |
| FPS | Fuerza los FPS predeterminados. "Auto" usa los FPS nativos de la tarjeta de captura. | Auto (por defecto), 60, 30, 24 |
| Hilos de decodificación de video | Elige la cantidad de hilos usados para decodificar video. "1" es la mejor opción para baja latencia; "0" usa el valor automático (puede aumentar el buffering). | 1 (por defecto), 0 |
| Escala de ventana | Ajusta el tamaño inicial de la ventana. Valores más altos agrandan la ventana y pueden aumentar ligeramente la carga de renderizado. | 0.5, 0.75, 1.0 (por defecto), 1.25, 2.0 |
| Salida de video | Elige el renderizador de salida de video. "gpu-next" es la opción moderna y recomendada; "gpu" es adecuada para PCs antiguos. | gpu-next (por defecto), gpu |
| Decodificación por hardware | Activa o desactiva la aceleración por hardware. "no" es el valor predeterminado (desactivado); "auto-safe" reduce el uso de CPU con aceleración por hardware; "auto" y "yes" son más agresivos. | no (por defecto), auto-safe, auto, yes |
| Hilo del demuxer | Activa o desactiva el hilo del demuxer usado al leer la señal. "no" es la opción recomendada para reducir la latencia. | no (por defecto), yes |
Cada control se presenta como una lista desplegable con los valores disponibles. El valor actual está resaltado.
-
Recargar desde BAT: recarga la configuración actual desde el archivo
MPV-SW-Capture.bat(útil si has editado el archivo manualmente). -
Guardar en BAT: aplica la configuración actual del formulario al archivo
MPV-SW-Capture.bat. - Restaurar Opciones por DEFECTO: restablece todas las opciones a sus valores predeterminados y los escribe en el archivo BAT.
-
Guardar Opciones Personalizadas: guarda la configuración actual como un archivo JSON en la carpeta
tools/(para respaldo o intercambio). - Importar Opciones Personalizadas: carga un archivo JSON con configuración personalizada y la aplica al archivo BAT.
Muestra un registro de las acciones realizadas (recargas, guardados, errores, etc.) y el estado actual del programa.
- Abre el Administrador de opciones de video.
- El programa carga automáticamente la configuración actual desde el archivo
MPV-SW-Capture.bat. Si necesitas recargarla (por ejemplo, después de cambios manuales), haz clic en Recargar desde BAT.
- Selecciona el valor deseado en cada lista desplegable.
- La descripción debajo de cada opción te ayudará a entender el efecto de tu elección.
- Después de ajustar las opciones, haz clic en Guardar en BAT.
- El programa actualizará el archivo
MPV-SW-Capture.batcon tu nueva configuración. - Reinicia MPV (o ejecuta el archivo BAT nuevamente) para ver los cambios.
- Haz clic en Restaurar Opciones por DEFECTO.
- Aparecerá un diálogo de confirmación. Haz clic en Sí.
- Todas las opciones se restablecerán a sus valores predeterminados y el archivo BAT se actualizará.
- Una vez que tengas la configuración deseada, haz clic en Guardar Opciones Personalizadas.
- El programa guardará un archivo JSON llamado
user-video_options.jsonen la carpetatools/. - Este archivo se puede compartir con otros o usar como respaldo.
- Haz clic en Importar Opciones Personalizadas.
- Selecciona un archivo JSON (exportado previamente o proporcionado por otra persona).
- Confirma la importación. La configuración se cargará en el formulario y se escribirá automáticamente en el archivo BAT.
El programa crea y gestiona los siguientes archivos:
-
user-video_options.json(entools/): contiene tus opciones de video personalizadas en formato JSON (se crea al hacer clic en Guardar Opciones Personalizadas). -
MPV-SW-Capture.bat(en/data): el archivo de inicio principal que se modifica al hacer clic en Guardar en BAT o Importar Opciones Personalizadas.
- Comprende cada opción: Lee el texto de ayuda (en la interfaz) para saber cómo afecta cada ajuste al rendimiento y la latencia.
- Comienza con los valores predeterminados: Si tienes problemas, usa Restaurar Opciones por DEFECTO para volver a la configuración estable por defecto.
- Guarda tu JSON personalizado: Después de encontrar una configuración que funcione bien para ti, guárdala como JSON para restaurarla rápidamente más tarde.
-
Haz una copia de seguridad del BAT: Antes de realizar cambios importantes, considera hacer una copia de seguridad de
MPV-SW-Capture.bat(el programa no crea copias de seguridad automáticas). - Prueba los cambios de forma incremental: Cambia una o dos opciones a la vez y prueba el resultado para aislar el efecto de cada parámetro.
| Problema | Posible solución |
|---|---|
| El programa no encuentra el archivo BAT | Asegúrate de que MPV-SW-Capture.bat exista en la carpeta /data. |
| Los cambios no se aplican | Asegúrate de haber hecho clic en Guardar en BAT después de cambiar las opciones. Además, reinicia MPV o ejecuta el archivo BAT nuevamente. |
| El archivo JSON no es válido | Si obtienes un error al importar, verifica que el archivo JSON tenga la estructura correcta (debe contener todas las claves: rtbuf, videoSize, fps, threads, windowScale, demuxerThread, vo, hwdec). |
| El rendimiento de MPV empeora después de los cambios | Usa Restaurar Opciones por DEFECTO para volver a la configuración estable y luego ajusta gradualmente. |
- Esta herramienta está diseñada para MPV‑SW‑Capture y no debe usarse con otras configuraciones.
- Si encuentras algún error o tienes sugerencias, abre un issue en el repositorio oficial.