TIKBOX.live

Controla tu directo sin desorden

Un panel claro para coordinar TikTok, avatar, voz, eventos y producción OBS con menos fricción.

Acciones más rápidas Conecta, configura y prueba sin saltar entre pantallas.
Mensajes más claros Errores y avisos con pasos concretos para resolver al momento.
Flujo en vivo estable Visibilidad de estado para operar sin perder tiempo durante stream.
Tu sesión usa autenticación JWT y permisos por usuario.
Acceso seguro

Ingresa al panel

Usa tu cuenta para administrar overlays, reglas y automatizaciones del directo.

¿Olvidaste tu contraseña?

¿Eres nuevo? Crear cuenta

Consejo: usa tu correo en perfil para recuperar acceso rápido.

¿Ya tienes cuenta? Inicia sesión

Recuperar acceso

Ingresa tu email o nombre de usuario para recibir un enlace de recuperación.

TIKBOX.live Control Center

Panel de Operaciones

Flujo simplificado para operar el live sin confusiones ni saltos innecesarios.

...
PRO
Superadmin Viendo a: ...
Conexión TikTok
Sin conectar
Conecta para recibir eventos en tiempo real.
Automatización
Revisar
Activa servicio y acciones para operar completo.
Vista activa
En vivo
Monitorea eventos y lanza pruebas desde aquí.
  • TokFantasma
Operación en vivo

Monitor + reglas + acciones

Conecta TikTok y gestiona automatizaciones sin saltar entre secciones.

Estado del sistema
Todo funcionando correctamente.
TIKTOK LIVE MONITOR
OFFLINE Control remoto
Necesario para que el motor envíe mensajes automáticos al chat.
LECTOR DE CHAT (AUTOPLAY)
La configuración completa ahora vive en Overlays Tools. Usa el nuevo panel para activar el lector, elegir voces, filtros y prefijos personalizados.
STATUS: DISCONNECTED EVENTS: 0 ROOM: --- UPTIME: --:--:--
$ ▌

🎬 Acciones

Selecciona hasta 5 archivos. Puedes asignar un usuario a cada video.
💡 Etiquetas Disponibles (Clic para insertar)
Haz clic primero en el campo Usuario asignado del video y luego en una etiqueta.
{usuario}: Usuario que disparo el evento
💡 Ver variables disponibles (Etiquetas)
{usuario}: Nombre del usuario
{uniqueId}: ID único
{nivel}: Nivel donador
{nivel_fans}: Nivel Superfans / Fans Club
{regalo}: Nombre del regalo
{seguidores}: Seguidores
{diamantes_totales}: Diamantes totales
{diamantes}: Cantidad diamantes
{mensaje}: Texto del chat
{likes}: Toques pantalla
SINTETIZADOR DE VOZ (TTS)
Usa los datos del mensaje ({usuario}) para proyectar el nombre y foto encima del overlay.

🧩 Plugin OBS

CONFIGURACIÓN OBS
Overlay sobre cabeza
Usa la media cargada y la coloca sobre la cabeza.

⚡ Eventos

CONFIGURACIÓN BÁSICA
FILTROS DE NIVEL
ESTATUS Y PODER DEL USUARIO
* Se normaliza automaticamente y compara contra uniqueId, username, nickname, display_name y userId.
* Los regalos no permiten 'Any' para evitar colapsar el sistema.
ACCIÓN A EJECUTAR
Nueva Acción

Panel de enlaces

🧰 Overlays Tools

Colección curada de URLs listas para pegar en OBS. Agrupa tus overlays por categoría y duplica las tarjetas para añadir más bloques.

Beta
Plugin OBS de TIKBOX.live
Plugin protegido por función. Solo lo ven admin o usuarios con permiso.
Descarga final

Descarga el paquete final compilado para macOS. Incluye el plugin listo para instalar y un instalador que lo copia a OBS.

El acceso se valida por función en usuarios. Windows requiere un build aparte.
Instalación rápida
  1. Descarga el paquete final desde el panel.
  2. Ejecuta `install.command` para copiar el plugin a OBS.
  3. Reinicia OBS y añade la fuente `TIKBOX.live Face Overlay`.
  4. Descarga el bridge local desde el panel si quieres tracking automático.
  5. El JSON local queda en `~/.mariita-obs-bridge/tracking_state.json`.
Alertas base del live
URLs generales que combinan join, likes, gifts y chat.
URL Master
Join + Likes + Gifts + Chat
Core

Overlay principal con todas las alertas y el avatar activo. Ideal como base para escenas con cámara.

...
Respeta el TTS y el lipsync configurado.
Engagement & Rankings
Herramientas de ranking, Rey TopTap y efectos de celebración.
TopTap Leaderboard
Ranking en tiempo real
Rey

Muestra el top de likes y dispara el evento TopTapKing cuando cambia el #1.

...

Autoplay

📣 Lector de Chat

Configura el TTS que lee el chat: activa/desactiva, elige voces Edge/Clone, ajusta velocidad/pitch y define quién puede usarlo.

General Settings
Gestiona tus clones en la pestaña "Voz clonada".
Usa el servidor Edge para acento latino natural.
Usa {usuario} y {mensaje}. Ej: {usuario} comenta {mensaje}
Allowed Users

Selecciona de forma rápida quién tiene permiso para que el lector lea sus mensajes.

Todos limpia mods, fans, suscriptores y el prefijo de lectura.
Define el nivel mínimo (fans o donadores) requerido para que los lea.
Trigger
Ejemplo: si usas !, solo leerá mensajes que empiecen con !.
Combina prefijos con el filtro anterior y el nivel mínimo para tener lecturas súper controladas.

Debes tener esta URL abierta en OBS (fuente navegador 1080×1920 / solo chat) para que el bot lea los mensajes.

...

Ambient FX

✨ Floating Emojis

Activa un overlay 1080×960 que lanza emojis/PNGs flotando desde abajo como globos transparentes.

Loop infinito
Se usa cuando no defines imagen. Máx 4 caracteres.
Si colocas URL, saldrán mini PNGs en vez de emoji.
...
Pega la URL en OBS como navegador (1080×960). Ajusta el emoji o PNG cuando quieras y vuelve a copiar la URL.

Playlist

🎛️ Overlay de Acciones

Activa/desactiva qué acciones se pueden reproducir en un overlay dedicado sin interrumpir la cola actual.

Nuevo

Abre el panel de control para seleccionar en vivo qué acciones se permiten. La URL del overlay se genera allí y sólo necesitas pegarla una vez en OBS.

👤 Mi Perfil

Importante: No tienes un correo electrónico registrado. Por favor, ingresa uno para poder recuperar tu contraseña en el futuro.
Información Personal
Seguridad

Aquí podrás cambiar tu contraseña pronto.

Pronunciación de Emojis
Define cómo quieres que el bot lea los emojis en el chat. Los que no estén en esta lista se ignorarán.
EMOJI LECTURA TTS ACCIÓN
Cargando reglas...

🎛 Botonera OBS Programable

Drag & Drop
Arrastra una escena desde el panel derecho a uno de los 8 botones del centro. Cada página tiene 8 slots.
Slots de esta página
Haz click en el botón para ejecutar la escena. Arrastra para programar.
Página 1 / 1
Plugin OBS TIKBOX.live
Instala la fuente nativa en OBS. El ZIP final se descarga listo para macOS.
Conexión OBS
Activa este modo si OBS corre en tu PC local y el motor vive en VPS.
URL Botonera Remota
Cópiala para abrir la botonera en móvil o en otra web.
Escenas de OBS

🪄 Configuración del Avatar

3-STATE AI
Sube 3 imágenes para crear el efecto de habla: Reposo (1), Boca Abierta (2) y Boca Media/Cerrada (3). El bot alternará entre 2 y 3 mientras habla.
🧠 SISTEMA ACTIVO
✨ ACCIONES RÁPIDAS
🎧 DJ AVATAR (SPOTIFY)
Activa este modo para que tu avatar anuncie automaticamente lo que suena y lo que viene en cola.
Spotify no conectado
Sin reproduccion detectada.
App de Spotify
Spotify Premium
Configura tu propia app de Spotify para habilitar el DJ Avatar y el lector musical.
Overlay cola DJ (OBS)
!pide busca directo en Spotify. !complace dedica una cancion a otro usuario y tambien entra como prioridad.
Aqui defines solo el estilo DJ. Tu avatar principal sigue siendo el mismo personaje.
Imágenes del DJ Avatar
Acepta imagen o video para reposo.
Solo imagen.
Solo imagen.
Estas imágenes solo se usan cuando abres el avatar con ?mode=dj.
Top 10 cola de pedidos (primera sonando)
0
    ⚙️ GENERAL
    LEGACY: sistema actual estable.
    El bot responderá cuando alguien mencione esta palabra.
    Máximo de mensajes que el bot responderá a cada usuario (0 = sin límite).
    Constructor Técnico de Prompt (Legacy)
    Esta estructura genera un prompt reusable para cualquier personaje y usa variables técnicas dinámicas.
    Escribe o selecciona el nombre exacto del modelo.
    🎙️ VOZ Y TTS
    En el laboratorio puedes escuchar, marcar favoritas y fijar voz de mujer/hombre.
    Se usa el servidor Edge TTS integrado para que el avatar hable con mejor acento latino.
    Crea o gestiona clones en la pestaña "Voz clonada".
    IMÁGENES PROPIAS (Haz clic en los cuadros para cambiar fotos)
    FOTO/VIDEO 1: REPOSO
    (Imagen principal o video en loop)
    Acepta PNG/JPG/WebP o videos MP4/WebM (opción recomendada para loops sin audio).
    FOTO 2: HABLANDO
    (Boca Abierta)
    FOTO 3: HABLANDO
    (Boca Cerrada)
    URL DEDICADA DEL AVATAR
    ...
    URL DEDICADA DJ AVATAR
    ...
    URL CAPTURA AUDIO DE VENTANITAS (BETA)
    ...
    Abre esa URL en Chrome, pulsa iniciar y elige la fuente de audio del sistema para que el avatar escuche y responda.

    🎙 Clonación de Voz

    Sube una muestra de audio y úsala en acciones o lector de chat.

    Recomendación de muestra: 6-20 segundos, voz clara, sin música, sin eco, y sin otras personas. Formatos: WAV/MP3/M4A/OGG.
    Después de crearla, la verás en esta lista y también en los selectores de Voz clonada en Acciones y Lector de Chat.

    📚 Centro de Ayuda y Ejemplos

    Guía clara de módulos + recetas listas para usar.

    Flujo recomendado (siempre en este orden)
    1) Conecta TikTok en Mi Panel → 2) Crea una Acción → 3) Crea un Evento que dispare esa acción → 4) Prueba con simulación → 5) Pega la URL de overlay en OBS.
    🛰 TikTok Monitor
    Conecta/desconecta live, estado, sala, eventos y catálogo de regalos detectados en tiempo real.
    🎬 Acciones
    Define qué se reproduce: video/audio/imagen + texto + TTS (voz, pitch, rate, volumen).
    ⚡ Eventos (Disparadores)
    Join, Gift, Chat, Like, Follow, Share, Timer, MemberLevelUp y TopTapKing para ejecutar acciones.
    🎭 Avatar + Lipsync
    Usa 3 imágenes (idle, talking, talking-closed). Habla si llega evento con tts_enabled=true y avatar_bridge/is_avatar.
    🤖 Perfiles IA
    Guarda proveedores/modelos (Ollama, Groq, OpenAI, AI-Bridge), activa perfiles y cambia personalidad del avatar.
    🗣 Lector de Chat
    Lectura automática con plantilla {usuario} dice {mensaje} y filtros de nivel/sub/mod.
    🏅 TopTap
    Ranking de likes por live y trigger TopTapKing cuando cambia el #1.
    👻 TokFantasma
    Monitoreo externo de otros lives (chat/eventos/stream URL) sin tocar tu sesión principal.
    👥 Usuarios y Funciones
    Proyecto multiusuario: módulos nuevos se habilitan por usuario en “Funciones”; fixes/mejoras van globales.
    Receta 1: Bienvenida por Join
    1. Crea acción: Bienvenida con mensaje Hola {usuario} y TTS activo.
    2. Crea evento: Join, Usuario: Any, Acción: Bienvenida.
    3. Simula el evento y verifica en overlay.
    Receta 2: Regalo épico
    1. Crea acción: video + mensaje {usuario} mandó {regalo}.
    2. Crea evento: Gift, valor exacto del regalo (catálogo live).
    3. Asigna acción y prueba con simulación.
    Receta 3: Recordatorio Timer
    1. Crea acción: recordatorio de follow/redes.
    2. Crea evento: Timer con valor 20s o 5 (min).
    3. No uses intervalos demasiado bajos para evitar saturación visual.
    Receta 4: Avatar con lipsync
    1. Sube imágenes: idle, talking y talking-closed.
    2. Activa avatar y define personalidad/trigger.
    3. Para reglas normales, activa Puente Avatar + TTS en acción.
    Variables recomendadas en mensajes: {usuario}, {mensaje}, {regalo}, {nivel}, {nivel_fans}.

    🎮 Juegos

    Beta

    Habilita juegos por usuario vía funciones (feature flag "games"). Coloca la URL en OBS/Browser Source o abre el panel de control.

    🏁 Carrera de Banderas
    Juego

    Overlay de pista y panel de control para la carrera. Pega la URL del overlay en OBS/Browser Source.

    ...
    ...
    🎯 Ahorcado
    Juego

    Juego de ahorcado en vivo. Los viewers deben adivinar la palabra letra por letra.

    ...
    ...
    🧠 Memory Match
    Juego

    Juego de memoria en chat para emparejar emojis por posicion.

    ...
    ...
    🚗 Taptap Race
    Juego

    Carrera de avatares. Los players dan taptap (likes) para hacer crecer su carrito y chocar con los demas.

    ...
    ...
    Guía de Inicio Rápido

    Sigue estos pasos para configurar tu propia voz (TTS):

    1. Paso 1: Crear la Acción
      Pulsa Nueva Acción. Ponle un nombre (ej: "Bienvenida"). Escribe el mensaje que quieres oír y marca "Activar TTS".
    2. Paso 2: Crear el Evento
      En la sección de Eventos, pulsa + Nueva. Elige cuándo quieres que suene (ej: "Join").
    3. Paso 3: Unir ambos
      En ese mismo Evento, en el campo "ACCIÓN A EJECUTAR", busca y selecciona la acción "Bienvenida" que creaste antes.
    Tip: Usa {usuario} en el texto para que la voz diga el nombre de la persona real.

    Gestión de Usuarios

    Mis Perfiles de IA
    Nuevo Perfil
    Perfiles Guardados
    # Nombre Proveedor Modelo Acciones
    Configurar App de Spotify
    Esta configuracion es individual para cada usuario. Ya no depende de la app global del sistema.
    Configura los 3 datos de tu app Spotify para habilitar la conexion.
    1. Crea tu app
    Abre Spotify Developer y crea una app propia para tu cuenta.
    2. Agrega callback
    Registra exactamente la Redirect URI que veras abajo.
    3. Guarda credenciales
    Pega Client ID, Client Secret y Redirect URI. Luego guarda.
    4. Conecta Spotify
    Vuelve al panel y pulsa Conectar Spotify para autorizar tu cuenta Premium.
    Abrir Spotify Developer
    Lo encuentras en el Dashboard de tu app.
    Secret no configurado.
    Registra exactamente esta URL en tu app de Spotify Developer.
    Nota: si tu app Spotify esta en modo Development, la cuenta que vas a conectar debe estar autorizada dentro de esa app en Spotify Developer.
    Mis Avatares Guardados
    Guardar Configuración Actual
    Lista de Avatares
    Vista Nombre Voz Acciones
    Selector de Emojis
    Notificaciones
    Destino: tu cuenta
    Las notificaciones de servicio se gestionan aquí. Quitar solo las saca de tu bandeja; marcar como leída las conserva.
    Bandeja
    Sincronizado
    0 pendientes 0 totales 0 leídas
    Mostrando pendientes
    Selecciona una notificación
    Aún no has abierto ningún mensaje.
    Las notificaciones aparecerán aquí con sus materiales adjuntos.
    El visor se activa al abrir un adjunto.
    Informe de campaña
    Entrega, aperturas y vistas por usuario.
    Sin informe cargado todavía.
    Enviar notificación
    Superadmin