hyper-pip-youtube

🎬 Reproductor PiP de YouTube para la terminal Hyper

Un plugin ultra ligero para Hyper que integra un reproductor de YouTube Picture-in-Picture (PiP) directamente dentro de tu terminal.

Utiliza un componente nativo aislado (<webview>) que falsifica su origen para saltarse el estricto DRM de YouTube y las restricciones de inserción, ofreciéndote una experiencia de visualización de escritorio 100% nativa dentro de Hyper.

👤 Créditos y Autoría

Este proyecto fue creado por Ramiro Pastrano (como primera versión). Durante el proceso de desarrollo, depuración y refactorización para la optimización nativa, participó activamente la Inteligencia Artificial Antigravity AI.

Cualquier cambio, bug o contribución debe ser reportado directamente a Ramiro Pastrano, creador del canal de YouTube QuePasaLinux.

🔗 Enlaces Importantes

• Documentación Oficial: https://ramiropastrano.com/docs/hyper-pip-youtube
• Repositorio en GitLab: https://gitlab.com/RamiroPastrano/hyper-pip-youtube
• Paquete en NPM: https://www.npmjs.com/package/hyper-pip-youtube

✨ Características Principales

• Modo Fantasma y Atajo Global: Inicia completamente oculto/minimizado. Despliégalo o escóndelo al instante usando Ctrl + Shift + Y (o Cmd + Shift + Y).
• Privacidad de Contenido (Blur): Oculta el video difuminándolo con un botón. Ideal para cuando estás realizando streaming, escuchas música localmente y no quieres que se vea el video para evitar problemas de copyright, o si estás viendo videos que no quieres que aparezcan en la transmisión.
• Background Video (Modo Fondo): Convierte el video en el fondo de tu terminal. Al activarlo, el reproductor se expande a pantalla completa y se sitúa detrás del contenido de Hyper. Usa Ctrl + Shift + B para alternar este modo rápidamente.
• Modo Premium (Sin Anuncios): Inyecta tus propias cookies de YouTube directamente desde la interfaz del plugin para ver videos sin publicidad y con tu cuenta.
• Tamaños Dinámicos Predefinidos: Elige entre tallas S, M, L, XL y MAX al instante, con escalado inteligente y centrado absoluto.
• Evasión de DRM (Error 152-4): El <webview> aislado utiliza "spoofing" dinámico del Agente de Usuario, Origin y Referer para camuflarse como una pestaña de Chrome perfecta.
• Buscador y Memoria Automática: Reproduce cualquier video desde tu portapapeles, búscalo, y reanuda exactamente donde te quedaste.
• Ad-Skipper Inteligente (NUEVO): Detecta y salta anuncios automáticamente, adelantando el video y haciendo clic en botones de "Saltar" de forma invisible.
• Mantenimiento Integrado (NUEVO): Botones para limpiar caché y recargar el reproductor directamente desde la interfaz.

📦 Instalación

hyper install hyper-pip-youtube

Añade el plugin a tu archivo ~/.hyper.js:

module.exports = {
  plugins: ["hyper-pip-youtube"],
  config: {
    // Opcional: configura aquí tu clave de la API de YouTube para usar el buscador
    youtubeApiKey: process.env.YOUTUBE_API_KEY,
  },
};

Importante: Reinicia Hyper por completo después de la instalación para que se apliquen los permisos necesarios del <webview> en Electron.

🚀 Uso de la Interfaz del Plugin

Haz clic en el menú de hamburguesa (☰) en el encabezado del reproductor para revelar el Menú de Navegación:

1. Tamaños Predefinidos: Ajusta el reproductor a proporciones óptimas. El tamaño actualmente activo se resalta en azul.
2. Buscar / Capturar: Reproduce un video de YouTube copiándolo en tu portapapeles y dando clic en "Capturar", o usando el buscador integrado.
3. Iniciar siempre: Marca esta casilla si deseas que el reproductor cargue y se muestre automáticamente cada que abres Hyper.
4. Atajo de Teclado Global: Presiona Ctrl + Shift + Y para ocultar por completo o revelar el reproductor de forma mágica y sin perder tu progreso.

🍪 Modo Premium (Cómo evadir anuncios e iniciar sesión invisible)

Debido a las estrictas defensas anti-bots de Google, el plugin no te permite iniciar sesión de forma gráfica. Sin embargo, cuenta con un inyector maestro de Cookies en la interfaz.

Sigue estos sencillos pasos:

1. Ve a tu navegador (Chrome, Brave, Firefox), abre YouTube y asegúrate de estar logueado con tu cuenta Premium.
2. Presiona F12 para abrir las herramientas de desarrollador.
3. Dirígete a la pestaña Application (o Almacenamiento) y en la barra lateral selecciona Cookies -> https://www.youtube.com.
4. Copia el "Value" (valor) de las tres siguientes cookies maestras: LOGIN_INFO, __Secure-1PSID y __Secure-3PSID. Nota: Debes copiarlas y pegarlas exactamente en el orden que se señala en las imágenes superiores.
5. En Hyper, abre el menú ☰ del reproductor y despliega la sección "🍪 Configurar Modo Premium".
6. Pega los 3 valores que copiaste en sus respectivas cajas y presiona Guardar en .hyper.js.
7. Reinicia Hyper por completo. El interceptor de red inyectará estas cookies fusionándolas con tu sesión, evadiendo los anuncios de inmediato y sincronizando tus recomendaciones.

🌟 NUEVO: Sincronización de Sesión Completa (Likes y Premium)

Si deseas una integración total (poder dar "Like", ver tus suscripciones y que YouTube te reconozca como usuario Premium al 100%):

1. En tu navegador, abre YouTube y presiona F12.
2. Ve a la pestaña Network (Red) y refresca la página.
3. Busca la petición www.youtube.com, ve a Headers -> Request Headers.
4. Copia el valor completo del campo Cookie: (es una cadena muy larga).
5. En Hyper, abre la configuración (⚙️), ve a la "Opción 1: Sesión Completa" y pega la cadena.
6. Guarda y reinicia Hyper.

Nota: Tus cookies se guardan de forma segura en ~/.hyper-pip-youtube-session.txt para no ensuciar tu archivo de configuración principal.

📋 Control de Versiones (Changelog)

| Versión | Fecha | Descripción de Cambios | | :--------- | :--------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | v1.1.0 | Mayo 2026 | - Añadido Ad-Skipper automático para saltar anuncios sin sesión.- Nuevo sistema de almacenamiento de cookies local independiente de .hyper.js.- Soporte para Sincronización de Sesión Completa (Likes habilitados).- Botones de Limpieza de Cache y Recarga integrados. | | v1.0.0 | Abril 2026 | - Lanzamiento inicial del plugin.- Integración nativa pura sin extensiones de navegador.- Interceptor de red para evadir restricciones de YouTube.- Autoguardado de progreso, redimensionamiento dinámico responsive y Modo Premium. |

📄 Licencia

Este proyecto está licenciado bajo la Licencia MIT – consulta el archivo LICENSE para más detalles.

¡Feliz visualización! 🎉