Bienvenido a PupCid's Little TikTool Helper

Esta documentación te ayuda a aprovechar al máximo la herramienta y aprender todas sus funciones.

¿Qué es ltth.app?

PupCid's Little TikTool Helper es una herramienta profesional Open Source para streaming de TikTok LIVE con amplias funciones para creadores de contenido. La herramienta proporciona integración completa de eventos de TikTok LIVE en OBS Studio con overlays, alertas, Text-to-Speech, soundboard y automatización de eventos.

Funciones principales

Integración TikTok LIVE en tiempo real: Recibe Regalos, Comentarios, Follows, Shares y Likes en tiempo real
Text-to-Speech: Más de 75 voces TikTok y más de 30 voces Google Cloud
Sistema de alertas: Alertas personalizables para todos los tipos de eventos
Soundboard: Más de 100.000 sonidos vía integración MyInstants
Automatización de eventos (Flows): Automatizaciones Si-Entonces sin código
Integración OBS: Overlay Full-HD transparente para streams
Sistema de plugins: Más de 7 plugins preinstalados, extensible
100% Local y Open Source: Sin nube, sin credenciales de login requeridas

¿Para quién es esta herramienta?

Streamers de TikTok LIVE - Overlays y alertas profesionales
Creadores de contenido - Automatización de eventos e interactividad
Streamers de VRChat - Integración OSC para control de avatar
Streamers Multi-Invitado - Integración VDO.Ninja para entrevistas
Desarrolladores - Sistema de plugins modular para extensiones

Instalación y configuración

Instalar PupCid's Little TikTool Helper es simple y rápido.

Requisitos del sistema

Sistema operativo: Windows 10/11 (64-bit)
Node.js: 18.0.0 - 23.x (se instala automáticamente)
RAM: Al menos 4 GB recomendado
Espacio en disco: 500 MB de espacio libre

Instalación

Descargar: Descarga setup.exe desde ltth.app/download
Ejecutar instalación: Haz doble clic en setup.exe y sigue el asistente de instalación
Node.js: Se instala automáticamente si no está presente
Iniciar servidor: La herramienta se inicia automáticamente después de la instalación
Abrir Dashboard: El navegador se abre automáticamente en http://localhost:3000

Instalación manual (para desarrolladores)

# Clonar repositorio
git clone https://github.com/Loggableim/ltth.app.git
cd ltth.app

# Instalar dependencias
npm install

# Iniciar servidor
node launch.js

# O con script launcher:
# Windows: start.bat
# Linux/macOS: ./start.sh

Inicio rápido

¡Consigue un stream de TikTok LIVE profesional en 3 pasos!

Paso 1: Conectar a TikTok LIVE

Abre el Dashboard en http://localhost:3000
Introduce tu nombre de usuario de TikTok (sin @)
Haz clic en "Conectar a TikTok LIVE"
Espera al estado verde "Conectado"

Importante: Debes estar ya en LIVE en TikTok para que funcione la conexión.

Paso 2: Configurar OBS

Abre OBS Studio
Añade una nueva fuente de navegador
URL: http://localhost:3000/overlay
Ancho: 1920, Alto: 1080
Activa "Cerrar fuente cuando no esté visible" para rendimiento

Paso 3: Configurar funciones

TTS: Dashboard → TTS → Seleccionar voz → Activar "Auto-TTS para Chat"
Alertas: Dashboard → Alertas → Seleccionar tipo de evento → Configurar sonido y texto
Objetivos: Dashboard → Objetivos → Establecer objetivo → Personalizar estilo
Flows: Dashboard → Flows → "Nuevo Flow" → Definir disparador y acciones

¡Listo! 🎉 Tu stream está ahora configurado profesionalmente.

Configuración

Personaliza ltth.app según tus necesidades con amplias opciones de configuración.

Acceso al Dashboard

Después de iniciar, el dashboard se abre automáticamente en:

http://localhost:3000

Configuración básica

Nombre de usuario TikTok: Tu nombre de usuario de TikTok (sin @)
Idioma: Alemán, Inglés, Francés o Español
Tema: Claro, Oscuro o Sistema
Puerto del servidor: Por defecto 3000 (modificable)

Perfiles

Crea múltiples perfiles para diferentes configuraciones de streaming:

Diferentes cuentas de TikTok
Diferentes configuraciones de alertas
Soundboards separados
Automatizaciones de flow individuales

Conexión TikTok LIVE

Conexión en tiempo real a tu stream de TikTok LIVE sin credenciales de login.

Establecer conexión

Abre el Dashboard en http://localhost:3000
Introduce tu nombre de usuario de TikTok (sin @)
Haz clic en "Conectar a TikTok LIVE"
Debes estar ya en LIVE en TikTok
Espera al estado verde "Conectado"

Eventos recibidos

Regalos: Regalos con monedas, seguimiento de combos, catálogo de regalos
Chat: Mensajes con fotos de perfil e insignias
Follows: Nuevos seguidores con seguimiento de rol
Shares: Comparticiones del stream con información de usuario
Likes: Eventos de likes con contadores
Suscripciones: Suscriptores con niveles de tier

Text-to-Speech (TTS)

Sistema TTS profesional con más de 100 voces para mensajes de chat y alertas.

Voces disponibles

Voces TikTok (Gratuitas)

Más de 75 voces originales de TikTok incluyendo alemán, inglés, español, francés y muchos más idiomas.

Voces Google Cloud (Opcionales)

Más de 30 voces Google Cloud premium con calidad superior y voces neurales.

Configuración

Dashboard → TTS
Seleccionar voz predeterminada
Ajustar volumen y velocidad
Activar Auto-TTS para mensajes de chat

Sistema de alertas

Alertas visuales y de audio personalizables para todos los tipos de eventos.

Tipos de eventos

Regalos: Alertas para regalos con filtros de monedas
Follows: Alertas de nuevos seguidores
Shares: Alertas cuando alguien comparte tu stream
Suscripciones: Alertas de nuevos suscriptores

Personalización

Sonido de alerta personalizado
Imagen/GIF de alerta
Texto con variables ({username}, {coins}, {giftName})
Duración y animaciones

Soundboard

Más de 100.000 sonidos vía integración con MyInstants.

Funciones

Búsqueda en la base de datos de MyInstants
Sonidos específicos para regalos
Sonidos de eventos (Follow, Subscribe, Share)
Sistema de umbral de Likes
Favoritos y sonidos recientes

Automatización de eventos (Flows)

Crea automatizaciones Si-Entonces sin conocimientos de programación.

Tipos de disparadores

Regalo: Cuando se recibe un regalo
Follow: Cuando alguien te sigue
Share: Cuando se comparte el stream
Umbral de Likes: Al alcanzar X likes
Subscribe: Nueva suscripción
Chat: Mensaje de chat específico

Tipos de acciones

TTS: Reproducir texto como voz
Alerta: Mostrar alerta visual
Sonido: Reproducir sonido
Webhook: Enviar solicitud HTTP
OBS: Cambiar escena
Delay: Esperar X segundos

Objetivos y Overlays

4 objetivos separados con overlays de fuente de navegador individuales para OBS.

Tipos de objetivos

Objetivo de Likes: Meta de likes del stream
Objetivo de Followers: Meta de nuevos seguidores
Objetivo de Suscripciones: Meta de suscriptores
Objetivo de Coins: Meta de monedas de regalos

URLs de Overlay

Likes:         http://localhost:3000/overlay/goals/likes
Followers:     http://localhost:3000/overlay/goals/followers
Suscripciones: http://localhost:3000/overlay/goals/subscriptions
Coins:         http://localhost:3000/overlay/goals/coins

Integración OBS Studio

Control completo de OBS con WebSocket v5 para escenas, fuentes y overlays.

Requisitos

OBS Studio 28.0+ (WebSocket v5 integrado)
WebSocket habilitado: Herramientas → Configuración del servidor WebSocket
Puerto: 4455 (por defecto)

Configuración de conexión

Abrir OBS: Herramientas → Configuración del servidor WebSocket
Habilitar servidor WebSocket
Puerto del servidor: 4455
Establecer contraseña (opcional pero recomendado)
ltth.app: Dashboard → Configuración → Integración OBS
URL WebSocket: ws://localhost:4455
Introducir contraseña (si está configurada)
Hacer clic en Conectar

Overlays de fuente de navegador

Overlay principal (Todas las funciones):

URL: http://localhost:3000/overlay
Ancho: 1920
Alto: 1080
FPS: 30
☑ Cerrar fuente cuando no esté visible

Integración VRChat OSC

Controla tu avatar de VRChat con eventos de TikTok LIVE vía protocolo OSC.

Habilitar VRChat OSC

Iniciar VRChat
Abrir Menú de Acción (tecla R)
Opciones → OSC
Habilitar OSC
Anotar el puerto (por defecto: 9000)

Configuración ltth.app

Dashboard → Configuración → VRChat OSC
IP OSC: 127.0.0.1 (localhost)
Puerto OSC: 9000
Habilitar integración VRChat OSC
Hacer clic en Conectar

Integración VDO.Ninja

Streaming multi-invitados para entrevistas y colaboraciones.

Funciones

Gestión de salas con generación de códigos QR
Administración de invitados
Control de diseño (Grid, Spotlight, Custom)
Enlaces directos para invitados

Arquitectura

PupCid's Little TikTool Helper está basado en una arquitectura de microservicios orientada a eventos.

Stack tecnológico

Backend: Node.js 18-23, Express 4, Socket.io 4
Base de datos: SQLite (Modo WAL) con better-sqlite3
Integración TikTok: tiktok-live-connector 2.1.0
Integración OBS: obs-websocket-js 5.0.6
Protocolo OSC: osc 2.4.5
Frontend: Bootstrap 5, Vanilla JavaScript

API de Plugins

Crea tus propios plugins para ltth.app con la API de Plugins.

Estructura de plugin

plugins/my-plugin/
├── plugin.json       # Metadatos
└── main.js           # Clase del plugin

Documentación completa de plugins: Sistema de Plugins

Referencia REST API

Endpoints API disponibles para integraciones externas.

Endpoints principales

GET  /api/status          - Estado del servidor
GET  /api/stats           - Estadísticas del stream
POST /api/tts             - Reproducir TTS
POST /api/alert           - Activar alerta
GET  /api/gifts           - Catálogo de regalos

Solución de problemas

La conexión TikTok falla

Asegúrate de estar ya en LIVE en TikTok
El nombre de usuario debe ser correcto (sin @)
El firewall/antivirus podría estar bloqueando la conexión
El puerto 3000 debe estar disponible

El overlay no se muestra

Verificar URL de fuente de navegador: http://localhost:3000/overlay
Ancho: 1920, Alto: 1080
OBS debe estar ejecutándose en el mismo PC
El servidor debe estar en ejecución (localhost:3000 accesible)

Más ayuda

Visita el Wiki de FAQ y Solución de problemas o abre un GitHub Issue.