Documentación

Plataformas compatibles

Requisitos

• Windows 10 u 11: un .exe de un solo archivo, sin instalación.
• Linux x86_64: una AppImage que incluye su propio Python. Necesita glibc 2.35 o posterior (Ubuntu 22.04, Debian 12, Fedora 36, Linux Mint 21 o posteriores).
• Desde el código fuente: Python 3.10 o posterior con Tcl/Tk, sin ninguna otra dependencia.
• Para ver streams: Streamlink y un reproductor de vídeo, VLC por defecto.

En Linux, el lanzador no tiene icono en el área de notificación, atajo global, inicio con el sistema, arrastrar y soltar, notificaciones de directos, vistas previas de los streams ni actualización integrada.

Idiomas

Las dos aplicaciones están disponibles en inglés, francés, español, alemán e italiano. Siguen el idioma del sistema; puedes cambiarlo en Ajustes › General (Launcher) o Ajustes › Visualización (Chat).

Streamlink es un programa libre de línea de comandos. Recupera el flujo de vídeo de un stream y lo envía a tu reproductor. Así ves Twitch, Kick o YouTube en VLC o mpv, sin la página web alrededor: menos memoria, sin anuncios de Twitch y con los atajos de tu propio reproductor.

Normalmente, Streamlink se usa en un terminal:

Streamlink Launcher escribe este comando por ti: reconoce la plataforma, añade las opciones adecuadas y la calidad elegida, y luego inicia Streamlink. Streamlink Chat lo usa para su botón ▶.

Calidades

best elige la calidad más alta, worst la más baja y audio_only solo el sonido (Twitch). También puedes pedir una calidad concreta, como 1080p60, o una lista de alternativas: 720p60,720p,best toma la primera disponible.

¿Y los anuncios de Twitch?

Desde la versión 7.5.0, Streamlink siempre filtra los anuncios de los streams de Twitch. La antigua opción --twitch-disable-ads ya no es necesaria (está obsoleta, pero se sigue aceptando).

Streamlink está disponible en su sitio oficial, streamlink.github.io/install. Elige tu sistema:

Comprobar la instalación

Si el comando muestra un número de versión, todo está listo. En Launcher, Ajustes › Streamlink también muestra la versión encontrada.

¿Streamlink instalado en otro sitio? Launcher Chat

Las aplicaciones buscan Streamlink en el PATH y en las ubicaciones habituales. Si está en otro lugar, indica la ruta de streamlink.exe en Ajustes › Streamlink › Ruta personalizada (Launcher) o en Ajustes › Ver (Chat).

Dónde colocar las aplicaciones Launcher Chat

Descarga el archivo desde la página de versiones (Launcher, Chat) y colócalo en una carpeta tuya, por ejemplo Documents\Streamlink. Los ajustes se guardan junto a él y la actualización integrada puede sustituir el archivo. Evita C:\Program Files, que está protegida contra escritura.

En Linux, haz ejecutable la AppImage y luego iníciala:

Para tener una entrada en el menú de aplicaciones, usa una herramienta como Gear Lever o AppImageLauncher.

Tu primer stream Launcher

1. Comprueba que Streamlink y un reproductor de vídeo están instalados.
2. Elige la plataforma con su pastilla: Twitch, Kick, YouTube, Dailymotion, Steam TV o Enlace directo.
3. Escribe el nombre del canal (eslcs) o pega un enlace (https://kick.com/…): un enlace selecciona la plataforma por sí solo.
4. Elige la calidad si hace falta y pulsa Intro o Iniciar. El reproductor se abre al cabo de unos segundos.
5. Para seguir o detener el stream, abre el Registro en la parte inferior de la ventana: muestra la salida de Streamlink y un botón Detener.

Tres formas más rápidas Launcher

• Copiar un enlace: copia la dirección de un stream y vuelve al lanzador. Te propone iniciarlo, y el enlace ya está en la barra mini. Se puede desactivar en Ajustes › Streamlink › Detectar enlaces copiados.
• Arrastrar y soltar (Windows): arrastra a la ventana la dirección desde la barra del navegador, un texto seleccionado o un acceso directo de Internet .url.
• Modo mini (Windows): Ctrl+Alt+S desde cualquier aplicación, escribe e Intro.

Tu primer chat Chat

1. Elige la plataforma con su pastilla, debajo del campo Añadir un chat.
2. Escribe el nombre del canal o pega un enlace y pulsa Intro. Ctrl+T coloca el cursor en este campo.
3. El chat se abre en una pestaña nueva, en solo lectura. Para escribir, conecta tu cuenta (consulta Escribir en el chat).
4. En la cabecera del chat, ▶ abre el stream con Streamlink y el icono de enlace abre el canal en tu navegador.

El campo acepta un nombre (eslcs), un prefijo (kick:lunaria, steam:nombre) o un enlace: twitch.tv/…, kick.com/…, steam.tv/…, steamcommunity.com/broadcast/watch/…, incluidos los enlaces «popout». Tus pestañas vuelven en el siguiente inicio.

Ventana principal Launcher

El atajo global se puede sustituir por Ctrl+Alt+Espacio, Ctrl+Mayús+Espacio, Alt+Mayús+S o Ctrl+Alt+L, en Ajustes › Ventana y atajo.

Modo mini Launcher

Pestañas y escritura Chat

Clics en el chat Chat

Añadir un favorito Launcher

1. Elige la plataforma con su pastilla (Twitch, Kick…) y escribe el nombre del canal.
2. Haz clic en la tarjeta Añadir a favoritos de la pantalla principal.

La pantalla principal muestra los favoritos de la plataforma seleccionada, primero los que están en directo. Ver todo abre la lista completa.

Iniciar, editar o quitar un favorito Launcher

• Iniciar: haz clic en su tarjeta.
• Más opciones: clic derecho en la tarjeta y luego Iniciar, Rellenar el campo, Abrir el chat (Twitch y Kick, en Streamlink Chat) o Quitar de favoritos. Con varios favoritos en directo, Abrir los chats de los favoritos en directo los abre todos a la vez, una pestaña por canal; esta opción también está en el panel Favoritos y en el menú del icono.
• En el panel Favoritos: un clic en una fila rellena el campo, ▶ inicia y la papelera quita.

¿Quién está en directo? Launcher

Con Ajustes › En directo › Comprobar quién está en directo, el lanzador revisa tus favoritos de Twitch y Kick mientras está abierto, cada 2, 5, 10, 15 o 30 minutos (5 por defecto). Vista previa de los directos añade la miniatura, el título y el número de espectadores de los favoritos de Twitch en directo (para Kick: el título y el número de espectadores, sin imagen), y Notificación de Windows te avisa cuando un favorito empieza un directo: haz clic en la notificación para verlo.

Historial Launcher

• Se guardan los últimos 200 lanzamientos. Los más recientes aparecen en Recientes; ▶ los vuelve a iniciar directamente.
• Historial completo abre el panel: un clic rellena el campo, ▶ vuelve a iniciar, la papelera borra una entrada y Borrar todo vacía el historial.
• Estadísticas, al pie del panel, muestra el tiempo por canal y tus horas punta, en los últimos 30 días o desde el principio. La duración de un stream se anota cuando termina (un minuto como mínimo); estas estadísticas se quedan en tu ordenador.
• Las sugerencias del campo de entrada vienen de tus favoritos y luego de tu historial: usa ↓ ↑ y después Intro.

Hacer una copia o pasar a otro PC Launcher

Ajustes › Copia de seguridad › Exportar… guarda tus ajustes y favoritos en un único archivo. Importar… los restaura y te deja elegir: Sí añade los favoritos importados a los tuyos, No sustituye tus favoritos y Cancelar no cambia nada. Las rutas propias del equipo (Streamlink, reproductor, scripts) no se incluyen, ni tampoco el historial.

¿Y en el chat? Chat

Streamlink Chat no tiene favoritos: los chats abiertos vuelven solos en el siguiente inicio. Cierra un chat con Ctrl+W o con un clic central en su pestaña. Para abrir siempre los mismos chats de una vez, consulta la receta Abrir tus chats desde un acceso directo.

¿Dónde están los archivos?

Cada archivo tiene una copia .bak de su versión anterior: si un archivo se daña, la aplicación lo recupera. En Launcher, Ajustes › Acerca de › Abrir la carpeta de datos abre la carpeta correcta.

¿Dónde se guardan los tokens? Chat

• En chat.json. En Windows se cifran con DPAPI: solo tu cuenta de Windows, en este PC, puede volver a leerlos.
• En Linux se guardan sin cifrar en tu carpeta personal. No compartas este archivo.
• Si copias chat.json a otro PC, los tokens no se podrán leer allí: vuelve a iniciar sesión.

Cerrar sesión y revocar el acceso Chat

• Cerrar sesión, en Ajustes › Cuentas, borra los tokens de tu PC.
• Para revocar también el acceso en Twitch, abre Configuración › Conexiones en Twitch y desconecta tu aplicación.
• En Kick, borra la aplicación en los ajustes de desarrollador.

¿De dónde vienen los emotes? Chat

Cada proveedor se puede activar o desactivar en Ajustes › Emotes. Las listas se cargan desde sus servidores al abrir un chat.

Formatos, animaciones y caché Chat

• Tk, la biblioteca gráfica, solo muestra PNG y GIF: un emote que solo se ofrece en WebP o AVIF se queda como texto.
• Los emotes animados solo se mueven en el chat que se muestra, con 40 fotogramas como máximo cada uno. Ajustes › Visualización › Emotes animados los congela todos.
• Las imágenes descargadas se guardan en cache/emotes/ para no volver a descargarlas. Esta carpeta nunca se vacía automáticamente: puedes borrarla con el chat cerrado y se reconstruye cuando hace falta.

Cómo se lee cada plataforma

Estos canales no oficiales pueden cambiar sin previo aviso. Cuando ocurre, el estado en directo queda desconocido o el chat da error hasta que se actualiza la aplicación.

Qué muestra el chat Chat

• Insignias (emisor, moderador, VIP, suscriptor…) y colores de nombre ajustados para que sigan siendo legibles con el tema.
• Respuestas, suscripciones y otros eventos. Los mensajes borrados y los de usuarios expulsados aparecen tachados.
• Los mensajes que mencionan tu nombre o una palabra de Ajustes › Menciones se resaltan, y su pestaña lo indica.

Elegir el reproductor del botón ▶ Chat

El chat inicia Streamlink sin ninguna opción de reproductor, así que Streamlink usa el de su archivo de configuración, VLC por defecto. Para pasar a mpv, crea este archivo (sin extensión) y añade:

Si mpv no está en el PATH, pon su ruta completa después de player=. Launcher también usa este archivo cuando Ajustes › Reproductor de vídeo está en Predeterminado (ajuste de Streamlink).

Ver con menos retraso

Streamlink tiene un modo de baja latencia para Twitch y Kick. Lo más sencillo es activarlo solo para una plataforma, con un archivo de configuración para su plugin, junto al archivo config:

Funciona con las dos aplicaciones. La mejora depende del emisor, que debe haber activado la baja latencia; la reproducción puede cargar un poco más a menudo.

Grabar un stream mientras lo ves

En un terminal, --record escribe el stream en un archivo mientras lo ves:

{author} se convierte en el nombre del canal y {time:…} en la fecha y la hora. Abre el archivo .ts con VLC o mpv.

Launcher Para hacerlo desde el lanzador, añade una plataforma dedicada en platforms.json (el enlace Editar platforms.json al final de los ajustes), con una ruta completa a tu carpeta de vídeos:

Reinicia el lanzador: aparece una pastilla Twitch REC. hosts se queda vacío para que los enlaces de Twitch pegados sigan yendo a la pastilla Twitch normal. En JSON, cada \ de una ruta de Windows se escribe \\.

No volver a ver «calidad no encontrada»

No todos los canales ofrecen todas las calidades. Launcher En la lista de calidades, elige Personalizada… e introduce una lista de alternativas como 720p60,720p,best: Streamlink toma la primera que exista y el lanzador la recuerda para esta plataforma. Chat La calidad del botón ▶ se elige en una lista fija; deja best si ves canales muy distintos.

Abrir tus chats desde un acceso directo Chat

Streamlink Chat acepta chats como argumentos. Crea un acceso directo de Windows (clic derecho en el escritorio › Nuevo › Acceso directo) con un destino como:

Si el chat ya está abierto, estos chats se añaden a la ventana existente. Un enlace de canal también sirve como argumento.

Consejo: primero cambia el nombre del ejecutable para quitarle el número de versión, por ejemplo StreamlinkChat.exe. Un archivo que lleva su versión en el nombre cambia de nombre en cada actualización y el acceso directo dejaría de encontrarlo. Un nombre sin versión se conserva.

Iniciar el lanzador minimizado Launcher

Ajustes › Ventana y atajo › Iniciar con Windows lo arranca en el área de notificación. Puedes hacer lo mismo con tu propio acceso directo añadiendo --tray después de la ruta del ejecutable.

Conservar tus antiguos scripts .bat Launcher

Si antes iniciabas tus streams con scripts, activa Ajustes › Avanzado › Mostrar los scripts .bat y elige la Carpeta de scripts. Una pastilla Scripts lista los archivos .bat, .cmd, .ps1, .exe, .py y .lnk de esa carpeta. El campo permite pasar un argumento al script (solo letras, cifras, ., _ y -).

El lanzador Launcher

1. Abre Ajustes › Acerca de: la tarjeta muestra tu versión y la última publicada en GitHub.
2. Si hay una versión más reciente, haz clic en Actualizar. El lanzador descarga el nuevo .exe, comprueba su tamaño y su huella SHA-256, lo pone en lugar del antiguo y se reinicia.

• Buscar actualizaciones al iniciar hace la comprobación por sí solo.
• Actualizar el lanzador automáticamente también instala la nueva versión al iniciar, nunca durante un stream.
• Un archivo que lleva su versión en el nombre (StreamlinkLauncher-1.4.2.exe) toma el nuevo número; el inicio con Windows sigue el nuevo nombre.

El chat Chat

La misma idea en Ajustes › Actualizaciones: Comprobar y luego Actualizar. El chat se reinicia con tus chats abiertos. Un punto en el botón de ajustes señala una nueva versión, y Actualizaciones automáticas (desactivado por defecto) lo hace todo solo al iniciar.

Actualizar el propio Streamlink

El lanzador compara tu versión de Streamlink con la última publicada. Si la tuya es más antigua, la tarjeta Ajustes › Streamlink ofrece Actualizar: con el instalador de Windows, abre la página de descarga; con pip, copia el comando pip install -U streamlink. Con winget, Chocolatey, Scoop o tu distribución de Linux, usa su comando de actualización habitual (winget upgrade streamlink, por ejemplo).

¿Qué hay de nuevo?

El detalle de cada versión está en el registro de cambios, en inglés y francés: Launcher, Chat. Las descargas están en las páginas de versiones: Launcher, Chat.

Lo que contacta el lanzador Launcher

Lo que contacta el chat Chat

Lo que se queda en tu PC

• Ajustes, favoritos, historial, chats abiertos: en los archivos descritos en Dónde están los archivos, en ningún otro sitio.
• Tokens de inicio de sesión (Chat): cifrados con DPAPI en Windows, sin cifrar en tu carpeta personal en Linux.
• Portapapeles (Launcher): solo se lee para detectar un enlace de stream; ni se guarda ni se envía.
• Registros: launcher.log y chat.log anotan los errores (dos archivos de 512 KB como máximo cada uno). Se quedan en tu PC salvo que los adjuntes a una incidencia.
• Registro de Windows (Launcher): un único valor, StreamlinkLauncher en HKCU\Software\Microsoft\Windows\CurrentVersion\Run, y solo si Iniciar con Windows está activado.

El lanzador en Windows Launcher

1. Si Iniciar con Windows está activado, desactívalo primero en Ajustes › Ventana y atajo.
2. Anota dónde están tus datos: Ajustes › Acerca de › Abrir la carpeta de datos. Si quieres conservar tus favoritos, haz un Exportar….
3. Cierra el lanzador: clic derecho en su icono junto al reloj › Salir.
4. Borra el .exe y después la carpeta de datos (config.json, platforms.json, streams/, launcher.log y los archivos .bak), junto al .exe o en %APPDATA%\Streamlink Launcher.

¿Ya lo borraste sin desactivar el inicio? Desactiva la entrada en el Administrador de tareas › Aplicaciones de arranque, o borra el valor StreamlinkLauncher de HKCU\Software\Microsoft\Windows\CurrentVersion\Run.

El chat en Windows Chat

1. En Ajustes › Cuentas, haz clic en Cerrar sesión para cada cuenta y, si quieres, revoca el acceso en Twitch o Kick (consulta Escribir en el chat).
2. Cierra el chat.
3. Borra el .exe, chat.json y su .bak, la carpeta cache/ y chat.log, junto al .exe o en %APPDATA%\Streamlink Chat.

En Linux Launcher Chat

Borra la AppImage y después las carpetas de datos:

Si creaste una entrada de menú con Gear Lever o AppImageLauncher, quítala desde esa herramienta.

¿Y Streamlink?

Se desinstala por separado, igual que lo instalaste: Configuración de Windows › Aplicaciones para el instalador, winget uninstall streamlink, pip uninstall streamlink o el gestor de paquetes de tu distribución. Su archivo de configuración está en %APPDATA%\streamlink o ~/.config/streamlink.

Antes de abrir una incidencia

• Actualiza la aplicación: solo la última versión recibe correcciones.
• Busca en las incidencias existentes (Launcher, Chat): puede que el problema ya se conozca.
• Repasa la Solución de problemas.

Qué incluir

• La aplicación y su versión (Ajustes › Acerca de o Ajustes › Actualizaciones).
• Tu sistema (Windows 11, Ubuntu 24.04…) y el tipo de instalación: .exe, AppImage o código fuente.
• La versión de Streamlink: streamlink --version.
• Qué hiciste, qué esperabas y qué pasó. En el caso de un chat, la plataforma y el canal.
• El registro: launcher.log o chat.log (y .log.1 si existe), en la carpeta de datos. Si un stream no arranca, copia también el texto del panel de registro.

Lee el registro antes de enviarlo. Puede contener nombres de canales o rutas de tu PC; quita lo que no quieras hacer público.

Después abre una incidencia: Launcher o Chat.

¿Una vulnerabilidad de seguridad?

No abras una incidencia pública. Usa el formulario privado de GitHub (Launcher, Chat) con la versión, los pasos para reproducirla y el impacto. Recibirás respuesta en una semana aproximadamente.

Contribuir

Los informes de errores, las traducciones y las pull requests son bienvenidos.

1. Para cualquier cosa más grande que una pequeña corrección, abre primero una incidencia para hablarlo.
2. Solo necesitas Python 3.10 o posterior, sin dependencias de terceros. Tkinter es necesario para la interfaz.
3. Ejecuta las comprobaciones antes de la pull request:

• Añade una línea bajo Unreleased en CHANGELOG.md, en inglés y en francés.
• Las versiones las publica el mantenedor.

Traducir las aplicaciones

Los textos están en lang/*.json, un archivo por idioma (fr, en, es, de, it). Todos los idiomas deben tener exactamente las mismas claves: una prueba lo comprueba. Para un idioma nuevo, copia en.json, traduce los valores sin tocar las claves ni las {variables} y mantén los textos cortos, sobre todo en el lanzador.