Tutorial MPV - VLC

Como reproducir en VLC o MPV

Para abrir episodios con audio y subtitulos completos usamos reproductores externos. Tu navegador no puede manejar bien MKV con varias pistas, por eso necesitas VLC o MPV.

AVISO DE ANIMEYSERIEDO

No ofrecemos ayuda individual. Si necesitas soporte extra, usa alguna IA disponible o consulta la documentacion oficial.

Compatibilidad MKV Audio multiple Subtitulos ASS Windows 10+

Selecciona tu reproductor

Selecciona como instalarlo

PowerShell y EXE no abren consola al reproducir. BAT puede abrir una ventana negra y puede tener menos compatibilidad con enlaces weblink.

Que hace cada boton

• VLC abre el episodio con el protocolo vlc:// en VLC.
• MPV abre el episodio con el protocolo mpvplay:// en MPV usando mpvplay-protocol.

Si el navegador pregunta permiso para abrir la aplicacion externa, acepta con Abrir.

Formato de enlaces que usamos

• VLC: vlc://https//dominio/ruta.mkv o el formato indicado por el protocolo de VLC.
• MPV directo: mpvplay://https://dominio/ruta.mkv.
• MPV recomendado: mpvplay://weblink?url=<url-codificada>.

No es base64. En MPV usamos URL encoding. Es decir, la URL se convierte a un formato seguro para que el navegador no corte ni cambie caracteres especiales. Por eso aparecen partes como %3A, %2F, %20, %5B o %5D.

Ejemplo: si el video normal empieza con https://, en modo weblink esa parte puede verse como https%3A%2F%2F. Eso es normal.

Protocolos necesarios (Windows)

Instala el protocolo correspondiente:

• MPV: mpvplay-protocol
• VLC: vlc-protocol

Guia Windows 64-bit (VLC · PowerShell)

1. Verifica que VLC abre bien.
2. Descarga vlc-protocol-windows-powershell.zip.
3. Extrae y copia los archivos en C:\Program Files\VideoLAN\VLC.
4. Ejecuta vlc-protocol-register.ps1 como administrador.
5. Prueba con el test.html del proyecto.

Desinstalar: vlc-protocol-deregister.ps1 como admin.

Guia Windows 64-bit (VLC · EXE)

1. Descarga vlc-protocol-windows-exe.zip.
2. Copia el contenido en C:\Program Files\VideoLAN\VLC.
3. Ejecuta vlc-protocol-register.bat como admin.
4. Prueba con el test.html del proyecto.

Guia Windows 64-bit (VLC · BAT)

1. Descarga vlc-protocol-windows-bat.zip.
2. Copia el contenido en C:\Program Files\VideoLAN\VLC.
3. Ejecuta vlc-protocol-register.bat como admin.
4. Si ves consola negra, es normal en BAT.

Guia Windows 64-bit (MPV · PowerShell)

Esta opcion es la recomendada para la mayoria de usuarios porque suele encontrar MPV sin tener que tocar tantas opciones de Windows.

1. Primero instala o descomprime MPV en esta carpeta:

C:\Program Files\mpv

2. En esa carpeta deben existir archivos como mpv.exe y mpv.com.
3. Descarga mpvplay-protocol-windows-powershell.zip desde la pagina de releases de mpvplay-protocol.
4. Extrae el ZIP. No ejecutes los archivos desde dentro del ZIP; primero descomprimelo.
5. Copia los archivos extraidos dentro de C:\Program Files\mpv, junto a mpv.exe.
6. Busca mpvplay-protocol-register.ps1.
7. Haz clic derecho sobre ese archivo y elige Ejecutar con PowerShell como administrador.
8. Si Windows pregunta permiso, acepta.
9. Cierra completamente el navegador y vuelve a abrirlo.
10. Prueba un enlace que empiece con mpvplay://. Si el navegador pregunta si quieres abrir una aplicacion externa, pulsa Abrir.

Desinstalar: ejecuta mpvplay-protocol-deregister.ps1 como administrador.

Guia Windows 64-bit (MPV · EXE)

Esta opcion es rapida y funciona muy bien, pero necesita que Windows sepa donde esta MPV. Por eso, ademas de registrar el protocolo, tambien agregamos MPV al Path.

1. Instala o descomprime MPV en esta carpeta:

C:\Program Files\mpv

2. Abre esa carpeta y verifica que existan mpv.exe y mpv.com.
3. Descarga mpvplay-protocol-windows-exe.zip.
4. Extrae el ZIP en una carpeta normal. No lo uses sin extraer.
5. Copia estos archivos dentro de C:\Program Files\mpv, junto a mpv.exe:

• mpvplay-protocol.exe
• mpvplay-protocol-register.bat
• mpvplay-protocol-deregister.bat

5. Haz clic derecho en mpvplay-protocol-register.bat.
6. Elige Ejecutar como administrador.
7. Si Windows pregunta permiso, acepta.
8. Ahora agrega C:\Program Files\mpv al Path de Windows. Esto es importante porque el programa busca mpv.exe por nombre.
9. Cierra completamente el navegador. Si estaba abierto, seguira usando la configuracion anterior.
10. Abre el navegador otra vez y prueba un enlace mpvplay://.

Importante: en Windows en español, el Explorador puede mostrar Archivos de programa, pero la ruta real que debes usar es C:\Program Files\mpv.

Si despues de hacer todo no abre, reinicia Windows y prueba otra vez.

Guia Windows 64-bit (MPV · BAT)

Esta opcion es simple, pero puede mostrar una ventana negra por un momento cuando se abre el video. Tambien puede tener menos compatibilidad que PowerShell o EXE.

1. Instala o descomprime MPV en:

C:\Program Files\mpv

2. Descarga mpvplay-protocol-windows-bat.zip.
3. Extrae el ZIP.
4. Copia el contenido dentro de C:\Program Files\mpv.
5. Haz clic derecho en mpvplay-protocol-register.bat.
6. Elige Ejecutar como administrador.
7. Si no abre MPV, agrega C:\Program Files\mpv al Path de Windows.

Agregar MPV al Path de Windows

Este paso sirve para que Windows encuentre mpv.exe aunque el protocolo lo abra desde el navegador. Si no haces esto, puede aparecer el error Failed to start MPV (error code: 2).

1. Haz clic en Inicio.
2. Busca variables de entorno.
3. Abre Editar las variables de entorno del sistema.
4. En la ventana que aparece, pulsa Variables de entorno....
5. En la parte de arriba, donde dice Variables de usuario, selecciona Path.
6. Pulsa Editar.
7. Pulsa Nuevo.
8. Agrega exactamente esta ruta:

C:\Program Files\mpv

9. Pulsa Aceptar en todas las ventanas.
10. Cierra todos los CMD y todos los navegadores.
11. Abre un CMD nuevo y escribe:

where mpv

Si todo esta bien, debe aparecer algo parecido a esto:

C:\Program Files\mpv\mpv.com
C:\Program Files\mpv\mpv.exe

Si no aparece nada, revisa que escribiste la ruta como C:\Program Files\mpv y no como C:\Archivos de programa\mpv.

Navegadores

• Chrome/Edge: al abrir un enlace mpvplay:// o vlc://, el navegador mostrara un aviso. Pulsa Abrir.
• Chrome/Edge 130+: algunos enlaces pueden llegar como mpvplay://https//.... El protocolo de MPV puede corregir ese formato automaticamente.
• Firefox: en about:config crea y pon en false: network.protocol-handler.expose.mpvplay o network.protocol-handler.expose.vlc.
• Safari: soporte practico en macOS.

Logs y solucion de problemas

• Ejecuta el archivo de registro como administrador. Si no lo haces como administrador, el protocolo puede no registrarse bien.
• Verifica que MPV este realmente en C:\Program Files\mpv.
• Para comprobar que MPV funciona, abre CMD y ejecuta:

"C:\Program Files\mpv\mpv.com" --version

• Si sale la version de MPV, MPV esta bien instalado.
• Para comprobar que Windows encuentra MPV, abre CMD y ejecuta:

where mpv

• Si where mpv no muestra nada, agrega C:\Program Files\mpv al Path de Windows.
• Si el navegador muestra el aviso para abrir mpvplay://, pero MPV no abre, revisa el log:

notepad "%TEMP%\mpvplay-protocol.log"

• Si el log muestra Failed to start MPV (error code: 2), significa que el protocolo no encuentra mpv.exe. Solucion: agrega C:\Program Files\mpv al Path, cierra el navegador y abrelo otra vez.
• Si despues de cerrar el navegador sigue igual, reinicia Windows.
• Logs MPV: %TEMP%\mpvplay-protocol.log y %TEMP%\mpvplay-protocol-error.log.
• Logs VLC: %TEMP%\vlc-protocol.log y %TEMP%\vlc-protocol-error.log.

Ejemplo de enlace MPV

El formato recomendado es weblink con la URL codificada:

mpvplay://weblink?url=https%3A%2F%2Fdominio.com%2Fvideo.mkv%3Fsign%3Dtoken

El valor despues de url= debe generarse con encodeURIComponent(url). No uses base64.

Cuando pegues el enlace en Chrome o Edge, puede aparecer una ventana preguntando si quieres abrir una aplicacion externa. Pulsa Abrir. Si ya configuraste todo bien, MPV se abrira automaticamente.

Mac y Linux (resumen)

Los proyectos incluyen instrucciones para macOS y Linux. Revisa el README del protocolo si usas esos sistemas.