Documentación y Ayuda

Instalación

TikPanel se ejecuta localmente en tu ordenador Windows. Descarga el instalador y sigue estos pasos:

1. Descarga el instalador
   Ve a la página de descargas y descarga la última versión para Windows.
2. Ejecuta el instalador
   Haz doble clic en TikPanel-Setup.exe. Si aparece un aviso de Windows Defender, haz clic en "Más información" → "Ejecutar de todas formas".
3. Instalación de Node.js (automática)
   Si no tienes Node.js instalado, el instalador lo detectará y lo instalará automáticamente. Esto es necesario para que funcione el servidor local.
4. Lanza TikPanel
   Una vez instalado, el panel se abrirá automáticamente al clicar en el acceso directo que se creó en tu escritorio.

Requisitos del Sistema

Requisitos Mínimos

• Sistema Operativo: Windows 10 (64-bit) o superior
• Procesador: Intel Core i3 o equivalente
• RAM: 4 GB mínimo (8 GB recomendado)
• Disco: 500 MB de espacio libre
• Navegador: Chrome, Edge o Firefox actualizado
• Internet: Conexión estable (mínimo 5 Mbps)

Software Adicional

• Node.js 18+ (se instala automáticamente si no lo tienes)
• OBS Studio / Streamlabs / TikTok Live Studio (para capturar el overlay)

Primera Configuración

Una vez instalado, sigue estos pasos para tu primera configuración:

1. Abre el Panel de Control
   Haz doble clic en el icono de TikPanel en tu escritorio. Verás el panel de configuración con el sidebar izquierdo.
2. Conecta tu cuenta de TikTok
   En el sidebar, ingresa tu nombre de usuario de TikTok (sin @) y haz clic en "Conectar". El sistema se conectará automáticamente a tu Live. Aparecerá tu foto de perfil y un código QR para que puedas acceder rápidamente desde tu teléfono móvil.
3. Abre el Overlay
   Abre una pestaña nueva en tu navegador y pon la URL que encontrarás en la pestaña "Conectividad" de la sección Ajustes del Panel (accede desde el icono del engranaje en la parte inferior del panel de control). Esta es la dirección que añadirás como fuente de navegador en OBS.
4. Configura tus primeras alertas
   En el panel, ve a la sección "Alertas por Regalo" y personaliza cómo quieres que se vean los regalos en pantalla.

Conexión con TikTok Live

Cómo Conectar

TikPanel se conecta automáticamente a TikTok cuando inicias tu directo. Solo necesitas:

1. Estar en directo en TikTok (desde la app móvil o TikTok Live Studio)
2. Ingresar tu nombre de usuario en el panel
3. Hacer clic en "Conectar"

Solución de Problemas de Conexión

• No se conecta: Verifica que estés en directo y que tu usuario sea correcto (sin @)
• Se desconecta constantemente: Revisa tu conexión a internet o reinicia el servidor
• No lee mensajes: Asegúrate de que tu chat esté activo y no en modo privado
• Error "Failed to retrieve Room ID from all sources": Este error puede aparecer cuando TikTok realiza cambios en sus servidores. En ese caso, todas las herramientas similares se ven afectadas. Mantenemos la librería tiktok-live-connector actualizada y monitoreamos las correcciones del proyecto original.

Configurar en OBS/Streamlabs

Añadir el Overlay a OBS

1. Abre OBS Studio
   Crea una nueva escena o selecciona la que usarás para tu directo de TikTok.
2. Añade Fuente de Navegador
   Haz clic en el botón "+" en Fuentes → Selecciona "Navegador".
3. Configura la URL
   En el campo URL, pon la dirección que encontrarás en la pestaña "Conectividad" de la sección Ajustes del Panel (accede desde el icono del engranaje en la parte inferior del panel de control).
   Ancho: 1920 | Alto: 1080
4. Ajusta la fuente
   Estira la fuente para que cubra toda la pantalla. Todos los widgets de TikPanel aparecerán automáticamente en esta capa.

Para TikTok Live Studio

TikTok Live Studio también soporta fuentes de navegador. El proceso es el mismo: añade una fuente web y pega la URL que encontrarás en la pestaña "Conectividad" de la sección Ajustes del Panel (icono del engranaje).

Chat en Vivo y TTS

Configurar Lectura de Chat

TikPanel puede leer los mensajes de chat en voz alta usando diferentes motores de voz:

Configurar Google Cloud TTS (PRO)

Google Cloud Text-to-Speech ofrece voces naturales en español con excelente pronunciación. Sigue estos pasos para obtener tu API key:

1. Crear una cuenta Google Cloud (si no tienes)
   Ve a cloud.google.com y haz clic en "Consola" (esquina superior derecha). Si no tienes cuenta, crea una.
2. Crear un nuevo proyecto
   En la esquina superior izquierda, haz clic en el selector de proyecto. Click en "Crear proyecto" → Nombre: "TikPanel" → Crear. Espera a que se cree (puede tardar unos segundos).
3. Habilitar la API de Text-to-Speech
   En la barra de búsqueda superior, busca "Text-to-Speech" → Click en "Cloud Text-to-Speech API" → Click en "Habilitar".
4. Crear una clave de servicio
   En el sidebar izquierdo, ve a "Credenciales" → Click en "Crear credenciales" → Selecciona "Cuenta de servicio" → Nombre: "tikpanel-tts" → Crear y continuar → (Deja roles en blanco) → Crear.
5. Descargar el archivo JSON
   En la tabla de cuentas de servicio, haz clic en la que acabas de crear. Ve a la pestaña "Claves" → "Agregar clave" → "Crear clave nueva" → Tipo "JSON" → Crear. Se descargará automáticamente un archivo .json.
6. Subir el archivo a TikPanel
   En el panel de TikPanel, ve a "Configuración" → "TTS" → "Google Cloud". Click en "Seleccionar archivo" y carga el .json que descargaste.
7. Elegir voz y probar
   Selecciona tu voz favorita (ej: "es-ES-Standard-A") y haz clic en "Probar voz". Deberías escuchar una frase de ejemplo en español.

Configurar SpeechActors (PRO - Voces Españolas)

SpeechActors ofrece más de 20 voces en español de España con diferentes estilos emotivos. Es la opción ideal si buscas voces naturales en español a buen precio.

1. Crear cuenta en SpeechActors
   Ve a speechactors.com → Click en "Sign Up" → Completa tu email y contraseña → Verifica tu email.
2. Obtener tu API Key
   Una vez logueado, ve a tu panel de usuario → Busca la sección "API Keys" o "Developer" → Copia tu API key.
3. Configurar en TikPanel
   En el panel de TikPanel, ve a "Configuración" → "TTS" → Selecciona "Voz Premium (SpeechActors)" → Pega tu API key en el campo correspondiente.
4. Elegir voz y estilo
   Selecciona tu voz favorita entre las opciones masculinas y femeninas disponibles. También puedes elegir un estilo emotivo: default (natural), cheerful (alegre), excited (entusiasta), friendly (cálida), angry (intensa), whispering (susurro) o newscast (presentador de noticias).
5. Probar la voz
   Haz clic en "Probar voz" para escuchar una muestra en español con la voz y estilo seleccionados.

Configurar Unmixr (PRO - Control Total)

Unmixr ofrece más de 1100 voces con control completo de velocidad, tono, volumen e intensidad. Es la opción más flexible para personalizar tu voz TTS.

1. Crear cuenta en Unmixr
   Ve a unmixr.com → Click en "Sign Up" → Completa tu email y contraseña → Verifica tu email.
2. Obtener tu API Key
   Una vez logueado, ve a Manage API Keys → Crea una nueva API key → Copia tu key.
3. Configurar en TikPanel
   En el panel de TikPanel, ve a "Configuración" → "TTS" → Selecciona "Voz Premium (Unmixr)" → Pega tu API key en el campo correspondiente.
4. Elegir voz y ajustar parámetros
   Selecciona tu voz favorita entre las opciones masculinas y femeninas disponibles. Ajusta los parámetros: Velocidad de -100% (muy lenta) a +100% (muy rápida), Tono (Pitch) de -50% a +50%, Volumen de -100% a +100% e Intensidad de -100 a +100 (efecto dramático).
5. Probar la voz
   Haz clic en "Probar voz" para escuchar una muestra. El saldo de créditos se muestra en tiempo real.

Configurar ElevenLabs (PRO - Máxima Calidad)

ElevenLabs ofrece las voces más realistas disponibles. Es la opción premium para quienes quieren la mejor calidad de audio. Aquí está cómo configurarlo:

1. Crear cuenta en ElevenLabs
   Ve a elevenlabs.io → Click en "Registrarse" → Completa tu email, contraseña y nombre → Verifica tu email (revisa tu bandeja de entrada y spam).
2. Acceder a tu API Key
   Una vez logueado, haz clic en tu perfil (esquina superior derecha) → "Perfil" → "API Key" → Click en el ícono de copiar para copiar tu API key a portapapeles.
3. Subir la API Key a TikPanel
   En el panel de TikPanel, ve a "Configuración" → "TTS" → "ElevenLabs" → Pega tu API key en el campo correspondiente → Guardar.
4. Elegir una voz
   En la misma sección, selecciona la voz que prefieras. Opciones populares en español: Bella (voz femenina cálida, la más popular), Callum (voz masculina profesional) o Matilda (voz femenina clara y dinámica).
5. Obtener el ID de voz (si necesitas personalizarlo)
   Ve a elevenlabs.io/app/voice-lab → Bajo cada voz, verás un código largo (ej: 21m00Tcm4TlvDq8ikWAM) → Este es el "Voice ID". Si seleccionas una voz predefinida en TikPanel, ya está configurado automáticamente.
6. Probar la voz
   En el panel de TikPanel, haz clic en "Probar voz" para escuchar una muestra en español.

Comparativa de Motores TTS

Filtros Anti-Spam

TikPanel incluye filtros inteligentes para evitar saturación:

• Detección de combos: Si alguien envía 20 rosas, el bot dirá "Usuario envió 20 rosas" en lugar de leer "rosa" 20 veces
• Bloqueo de comandos: Ignora textos entre corchetes [ ] para evitar manipulación del TTS
• Cooldown de usuario: Limita cuántas veces puede hablar el mismo usuario por minuto

Modo VIP (PRO)

El Modo VIP es la funcionalidad más solicitada para monetizar tu chat. Cuando lo activas, solo los usuarios que hayan enviado un regalo podrán hablar por voz.

¿Cómo Funciona?

1. Activa "Modo VIP" en la sección de Chat
2. Define cuántas horas dura el VIP (ej: 2 horas)
3. Elige en el listado desplegable el regalo que activa el chat de voz
4. Opcionalmente, incluye a Moderadores automáticamente o incluye manualmente el nombre de los usuarios (sin la @)que serán VIP sin necesidad de enviar el regalo.

Ejemplo de Uso

Configuración típica: "Modo VIP activado, duración 2 horas, incluye moderadores". Resultado: Solo quienes envíen el regalo que has elegido en el desplegable, podrán hablar por voz durante las próximas 2 horas.

Alertas Personalizadas

Tipos de Alertas

TikPanel soporta alertas visuales para múltiples eventos:

• Regalos específicos: Asocia un vídeo .webm a cada regalo (ej: Rosa, León, Universo)
• Alertas por valor: Configura animaciones especiales para regalos de +1000 monedas
• Follows y Shares: Notifica cuando alguien te sigue o comparte tu Live
• Nuevos espectadores: Da la bienvenida a nuevos viewers

Formato de Vídeo

Sistema de Colas Dual

TikPanel utiliza un sistema dual de colas independientes para garantizar que ningún evento bloquee a otro. Esto significa que puedes tener eventos de chat reproduciéndose mientras las alertas de regalos se ejecutan en paralelo, sin interrupciones.

¿Por Qué Dos Colas?

En streaming en vivo, diferentes tipos de eventos ocurren simultáneamente:

• Eventos cortos: Mensajes de chat, nuevos followers, suscripciones
• Eventos largos: Alertas de vídeo (2-5 segundos), MVPs personalizados

Si usáramos una sola cola, un vídeo de alerta de 5 segundos haría esperar los mensajes de chat. Con dos colas, ambos se reproducen en paralelo sin bloquearse.

Cola de Eventos

Procesa eventos de chat y TikTok de corta duración: mensajes de chat (1-3 segundos), nuevos followers, suscripciones, entradas al Fan Club y level-ups. Se procesan secuencialmente sin bloquear la cola de alertas.

Cola de Alertas

Procesa eventos visuales de larga duración: regalos con vídeo, combos agrupados, alertas por monedas (PRO) y MVPs personalizados (PRO). Funciona en paralelo a la cola de eventos, sin delay bloqueante.

¿Cómo Funcionan en Paralelo?

Control Manual (PRO)

En la versión PRO, puedes reordenar eventos manualmente usando drag & drop en el panel de control. Es útil si quieres que un evento específico se reproduzca antes que otro.

1. Abre el Panel de Debug de Colas
   En el panel de TikPanel, ve a "Debug" → "Colas". Verás ambas colas en tiempo real.
2. Arrastra eventos
   Haz clic y arrastra cualquier evento a una nueva posición. Se reproducirá en el nuevo orden.
3. Pausa la cola
   Puedes pausar una cola temporalmente si necesitas un momento sin interrupciones.

Solución de Problemas

Un evento no se reproduce o la cola se detiene

• Intenta reordenar manualmente con drag & drop en el panel
• Reinicia TikPanel y vuelve a conectar
• Verifica que el navegador no tenga errores en la consola

El chat se reproduce pero no las alertas (o viceversa)

• Verifica que ambas colas estén habilitadas
• Revisa en el panel de control que los sonidos/vídeos no estén deshabilitados
• Asegúrate de que tu conexión a internet sea estable

Widgets Adicionales

TikPanel incluye tres widgets adicionales que puedes añadir a tu overlay para enriquecer tu transmisión:

Configurar el Widget de Música con Last.fm

El widget de música necesita una conexión a Last.fm, un servicio gratuito que "scrobea" (registra) las canciones que escuchas. Last.fm se conecta a tu Spotify o Apple Music (vía Cider) y muestra automáticamente qué canción estás reproduciendo.

Paso 1: Crear una cuenta en Last.fm

1. Ve a Last.fm
   Abre last.fm/join en tu navegador.
2. Completa el registro
   Ingresa un nombre de usuario, correo electrónico y contraseña. Verifica tu email en la bandeja de entrada.
3. Confirma tu cuenta
   Haz clic en el enlace de confirmación que recibiste por email. Tu cuenta de Last.fm estará lista.

Paso 2: Conectar tu Plataforma de Música (Spotify o Apple Music)

Opción A: Spotify — Conexión directa con Last.fm, sin costo adicional. Es la opción más simple.

1. Inicia sesión en Last.fm
   Ve a last.fm/home e inicia sesión con tu cuenta.
2. Accede a Configuración
   Haz clic en tu perfil (esquina superior derecha) → "Configuración".
3. Conectar Spotify
   En el menú superior, ve a "Aplicaciones" → "Spotify Scrobbling" → "Conectar" → Autoriza a Last.fm.
4. ¡Listo!
   Ahora Last.fm escrobea automáticamente todas las canciones que reproduces en Spotify.

Opción B: Apple Music (requiere Cider) — Requiere Cider (~$4-5 de pago único). Una vez comprado, funciona igual de bien que Spotify.

5. Descarga Cider
   Cider es una aplicación de pago único (~$4-5 USD) que te permite usar Apple Music desde tu PC con mejor control. Descárgalo desde cider.sh. Una vez pagado, lo tienes para siempre sin suscripciones adicionales.
6. Instala y abre Cider
   Ejecuta el instalador y abre Cider. Inicia sesión con tu cuenta de Apple ID.
7. Habilita Scrobbling en Cider
   En Cider, ve a Configuración → "Conectivity" → "Last.fm" → Haz clic en "Conectar" → Autoriza con tu cuenta de Last.fm.
8. Reproduce música en Cider
   Ahora cuando reproduces canciones en Cider, se registran automáticamente en Last.fm.

Paso 3: Obtener tu API Key de Last.fm

1. Accede a Last.fm API
   Ve a last.fm/api/account/create
2. Completa el formulario
   Ingresa los siguientes datos: Nombre de la aplicación: "TikPanel" (o lo que prefieras). Descripción: "Widget de música para TikTok Live". URL de la aplicación: la dirección que aparece en la pestaña "Conectividad" de la sección Ajustes del Panel (icono del engranaje). Descripción de qué hace: "Muestra la canción actual en overlay de transmisión en vivo".
3. Acepta los términos
   Marca "I agree to the terms of service" y haz clic en "Crear aplicación".
4. Copia tu API Key
   Una vez creada, verás una página con tu "API Key" (una cadena larga de caracteres como a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6). Copia esta clave (usa el botón copiar o selecciona el texto).

Paso 4: Configurar la API Key en TikPanel

1. Abre el Panel de TikPanel
   Lanza tu aplicación de TikPanel. En el menú lateral, dentro de Widgets, haz clic en Música en Pantalla.
2. Ve a la sección "Conexión con Last.fm"
   Esta es la primera sección bajo el título verde "1. Conexión con Last.fm". Encontrarás dos campos: Usuario de Last.fm (ingresa tu nombre de usuario de Last.fm, el mismo que creaste en el Paso 1) y API Key de Last.fm (pega aquí tu clave API que copiaste en el Paso 3).
3. Guarda los cambios
   Pulsa sobre el botón "Guardar". El panel guardará los ajustes en tu perfil.
4. Estilo visual
   Podrás elegir entre dos diseños distintos (verde, con logo de Spotify o rojo, con logo de Apple Music) y decididr si quieres que se visualice constantemente o solo cuando cambias de canción.

Juegos Interactivos PRO

TikPanel incluye juegos interactivos donde tus espectadores pueden participar directamente desde el chat de TikTok Live enviando regalos.

4 en Raya

El clásico juego de conectar 4 fichas, reinventado para TikTok Live. Tus espectadores juegan contra ti (el streamer) enviando regalos asignados a cada columna del tablero.

Cómo funciona

1. Activa el juego desde la pestaña "Juegos" en el panel (solo PRO)
2. Asigna regalos a columnas: Cada columna (1-5) tiene un regalo asignado. Cuando un espectador envía ese regalo, se coloca una ficha en esa columna.
3. Turnos alternos: Primero juega un espectador (ficha amarilla), luego juegas tú (ficha roja), y así sucesivamente.
4. Ganar: El primero en conseguir 4 fichas seguidas en horizontal, vertical o diagonal gana la partida.

Overlay en OBS

El tablero aparece automáticamente en tu overlay cuando activas el juego. Se muestra:

• El tablero 5x5 con las fichas colocadas
• Indicador de turno (Espectador o Streamer)
• Lista de regalos asignados a cada columna
• Mensaje de victoria cuando alguien gana

Control con Stream Deck

Puedes activar/desactivar el juego rápidamente con un botón de Stream Deck usando el webhook 4enraya-toggle.

Integración Stream Deck (PRO)

Los usuarios PRO pueden controlar TikPanel desde un Stream Deck físico usando webhooks:

Configurar Botones

1. Ve a la pestaña "Stream Deck" en el panel
2. Copia la URL del webhook que quieres usar (ej: Toggle Chat, Siguiente Titular)
3. En Stream Deck, crea una acción "Website"
4. Pega la URL y marca "GET request en segundo plano"

Acciones Disponibles

• Toggle Chat Visual
• Toggle Alertas
• Mostrar/Ocultar Titular
• Siguiente/Anterior Noticia
• Control de Batallas (Inicio, Guante, x2, x3, Fin)
• Toggle Juego 4 en Raya (activar/desactivar)

Preguntas Frecuentes

¿Puedo usar TikPanel con Mac o Linux?

Actualmente TikPanel solo está disponible para Windows. Estamos evaluando soporte para otros sistemas operativos en futuras versiones.

¿TikPanel funciona con otras plataformas como Twitch?

No, TikPanel está diseñado específicamente para TikTok Live y usa su API oficial.

¿Puedo perder mi cuenta de TikTok por usar esto?

No. TikPanel se conecta a TikTok Live de forma legítima leyendo el chat público. No viola términos de servicio ni realiza acciones no autorizadas en tu cuenta.

¿La versión FREE tiene marca de agua?

Sí, la versión FREE incluye una pequeña marca de agua visual en el overlay. Al actualizar a PRO, la marca de agua desaparece completamente.

¿Qué pasa si TikTok cambia su API?

Nos comprometemos a actualizar TikPanel lo antes posible cuando haya cambios en la API de TikTok. Los usuarios PRO reciben actualizaciones gratuitas automáticamente.

Solución de Problemas

El panel no se abre en el navegador

1. Busca la ventana del panel
   Aunque el panel se abre automáticamente, puede estar detrás de otras ventanas o minimizada. Presiona Alt + Tab para ciclar entre ventanas abiertas y busca "TikPanel". Si la encuentras, haz clic en ella.
2. Accede manualmente desde el navegador
   Abre tu navegador (Chrome, Edge o Firefox) y ve a la URL del panel que encontrarás en la pestaña "Conectividad" de la sección Ajustes del Panel (icono del engranaje en la parte inferior del panel de control). Debería cargar el panel de control.
3. Si nada funciona, reinicia TikPanel
   Presiona Ctrl + Q en la ventana del panel para cerrarlo completamente. Luego, haz doble clic en el icono de TikPanel en tu escritorio para abrirlo nuevamente.

No aparecen las alertas en OBS

• Verifica que la URL en OBS sea la que aparece en la pestaña "Conectividad" demtro de la sección de Ajustes de tu panel.
• Utiliza la herramienta "Limpiar caché ahora", que encontrarás en la pestaña "Mantenimiento" de la sección de Ajustes de tu Panel.
• En OBS, accede a las propiedades de la fuente de navegador → "Actualizar la caché de la página actual"
• Revisa que el tamaño sea 1920x1080 y que cubra toda la escena

La voz TTS no funciona

• Google / Microsoft: Verifica que tu navegador tenga soporte para Web Speech API y que las voces en español estén disponibles
• Google Cloud: Revisa que tu API key sea válida y tenga créditos
• ElevenLabs: Confirma que tu suscripción esté activa

El chat no se lee o se desconecta

• Asegúrate de estar en directo cuando intentas conectar
• Verifica que tu usuario sea correcto (sin @)
• Revisa tu firewall o antivirus (puede estar bloqueando la conexión)
• Si ves el error "Failed to retrieve Room ID from all sources" o "Usuario no encontrado", esto indica que TikTok ha realizado cambios en sus endpoints. Consulta la sección "Conexión con TikTok Live" arriba para más detalles.