Aplicación para Windows que te da la URL y la clave de retransmisión de TikTok Live para pegarlas en OBS Studio. La sesión se prepara a través de Streamlabs.
No emite vídeo ni configura OBS: eso pasa cuando OBS se conecta con esos datos.
| Ventana principal, tema claro | Ventana principal, tema oscuro |
|---|---|
 |
 |
La pantalla de cuenta, donde se carga el token, se comprueba el permiso y se elige la foto (en la imagen, con una puesta):
irm https://raw.githubusercontent.com/tacosandtypescript-debug/StreamLabsTikTokStreamKeyGenerator/main/install.ps1 | iexEl comando descarga la última versión, verifica su checksum y la instala en tu carpeta de usuario con acceso directo. No pide permisos de administrador.
Como el comando ejecuta un script, conviene saber qué ejecuta: es corto y legible —
install.ps1.
La release también publica un Setup-*.exe. Es una instalación por usuario
(sin administrador) que aparece en Aplicaciones instaladas, crea los accesos
directos y se desinstala desde ahí.
Si ya tienes la aplicación instalada, puede actualizarse sola: al detectar una versión nueva te ofrece Instalar ahora, descarga el instalador, comprueba su checksum, se cierra y vuelve a abrirse ya actualizada. Nunca lo hace mientras hay un directo preparado, y siempre puedes elegir Descargar para hacerlo tú.
| ⬇️ Última versión | El Setup-*.exe de Windows + SHA256SUMS.txt |
| Todas las versiones | Historial |
| Compilación automática | Estado de la última compilación |
| Estado de las pruebas | Ubuntu, Windows y macOS |
Las releases publican solo el instalador de Windows. El código sigue siendo multiplataforma y las pruebas se ejecutan en los tres sistemas, pero no se compilan binarios para macOS ni Linux.
Comprueba el checksum antes de ejecutarlo:
Get-FileHash .\StreamLabsTikTokStreamKeyGenerator-win-<versión>.zip -Algorithm SHA256Compara el valor con su línea de SHA256SUMS.txt. Si no coincide, no lo
ejecutes: vuélvelo a descargar.
- Abre la aplicación.
- Iniciar sesión web (recomendado) o Cargar desde el PC si usas Streamlabs Desktop. También puedes pegar un token a mano.
- Actualizar datos de la cuenta → debe aparecer Puede emitir: True.
- Opcional: Guardar token de forma segura para no repetir el login.
- Escribe el título y la categoría → Preparar directo → Copiar URL y Copiar clave.
La ventana es redimensionable, pero no hace falta redimensionarla: se abre exactamente del tamaño que pide su contenido y su mínimo es 430 × 360. Tiene formato móvil — estrecha y alta, 430 × 909 — y todo va en una sola columna: banner, perfil, tarjetas, botones y resumen, apilados en vertical, que es la forma que se coloca bien al lado de OBS. Sigue el tema del sistema: si Windows está en modo oscuro, la aplicación sale en oscuro. Te dice en todo momento en qué punto estás: el banner de arriba cambia de color y de texto («Sin token», «Cuenta sin validar», «Listo para preparar el directo», «Directo preparado»), la franja de resumen contesta de un vistazo si hay cuenta, si puede emitir y si ya hay una sesión abierta, y la barra de abajo muestra qué está pasando mientras se consulta la cuenta o se prepara la sesión.
El token y el permiso de emisión están en una segunda pantalla, para que la principal tenga solo lo que se usa antes de cada directo: se entra con el botón Cuenta y token y se vuelve con Volver al directo. La primera vez que abres la aplicación, esa pantalla es la que aparece.
Compara la interfaz anterior con la actual, capturadas de la aplicación real:
docs/interfaz.html.
La cabecera del perfil aparece arriba en las dos pantallas —en la principal, nada más abrir— y es como la de la propia red pero sin nada social: ni seguir, ni mensajes, ni compartir. Se rellena solo con lo que se puede comprobar, y lo que no se sabe no se inventa:
| Dato | De dónde sale |
|---|---|
| Foto del perfil | unavatar.io, que la resuelve desde TikTok |
| Me gusta y seguidores | microlink.io, que lee el perfil público |
Nombre y @usuario |
De Streamlabs, con la cuenta validada |
| Puede emitir | De Streamlabs (can_be_live); también decide la casilla de adultos |
Lo que no se puede: el número de «Siguiendo» no aparece en ninguna de las dos fuentes, y el nombre para mostrar es el mismo que el usuario salvo que TikTok publique otro. Cuando falta un dato, esa línea simplemente no se dibuja.
Las dos consultas se guardan en tu equipo (la foto y profile.json, en la carpeta de
configuración) y se hacen como mucho una vez al día: los planes gratuitos de esos
servicios permiten 25 consultas diarias, así que la aplicación no las gasta en cada
arranque. Usar la de la cuenta las fuerza cuando quieras, y también puedes poner
una imagen tuya con Elegir imagen…, y entonces el avatar no se consulta nunca más.
Quitar vuelve a la inicial dibujada.
Los emoji de la bio vienen de TikTok. Si tu sistema tiene una fuente de emoji (Windows la trae de serie), se dibujan; si no la tiene, se quitan en lugar de aparecer como cuadros vacíos: una frase sin emoji se lee perfectamente, y un cuadro parece una aplicación rota.
Si no hay foto, o el servicio no contesta, se dibuja un círculo con tu inicial con un color que depende solo del nombre: dos cuentas nunca se confunden.
La casilla Contenido para adultos depende de lo que Streamlabs responda para tu cuenta: si tu cuenta no puede usarlo, aparece deshabilitada y explicada.
| Atajo | Qué hace |
|---|---|
Ctrl+Intro |
Preparar directo |
Ctrl+Mayús+Intro |
Finalizar directo |
Ctrl+D |
Guardar el informe de diagnóstico |
Ctrl+L |
Abrir la carpeta de registros |
F1 |
Ayuda |
Ajustes → Emisión → Servicio: Personalizado → pega la URL del servidor y la Clave de retransmisión → Aplicar.
Al terminar, detén primero la salida de TikTok en OBS y después pulsa Finalizar directo para cerrar la sesión en Streamlabs (si la dejas abierta, TikTok puede rechazar el siguiente directo).
Si la aplicación se cierra de golpe con un directo preparado, al volver a abrirla te ofrecerá cerrar esa sesión pendiente.
- Se guarda cifrado en el almacén de credenciales de Windows. Nunca en
config.json. - La aplicación no lo imprime ni lo escribe en los registros.
- No lo publiques en un issue ni en una captura. Lee
SECURITY.md.
| Problema | Qué hacer |
|---|---|
| Puede emitir: False | Tu cuenta no tiene acceso LIVE vía Streamlabs: solicítalo (no hacen falta 1000 seguidores). |
| Preparar directo deshabilitado | Valida la cuenta y elige una categoría de la lista. |
| «El token ha caducado» | Vuelve a Iniciar sesión web. |
| OBS no conecta | Finalizar directo y Preparar directo otra vez (las claves caducan). |
| Finalizar directo muestra un error | La app reintenta los fallos temporales y conserva la sesión para volver a pulsarlo. Si la sesión ya había terminado, un 404 se considera cierre correcto. |
| «No hay almacén seguro» | Falta el almacén de credenciales de Windows. La app sigue funcionando, pero el token no se puede guardar cifrado. |
| Antivirus avisa | Es por Cargar desde el PC, que lee el almacén de Streamlabs Desktop (la misma técnica que usan los ladrones de credenciales). Usa Iniciar sesión web. |
| Necesitas ayuda | Más → Informar de un problema: abre una incidencia ya rellenada con la versión y el sistema. Si puedes, adjunta también el informe. |
| Quieres el informe | Más → Guardar informe de diagnóstico deja un ZIP: lleva tus datos de entorno y el registro, sin tokens ni claves. |
El informe incluye la versión, el sistema, dónde está instalada la aplicación y las últimas líneas del registro, todo pasado por un filtro que borra el token y la clave de retransmisión. Es lo que hay que adjuntar en una incidencia.
Informar de un problema abre el navegador con la incidencia medio escrita. En el texto solo van los datos que no identifican tu equipo —versión, sistema, arquitectura y si el almacén de claves está disponible—; las rutas se quedan fuera a propósito, porque llevan tu nombre de usuario, y por eso el informe completo se adjunta aparte si quieres.
StreamLabsTikTokStreamKeyGenerator --version # qué versión es
StreamLabsTikTokStreamKeyGenerator --check # ¿este binario funciona?--check construye la ventana de verdad pero sin mostrarla, mira lo que ha salido y lo
cuenta: si Qt cargó, si el icono está, si las dos pantallas existen, si el tamaño es
utilizable y qué fuente de emoji encontró. Termina con 0 si está bien y con 1 si
falta algo imprescindible, y deja el informe en la carpeta de registros.
La integración continua lo ejecuta sobre el binario ya empaquetado antes de publicar la release: el código fuente puede estar perfecto y al paquete faltarle una pieza, que es justo lo que pasó una vez con los emoji.
El registro identifica cada operación, endpoint, código HTTP, duración y campos ausentes cuando una respuesta cambia. No guarda títulos, tokens, claves, respuestas completas ni identificadores de sesión.
Python 3.11 o superior. Todas las dependencias en un comando:
python -m pip install -r https://raw.githubusercontent.com/tacosandtypescript-debug/StreamLabsTikTokStreamKeyGenerator/main/requirements.txtO el flujo completo:
git clone https://github.com/tacosandtypescript-debug/StreamLabsTikTokStreamKeyGenerator.git
cd StreamLabsTikTokStreamKeyGenerator
python -m pip install -r requirements.txt
python StreamLabsTikTokStreamKeyGenerator.pyPara desarrollar: python -m pip install -r requirements-dev.txt, ruff check .
y pytest (441 pruebas, también de la interfaz). Los iconos se regeneran con
node tools/make_icons.mjs y los manifiestos de winget con
python tools/make_winget_manifest.py.
En Windows, si
pythonabre la Microsoft Store es que solo tienes el alias: instala Python desde python.org marcando Add python.exe to PATH.
- Usa los endpoints internos de Streamlabs Desktop, no una API pública: si Streamlabs cambia su aplicación, puede dejar de funcionar. El riesgo de los términos de servicio recae sobre la cuenta que autoriza.
- Los binarios no están firmados: Windows SmartScreen puede avisar. Comprueba siempre el checksum.
GPL-3.0 — consulta LICENSE.txt. Obra original de
Loukious; este
repositorio es una versión derivada, endurecida y traducida. La interfaz —formato
móvil en una columna, la paleta de TikTok, la cabecera del perfil y los iconos
dibujados— es trabajo derivado de esta misma versión, y sigue por tanto bajo la
misma licencia y con los mismos autores acreditados.
Las fotos de perfil se obtienen con unavatar.io y los datos públicos del perfil, con microlink.io.
Las capturas de docs/interfaz.html no son maquetas: las
genera tools/capture_ui.py, que construye la ventana de verdad, la deja asentar y
guarda lo que Qt dibuja. Se regeneran con
python tools/capture_ui.py docs/despues 1040El primer argumento es la carpeta de salida. El segundo, opcional, es la altura de
pantalla que se le supone al escritorio. Conviene darlo: Qt en modo offscreen
informa de una pantalla de 800 px, la ventana nunca se abre más alta que la pantalla,
y sin ese dato la captura saldría con una barra de desplazamiento que el escritorio
real no tiene.
Este repositorio deriva de Loukious/StreamLabsTikTokStreamKeyGenerator y su historia viene de allí: el primer commit es el mismo. Está al día con él, y no se sincroniza solo a propósito —la aplicación se ha reescrito entera, así que un merge automático daría conflictos en casi todos los ficheros—. En su lugar hay un aviso semanal que abre una incidencia cuando el original publica algo nuevo, con la lista de cambios; cerrarla significa «visto».