v4.2.0

Changelog

[v4.2.0] - 2026-03-10

Features

Add Support for any chrome version installed in local PC

Improves reliability and resilience of browser initialization
across diverse environments and Chrome update cycles.

v4.1.0

Changelog

[v4.1.0] - 2026-02-22

Features

Multiple Google Accounts Support (#150)

• New API Endpoint: Added POST /environment/profiles/add_account to enable adding additional Google accounts to the environment
• UI Enhancement: Added "Add Another Google Account" button in the Cookie Login section for logged-in users
• Backend Implementation:
  • New Profiles.add_account() method to handle account addition flow
  • Enhanced UndetectedDrivers.youtube_login() with add_account parameter for account-specific login flows
  • Added add_account_url attribute pointing to Google's AddSession URL

Documentation

• Added comprehensive instructions for using multiple Google accounts feature
• Updated user guide with step-by-step instructions for adding additional accounts

v4.0.1

What's Changed

• fix(error-handling): add detailed error logging and reporting by @Ashif4354 in #146

Full Changelog: v4.0.0...v4.0.1

v4.0.0

Changelog

[v4.0.0] - 2026-01-18

🚀 New Features

Real-time Dashboard

• Live monitoring dashboard for active storm sessions with:
  • Storm status, active/dead instances, messages sent, duration tracking
  • Real-time message rate (per minute) display
  • Live log feed with color-coded log levels
  • Socket.IO-based real-time updates replacing polling mechanisms
• Channel Status Modal - View and manage individual channel statuses with ability to kill specific instances
• View Config Modal - Display storm configuration details
• System metrics charts - CPU and RAM usage visualization using Recharts library

AI Integration

• AI-powered message generation - Generate YouTube comments using AI with customizable prompts
• AI-powered channel name generation - Create channel names via AI assistance
• Multi-provider support - OpenAI, Anthropic (Claude), Google (Gemini), and custom providers
• PydanticAI implementation - Structured AI outputs with async generation and type safety
• Settings management - Configure and save API keys, models, and default providers locally

MCP (Model Context Protocol) Server

• Full MCP server integration with FastMCP framework
• MCP tools for storm operations: start, stop, pause, resume, kill instances
• MCP tools for configuration: get settings, profiles, system metrics, storm context
• MCP resources for monitoring: channels, logs, system data
• HTTP transport for external LLM clients to control StreamStorm operations

Settings & Configuration

• Unified Settings Modal with tabbed interface:
  • API Keys management for AI providers
  • Theme selection (Light/Dark modes)
  • Host configuration
  • General settings
• Pydantic-based configuration - Type-safe settings with environment variable support
• Settings API endpoints - RESTful API for managing all configurations

Cookie-Based Login

• Default login method - More efficient and reliable than browser profiles
• Login with Google (Recommended):
  • Opens browser window for Google authentication
  • Automatically saves cookies after successful login
  • Cookies used for authentication when starting storms
• Login with Cookie Files:
  • Upload multiple cookie files (JSON or Netscape format)
  • Only youtube.com cookies are parsed and saved
  • Validates cookies before creating the base profile

Enhanced User Interface

• Responsive navigation - Mobile-friendly header with drawer navigation
• Improved light theme - New color palette using indigo accents
• Instructions link - Easy access to documentation from navbar
• Enhanced modals - Logs modal, channels status modal, manage profiles modal

Core Engine Improvements

• Channel URL fetching - Subscribe on channel page using yt-dlp (not video page)
• Brand account detection - Automatic detection and handling during channel selection
• Profile directory management - Better tracking of assigned profiles per instance
• Staggered channel resumption - Prevents simultaneous restarts after pause
• Centralized storm context - Unified state management across engine and UI

Developer Experience

• Makefile targets - make deps, make run-dev, make run-api, make pytest
• Cross-OS build trigger - Repository dispatch workflow for on-demand builds
• Enhanced logging - Real-time log emission via Socket.IO with improved verbosity control
• Next.js 16 upgrade - Latest framework features and improvements

🔄 Major Changes & Refactoring

• Migrated configuration to Pydantic Settings - Environment variable support with STREAMSTORM_ prefix
• Replaced Langchain with PydanticAI - Async-first AI implementation with structured outputs
• Centralized logger - Singleton custom_logger instance across all modules
• Merged EachAccount into SeparateInstance - Simplified instance management
• Combined lifespan management - Integrated FastAPI and MCP app lifecycles
• API endpoint consolidation - /engine-status → /config, /storm/start_time → /storm/context
• Storm context unification - Server-side tracking of storm data, channels, and status

🛠️ Breaking Changes

• Configuration now uses Pydantic Settings - Update .env files with STREAMSTORM_ prefixed variables
• Settings API uses snake_case fields - Client integrations must update field names
• Socket.IO event renamed - system_info → system_metrics
• MCP API structure changed - Resources converted to tools
• StormData parameter changes - StreamStorm class now accepts single StormData object
• Next.js 16 - May require code adjustments for compatibility

📦 Dependencies Added

• pydantic-ai-slim - AI framework with structured outputs
• fastmcp - MCP server implementation
• yt-dlp - YouTube metadata extraction
• recharts (UI) - Charting library for system metrics
• asyncer - Synchronous wrappers for async operations

🐛 Bug Fixes

• Fixed instance counter accuracy in dashboard
• Fixed delay retention after pause/resume
• Corrected message counter scope for proper concurrency
• Fixed active/dead instance tracking logic
• Updated XPath selectors for improved channel creation reliability
• Brand account handling - Skip OK button for regular accounts

📝 Documentation

• Updated README with installation instructions, make commands, and environment variables
• Added CREDITS.md with contributors and tools
• Enhanced API documentation with operation IDs, summaries, and detailed docstrings
• Socket.IO events documentation in sockets.md

v3.5.2 - Linux build released

Changelog

[v3.5.2] - 2025-11-16

Features

• Download Page:
  • Added a dedicated Download page with OS-specific tabs for Windows and Linux (tar.gz and .deb).
  • Each tab provides tailored installation instructions and download options for the respective operating system.
• Cross-Platform Build Support:
  • Implemented cross-platform build and packaging support for Windowsand Linux.
  • Updated build scripts, PyInstaller spec, and Makefile to handle multi-OS builds and packaging.
• Unified Makefile:
  • Introduced a Makefile to unify common development, build, and release tasks across all supported platforms.

Enhancements

• Site Refactor:
  • Refactored instructions, privacy policy, and terms pages into standalone modular components with metadata.
• MUI Theme Integration:
  • Integrated MUI ThemeProvider and custom theme into the Next.js root layout for consistent styling.
• Footer Revamp:
  • Enhanced footer layout to include contact email and improved structure.

Build & Packaging

• Build Pipeline Overhaul:
  • Enhanced build_and_release.py and added helper scripts for version updates, executable generation, artifact download, and setup creation.
  • PyInstaller spec now detects platform and sets executable name accordingly.
  • Debian control file and INNO Setup script updated for versioning and packaging.
• Linux & macOS Support:
  • Added Linux .deb and tar.gz packaging, and macOS build placeholder.
• Version Bump:
  • Bumped version to 3.5.2 in all relevant config files (project.json, pyproject.toml, package.json, INNO Setup, etc).

CI

• GitHub Actions:
  • Added a workflow for Linux build and artifact upload, including .deb and tar.gz packaging.

Documentation

• Sitemap:
  • Registered the new download page in sitemap.xml.
• Download Instructions:
  • Provided detailed, copyable installation instructions for each OS on the Download page.

v3.5.1

Changelog

[v3.5.1] - 2025-11-8

Added

• Display of both UI and Engine version in the footer (UI)
• Engine version is now fetched from the backend /engine-status endpoint
• UI version is read from environment variable VITE_APP_VERSION
• Error handling and analytics tracking added to CreateChannels component

Changed

• /engine-status endpoint now returns the engine version from CONFIG
• RAMMap path configuration refactored to use CONFIG instead of environment variables
• Engine version state management added to StormDataContext
• Footer component updated with version display and styling

Fixed

• Improved error handling for status fetch failures

v3.5.0

Changelog

[v3.5.0] - 2025-11-1

Added

• Language Enforcement:

  • Implemented automatic language detection and enforcement for English in Selenium and Playwright browser automators.
  • Added methods to check and modify page language dynamically.
  • Enforced English locale by appending ?hl=en-US&persist_hl=1 to YouTube video and chat URLs.

• Bulk YouTube Channel Creation:

  • Introduced new API endpoints and UI components for bulk YouTube channel creation.
  • Added CreateChannelsData and VerifyChannelsDirectoryData validation models for input handling.
  • Implemented ChannelsRouter with /create and /verify_dir endpoints for channel automation and logo validation.
  • Created CreateChannels class for Selenium-based automation.
  • Added CreateChannels React component for bulk channel creation with logo options and directory validation.

• Structured Logging:

  • Integrated structured logging across API exception handlers, core modules, and automation modules (Selenium, Playwright, UndetectedDrivers).
  • Added detailed log outputs for browser interactions, file operations, JSON parsing, and background task management.
  • Added logger instances to profile management for improved debugging visibility.

• SEO Enhancements:

  • Embedded Website schema JSON-LD in site layout for better SEO performance.

Changed

• Browser Automation:

  • Converted abstract methods (open_browser, go_to_page, find_and_click_element, find_element, type_and_enter) from asynchronous to synchronous.
  • Added new abstract methods for checking and changing browser language.
  • Enhanced Selenium core with better logging, retry logic, frame switching, and element availability tracking.
  • Improved session_not_created_exception_handler for better session creation error handling.
  • Simplified exception handling in Selenium’s find_and_click_element.

• API Exception Handling:

  • All API exceptions are now logged at the error level, and validation errors at the debug level.
  • Validation error responses now include friendly field names and full context for 422 errors.

• Core Modules:

  • Added logging for failures in file operations, JSON parsing, element interaction, and background task handling.
  • Instance removal in StreamStorm now logged for traceability.

• Schema & Validation:

  • Renamed videoURL to videoUrl for consistent casing.
  • Reformatted alias arguments in validation schema for consistency.

• Build & Deployment:

  • Updated INNO Setup export paths and Windows build scripts.
  • Updated README paths for Engine and UI.
  • Bumped version to 3.5.0 across engine, UI, and site.
  • Improved RAM clearing utility with OS checks.
  • Enhanced SeparateInstance to handle brand account confirmation popups.
  • Minor UI and context improvements.

Fixed

• Fixed incorrect key naming in StormDataContext (videoURL → videoUrl).
• Fixed Chrome driver issue where 'switch-account' wasn’t detected after clicking the avatar button (#83).
• General bug fixes for better robustness and consistency across modules.

Removed

• Removed obsolete commented-out cleanup code from EachChannel (StreamStorm core).

---

v3.4.7

Changelog

[v3.4.7] - 2025-09-30

Bug fixes

• Fixed issue with dgupdarer not initialized correctly
• Fixed issue with Inno setup's add folder

v3.4.6

Changelog

[v3.4.6] - 2025-09-29

Added

• History Logging:
  • Implemented setup_history_logger and log_to_history methods in CustomLogger to record storm start attempts in a History.log file.
  • Integrated history logging into the StormRouter start endpoint to log both successful and rejected start attempts.
• Environment Router:
  • Introduced EnvironmentRouter to namespace profile endpoints under /environment.
  • Stubbed a new /environment/channels/create endpoint for future channel creation features.

Changed

• CustomLogger Refactor:
  • Centralized logging setup with a for_history flag, queue handler slot, and log file touch logic.
  • Extracted helper methods for file handling and logger setup.
• API Endpoint Restructuring:
  • Migrated profile create/delete endpoints to /environment/profiles/create and /environment/profiles/delete.
  • Updated corresponding middleware, tests, and UI calls to use new routes.
• StormDataContext Output:
  • Standardized output keys to camelCase (e.g., video_url → videoURL, chat_url → chatUrl).
• Message Validation:
  • Improved message validation logic to strip single quotes from input.

Fixed

• Tests:
  • Updated API endpoint tests to use new /environment profile routes.

v3.4.5

Changelog

[3.4.5] - 2025-09-27

New Features

• Enable parallel update checks in the update process

Enhancements

• Bump application version to 3.4.5 across project configs and setup scripts
• Standardize IST timestamp format to YYYY-MM-DD in utility modules
• Update Inno Setup script with new AppId, privileges override, and include dgupdater update files
• Upgrade dgupdater dependency to >=1.2.1

Chores

• Remove deprecated UI build step from the build_and_release script