Changelog

Released: December 15, 2025

🎉 Highlights

This release brings multilingual plugin descriptions for all 30 plugins, improved API key persistence indicators, and important bug fixes for the Advanced Timer Plugin.

✨ New Features

• Multilingual Plugin Descriptions (Phase 4)
  • Added multilingual descriptions to all 30 plugin.json files
  • Support for 4 languages: English (en), German (de), Spanish (es), French (fr)
  • New `descriptions` object in plugin.json with language-specific descriptions
  • Maintained backward compatibility with existing `description` field
  • API support for localized descriptions via `locale` query parameter
  • Updated plugin loader with `getLocalizedDescription()` helper function
  • Updated `/api/plugins` and `/api/plugins/:id` routes to support locale selection
• Visual Indicators for API Key Storage
  • Added visual indicators showing that API keys are stored persistently across updates
  • Improved user feedback for API key configuration
  • Better documentation of API key storage locations

🚀 Improvements

• Repository Cleanup - Moved 107 implementation summary and documentation files to `docs_archive/` folder
• Plugin Loader Enhancement - `getAllPlugins()` now accepts optional `locale` parameter
• Plugin API Responses - Now include both `description` (localized) and `descriptions` (all languages)

🐛 Bug Fixes

• Version Number Correction - Corrected erroneous version 2.2.1 to 1.2.1
• Advanced Timer Plugin - Fixed overlay routes and storage migration
• Timer Overlay - Fixed timer overlay not loading correctly in browser sources
• Timer State Management - Improved timer state management and recovery

Released: December 8, 2025

🎉 Highlights

This major release introduces a complete plugin system with hot-reloading, cross-platform launcher improvements, a new Multi-Cam Switcher, and comprehensive performance optimizations for database and core modules.

✨ New Features

• Plugin System with Hot-Reloading
  • Upload, enable, disable, and delete plugins without server restart
  • Plugin state persistence in plugins_state.json
  • Example "Topboard" plugin for top gifters and streaks
  • Dashboard UI integration for plugin management
• Multi-Cam Switcher Plugin
  • Switch OBS scenes via TikTok gifts or chat commands
  • OBS-WebSocket v5 integration with auto-reconnect
  • Chat commands: !cam 1-5, !cam next/prev, !scene <name>, !angle next
  • Gift mapping with configurable coin thresholds
  • Macro system for multi-step actions with delays
  • Permissions: modsOnly, broadcasterOnly, allowedUsers, minAccountAgeDays
  • Cooldowns: Per-user (15s), Global (5s), Macro max duration (10s)
  • Safety limits with auto-lock on rapid switching
• Platform-Agnostic Launcher
  • Cross-platform support (Windows, Linux, macOS)
  • TTY-safe logging without "stdout is not a tty" errors
  • Robust Node.js/npm version checks in JavaScript
  • Automatic dependency checking and installation
  • Browser auto-start after launch
• TTY-Logger Module
  • Automatic TTY detection
  • ANSI colors only when TTY is supported
  • UTF-8/Emoji support detection
  • Fallback to plain text for non-TTY (OBS, redirects)
  • Platform-specific symbols
• Git-Based Update System
  • Git-based updates when .git is present
  • GitHub Release ZIP download without Git
  • Automatic backup before updates (user_data/, user_configs/)
  • Rollback on failed updates
  • Platform-independent update strategy
• Launch Mode Selection on Splash Screen
  • Choose between Electron app or Browser mode at startup
  • Launch buttons enabled after backend is ready
  • Browser mode opens dashboard in default browser and minimizes to tray

🚀 Improvements

• Database Performance Optimizations - SQLite with WAL mode, 64MB cache, memory temp store
• Plugin-Loader Extended - From 827 to 1043 lines for better state management
• Leaderboard Module - From 362 to 480 lines with enhanced tracking features
• Rate-Limiter - Nearly doubled (80 to 150 lines) with improved request handling
• TikTok Module - Enhanced from 83KB to 85KB with better event processing

🐛 Bug Fixes

• TTS Migration to Plugin - TTS engine now fully integrated as plugin with 75+ voices
• VDO.Ninja Plugin Migration - Multi-guest streaming fully plugin-based with 20+ API routes
• Dynamic UI Visibility - Dashboard tabs show/hide based on active plugins without page reload
• Update-Checker - Graceful 404 handling when GitHub Releases are unavailable
• No "echo -e" Problems - Fixed under Windows/Powershell
• No "integer expression expected" Errors - Fixed in version checks

Released: December 3, 2025

🎉 Highlights

This release brings major improvements to the Leaderboard Plugin with new OBS overlay layouts, a comprehensive OpenShock gift event debugging system, and numerous critical bug fixes.

✨ New Features

• Leaderboard Plugin v1.2.0 - OBS Overlay System Extension
  • Bar Layout - Horizontal bar for top/bottom of stream (1920x80)
  • Sidebar Layout - Vertical sidebar for right side (400x1080)
  • Popup Layout - Temporary popup for highlights (600x700)
  • Extensive query parameter customization (theme, maxEntries, showAvatars, etc.)
  • Progress bar visualization relative to #1 gifter
• Hype Mode System
  • New WebSocket events: leaderboard:hypeStart and leaderboard:hypeEnd
  • Visual effects during hype phases across all overlay layouts
  • Configurable popup behavior during hype events
• Auto-Hide Popup Functionality
  • Popup automatically shows on rank changes
  • Configurable auto-hide delay (default: 10 seconds)
  • Smart detection of significant leaderboard changes
• OpenShock Plugin: Gift Event Pipeline Debugging
  • Enhanced logging along the complete event pipeline (TikTok → Mapping → OpenShock)
  • Debug endpoint GET /api/openshock/debug/mappings for mapping inspection
  • Test endpoint POST /api/openshock/test/simulate-gift for gift event simulation
  • Complete documentation in DEBUGGING_GIFT_EVENTS.md
• OpenShock Plugin: Wildcard Gift Matching
  • Empty string or "*" as giftName matches ANY gift
  • Perfect for catch-all mappings that react to all gifts
  • Specific gift names automatically take priority
• OpenShock Plugin: Coin Range Mappings
  • Min-Max coin ranges for precise event mappings
  • Example: 1-99 coins → 20% shock, 100-199 coins → 50% shock
  • Prevents overlaps between different coin tiers
• OpenShock Plugin: Configurable Like Threshold
  • Like events are accumulated over configurable time window
  • Minimum number of likes configurable (default: 10)
  • Time window configurable in seconds (default: 5s)

🐛 Critical Bug Fixes

• Console Errors Fixed
  • Cloud Sync: Removed unnecessary warning when UI elements don't exist
  • Audio System: Replaced corrupted MP3 with valid WAV format
  • GPU Detection: Updated to modern gl.RENDERER API
  • Initialization: Fixed Socket.IO ready state timing
  • System now initializes in less than 400ms instead of 30s timeout
• Profile Pictures - Added extraction helper for TikTok API object structure
• OpenShock Gift Event Pipeline Completely Repaired
  • Gift events are now correctly forwarded from TikTok → OpenShock
  • Mapping engine evaluates events correctly
  • Actions are executed when mappings match
• TikTok Diamond Count Extraction Priority Fixed
  • Restored original priority: gift.diamond_count FIRST
  • Fixes "🪙 0" display issue after previous updates

🔧 Improvements

• OpenShock Pattern UI Simplified - Only custom patterns now, no complex curve editor
• OpenShock Case-Insensitive Gift Name Matching - "Rose" matches "rose", "ROSE"
• OpenShock Debug Log System - Real-time event logging in UI with Socket.IO broadcasting
• OpenShock Edit Pattern Steps - Steps can be edited after creation
• TikTok Gift Event Logging - Improved transparency for gift events during streaks

Released: December 1, 2025

🎉 Highlights

This is the official release version 1.1 of Pup Cid's Little TikTool Helper! This release includes major improvements to TikTok connectivity, new plugins, and significant stability enhancements.

🔴 BREAKING CHANGES

• Migration to Eulerstream WebSocket SDK
  • Complete replacement of tiktok-live-connector with Eulerstream SDK
  • Direct WebSocket connection to Eulerstream API
  • Eulerstream API key now REQUIRED (via EULER_API_KEY or SIGN_API_KEY)
  • Backward compatibility with existing event handlers and plugins maintained

🐛 Critical Bug Fixes

• TikTok TTS Engine 500 Errors Fixed
  • Complete rewrite with hybrid endpoint approach
  • Automatic endpoint rotation on failures
  • Support for multiple response formats
  • Modern User-Agent (Android 13)
• TikTok Connection 504 Timeout Fixed
  • Set fetchRoomInfoOnConnect to false
  • Increased HTTP timeout to minimum 30 seconds
  • Improved error messages for timeouts
• Quick Actions Menu Not Updating - Menu remained grayed out after plugin activation
• Goals Modal Focus Issue in Electron - Modal inputs not clickable fixed
• TTS Admin Panel Unclickable in Electron - Tabs and buttons now respond
• Chatango Integration in Electron - White window issue fixed
• Language Selector Flags - Flag icons now display correctly

✨ New Features

• Weather Control Plugin
  • 7 modern weather effects: Rain, Snow, Storm, Fog, Thunder, Sunbeam, Glitch Clouds
  • GPU-accelerated Canvas 2D rendering with 60 FPS
  • Permission-based access control
  • Flow action support for IFTTT automation
  • Gift-based automatic triggers
• Auto-Update System
  • Launcher checks for updates on startup
  • Displays current version in splash screen
  • Notifies when updates are available
• Direct Download
  • Download now directly via ltth.app/app/ltth_1.1.0.zip
  • No more GitHub dependency for downloads

⚡ Performance Improvements

• CSS Performance - will-change, contain, overscroll-behavior optimizations
• Scroll Performance - Passive event listeners for better scrolling
• Rendering - Isolated rendering with contain: layout style paint

Released: November 24, 2025

✨ New Features

• OpenAI Integration for Quiz Show
  • GPT-5.1 powered question package generation (Nano, Mini, Standard models)
  • Automatic creation of themed quiz questions with AI
  • Multi-language support (German and English)
• Inline Pattern Editor
  • Direct editing of OpenShock patterns in event mapping modal
  • Pattern details visible in mapping list view
  • Improved user experience for pattern assignment
• Launcher.exe with GUI
  • Graphical launcher with background image and progress bar
  • Automatic redirect to dashboard after startup
  • Browser-based UI without external GUI libraries

🔧 Improvements

• OSC-Bridge (VRChat) - Gift catalogue integration for easier gift mapping setup
• VDO.Ninja Multi-Guest - Director URL control room iframe tab in room management
• Event Mapping UI - Pattern selection with updateMappingPatternList function
• OpenShock - Pattern details now visible in event mapping list

🐛 Bug Fixes

• Emoji Rain v2.0 - Bounce/bubble animation triggers, pixel mode rendering, defensive positioning
• VDO.Ninja - Fixed Content Security Policy violations (removed inline onclick handlers)
• OpenShock - Null checks now correctly handle pattern ID 0 as valid value

📚 Documentation

• Added JSDoc documentation for inline pattern editor functions
• Technical documentation for launcher.exe in infos/ directory

Released: November 24, 2025

✨ New Features

• Configurable XP System
  • Level-up animations with advanced admin features
  • Viewer engagement system for better audience retention
  • Comprehensive configuration options for XP distribution
• Graphical Pattern Curve Generator (OpenShock)
  • Visual user interface for pattern creation
  • Interactive curve design with real-time preview
  • Simplified pattern configuration without manual input
• OBS HUD for Command Overlays
  • Real-time display of chat commands in OBS overlay
  • Fully configurable overlay presentation
  • Integration with GCCE command system

🔧 Improvements

• Plugin Manager - Added compact mode switch for better space management
• Resource Monitor - Fixed 2x2 grid layout (CPU/GPU, RAM/Network)
• Leaderboard - Multiple overlay themes (Classic, Neon, Gradient) with preview mode
• Quiz Show - Integration with application theme system for better readability
• Thermal Printer - Full theme integration using CSS variables
• VDO.Ninja Multi-Guest - Comprehensive UI refactoring with method aliases
• OSC-Bridge (VRChat) - Gift catalogue mappings and avatar switching support

🐛 Bug Fixes

• Windows Path Validation in config-import plugin fixed
• OpenShock Pattern Engine - Removed duplicate wait causing duration bugs
• OpenShock Custom Pattern Editor - Improved step configuration workflow
• OpenShock Emergency Stop - Added prominent button to main UI header
• Plugin Update Checking - Added changelog fallback mechanism

🔐 Security

• Enhanced input validation across all plugins
• Improved error handling and sanitization

Version 1.0.7

Released: November 23, 2025

✨ New Features

• Independent Volume Control for Gift Animations
  • Separate volume control for gift animation audio in soundboard
  • New animation volume control in soundboard configuration
  • Standalone soundboard UI with animation volume control
• Stream Alchemy - Extensible Settings
  • Customizable AI prompts for item generation
  • Item management with edit and delete functionality
  • Comprehensive settings UI with custom prompt support
• Multicam - OBS Password Authentication
  • OBS password support for secure WebSocket connection
  • Gift-to-scene mapping UI with complete gift catalog
  • German and English localization
• Plugin UI Integration
  • Leaderboard admin panel with session and all-time tracking
  • Stream Alchemy, GCCE, and Thermal Printer UI integration
  • VDO.Ninja Multi-Guest and Emoji Rain v2.0 enabled by default

🐛 Bug Fixes

• Emoji Rain Completely Reworked
  • Fixed bubble blop animation
  • Fixed pixel mode rendering
  • Added color filters for emojis
  • Improved edge spawning for better distribution
• Follow Sounds Now Playing Reliably
  • Improved event detection with multiple displayType patterns
  • Fallback check for follow events
  • Debug logging for unrecognized social events
• OpenShock Pattern Settings
  • Implemented pattern settings functionality in mapping modal
• Sidebar Layout Fixes
  • Removed duplicate text spans in VDO.Ninja
  • Fixed Plugin Manager layout
• Gift Milestone Celebration
  • Fixed tier-specific media assignment
  • Improved error handling
• Weather Control Overlay
  • Fixed GSAP library loading issue in OBS Browser Source
  • Animations now work correctly
• Resource Monitor
  • Compact mode now displays all content on one page
• Plugin Initialization
  • All 23 plugins now load successfully
  • Fixed logger API issues for GCCE and StreamAlchemy
  • Enabled minecraft-connect, openshock, osc-bridge, resource-monitor
  • Enabled api-bridge, hybridshock, multicam, viewer-xp

🔐 Security

• XSS protection and input validation for Stream Alchemy
• Refactored validation helpers for better maintainability
• Added accessibility improvements

📚 Documentation

• Reorganized documentation files into infos/ subdirectory
• Updated file path references

Version 1.0.6

Released: November 23, 2025

✨ New Plugins

• StreamAlchemy Plugin - RPG crafting system with AI
  • Transform TikTok gifts into virtual RPG items
  • AI-generated isometric item icons with DALL-E 3
  • Real-time crafting: Combine 2 gifts within 6 seconds
  • 4 rarity tiers based on coin values (Bronze, Silver, Gold, Purple)
  • Persistent inventory management per user
  • Chat commands: /inventory, /inspect, /merge, /alchemy
• Leaderboard Plugin - Top gifter tracking
  • Session leaderboard for current stream session
  • All-time champions for historical top contributors
  • WebSocket-based live updates in overlay
  • Automatic updates of nicknames and profile pictures
  • Modern neon/dark theme UI with CSS animations
  • Performance-optimized with debounced database writes
• Thermal Printer Plugin - Physical event printouts
  • ESC/POS thermal printer support (USB & Network)
  • Prints chat messages, gifts, follows, and shares
  • Smart filtering: Min. coins, bot command ignorance
  • Asynchronous print queue prevents event loop blocking
  • Auto-reconnect on connection loss
  • Configurable ESC/POS formatting with ASCII icons
• GCCE (Global Chat Command Engine) - Universal command system
  • Centralized command registry for all plugins
  • Hierarchical permission system (broadcaster → all)
  • Automatic syntax validation and error messaging
  • Rate limiting (10 commands/user/minute, 100 global/minute)
  • Unified overlay system for command feedback
  • Built-in commands: /help, /commands, /inventory, /inspect, /merge

Version 1.0.5

Released: November 23, 2025

🔴 BREAKING CHANGES

• Migration to Eulerstream WebSocket SDK - Complete replacement of tiktok-live-connector
  • Direct WebSocket connection to Eulerstream API
  • Eulerstream API key is now REQUIRED
  • Backward compatibility with existing event handlers maintained
  • See eulerstream.com for API key registration

🐛 Critical Bug Fixes

• TikTok TTS Engine 500 Errors Fixed - Complete reimplementation
  • Hybrid endpoint system with multiple fallback options
  • Automatic endpoint rotation on failures
  • Support for multiple response formats
  • Modern User-Agent (Android 13)
  • Text chunking for long messages (>300 characters)
• TikTok Connection 504 Timeout Fixed - Euler Stream optimizations
  • Set fetchRoomInfoOnConnect to false to reduce API calls
  • Increased HTTP timeout to minimum 30 seconds
  • Improved error messages for Euler Stream timeouts
  • Integrated hardcoded Euler API key as Base64 fallback
• Invalid Option Error Fixed - Removed non-existent enableWebsocketUpgrade option

✨ New Features

• Weather Control Plugin - Professional weather effects system
  • 7 modern weather effects: Rain, Snow, Storm, Fog, Thunder, Sunbeam, Glitch Clouds
  • GPU-accelerated Canvas 2D rendering with 60 FPS performance
  • Permission-based access control
  • Configurable rate limiting (10 requests/minute per user)
  • WebSocket real-time event streaming to overlays
  • Flow action support for IFTTT automation
  • Gift-based automatic triggers (coin thresholds)

Version 1.0.4

Released: November 23, 2025

✨ Website Improvements

• Navbar Logo Fix - Resolved text overlap with menu items
• Larger Logo - Increased logo icon from 32px to 48px for better visibility
• Plugins Page Overhaul - Better structure and organization
• Enhanced Documentation - Comprehensive plugin guides added

📚 Documentation

• Detailed plugin API documentation
• Plugin development guides with examples
• Screenshots for plugin configuration
• Improved navigation for plugin content

🎨 Design

• Improved visual separation in plugin categories
• Better mobile responsiveness across all pages
• Optimized readability and user experience

Version 1.0.3

Released: November 10, 2025

✨ New Features

• Validators Module - Comprehensive input validation for all API endpoints
• Template Engine - Centralized template processing with RegExp caching (10x performance)
• Error Handler Module - Standardized error handling across the system

🔐 Security

• CORS policy tightened - Whitelist-based instead of wildcard
• CSP with nonces implemented against XSS attacks
• DNS-based webhook validation against SSRF
• IP blacklist for private networks
• Security improved: 5/10 → 9/10 (+80%)

⚡ Performance

• Database batching - Event logs are batched (50x faster inserts)
• Template rendering with RegExp cache (90% improvement)
• Memory leaks fixed - Plugin reload without server restart
• Performance: ~500 → ~800 events/s (+60%)

🐛 Bug Fixes

• Socket event cleanup implemented - no more memory leaks
• Logging standardized - console.* replaced with structured logging
• Code duplication eliminated (~200 lines reduced)

Version 1.0.2

Released: November 9, 2025

🎮 OSC-Bridge Plugin

• VRChat-Integration via OSC-Protokoll
• Bidirektionale Kommunikation (Senden & Empfangen)
• VRChat Helper-Methoden: wave(), celebrate(), dance(), hearts(), confetti()
• Flow-System-Integration mit 8 neuen Actions
• Latenz < 50ms

🚀 Launcher & Update-System

• Platform-agnostischer Launcher (Windows, Linux, macOS)
• TTY-sicheres Logging (keine "stdout is not a tty" Fehler)
• Git-basiertes Update mit automatischem Backup
• Rollback bei fehlgeschlagenen Updates

🔌 Plugin-System

• Plugin-Loader mit Lifecycle-Management
• Plugin-Manager UI (Upload, Enable, Disable, Delete, Reload)
• Hot-Loading ohne Server-Neustart
• Multi-Cam Switcher Plugin - OBS-Szenen via Gifts/Chat steuern

⚠️ Beta-Hinweis

Dieses Tool befindet sich in aktiver Entwicklung. Features können sich ändern. Bitte melde Bugs und Feature-Requests auf GitHub.