Instructions

• Download the application from the official website or repository.
  • StreamStorm Download Page
  • GitHub Repository
• Install the application by following the setup wizard.
  • Double-click the downloaded installer file and follow the on-screen instructions.
• Always run the application as administrator for proper functionality.
  • Right-click on the application icon and select "Run as administrator".
  • Admin privileges are required to free up RAM.

Requirements

• You need to have a YouTube account (Google account) to use the application.
• In your YouTube account, you need to have at least one channel created. More channels are recommended for better results.
• If you don't have many channels, we have a feature that can create channels for you. click to proceed
• You need to have Chrome browser installed on your system.
• Stable internet connection to function properly.
• To use one channel you need to have at least 300MB of free RAM available on your system. The more channels you use, the more RAM is required.

Using The Application

Step 1. Manage Environment (Login)

Before starting a storm, you need to log in to your YouTube account. StreamStorm now uses cookie-based login as the default method, which is more reliable and efficient.

• In the application UI, click on the Manage Environment button.
• A modal will open with two tabs: Login with Google and Login with Cookie Files.

Login with Google (Recommended)

• Click the Login with Google button.
• A browser window will open with a Google login page.
• Log in with your Google account.
• The application will automatically save the cookies after successful login.
• These cookies will be used to authenticate when starting the storm.

Login with Cookie Files

• Click Select Cookie Files to open a file explorer.
• Select your cookie files (JSON or Netscape format). You can select multiple files.
• Only cookies for youtube.com will be parsed and saved.
• Click Submit Cookies to upload and validate the cookies.
• A browser window will open to fetch the available channels from your account.

Alternative: Browser Profiles Login (Legacy)

The temp profiles-based login is still available for users who prefer it. You can switch the login method in the Settings → General section.

• To use browser profiles login:
  • In the application UI, click on the Manage Environment button.
  • In the create profile section, enter the number of profiles you want to create.
  • Click on the Create Profiles button.
  Caution: Do not minimize or move away from the browser window while creating profiles.
• The application will open a browser window and prompt you to log in to your YouTube account.
• Login to your YouTube account in the browser window that opens.
• After logging in, the application will fetch all the channels available in your YouTube account.
• After fetching the channels, the application will close itself and start creating the profiles.
• Each temp profile will take up to 150MB of storage space.

The reason for creating all these profiles is that each channel requires a separate profile to avoid any conflicts or issues with opening the browser window, since one browser window locks its own profile from being accessed by another instance of the same browser.

There is also provision to delete all temp profiles created by the application, in case you want to start fresh.

Step 2. Starting The Storm

First open the application and make sure you have logged in as mentioned in Step 1.

• You need to provide all the required information to start the storm.
  1. Video URL: Enter the URL of the YouTube video you want to storm.
     • This should be a valid youtube url copied from the url bar of your browser.
     • It should not be a playlist or channel URL.
     • Example: https://www.youtube.com/watch?v=VIDEO_ID
  2. Messages: Enter the messages you want to send in the chat.
     • You can enter multiple messages separated by a new line.
     • Example:
       Hello everyone!
       Let's support this video!
     • You can also use emojis in the messages.
     • You can enter as many messages as you like.
  3. Subscribe switch
     • Some channels require you to subscribe to them before you can comment on their videos.
     • If the channel you are trying to storm requires you to subscribe, then you need to enable this switch.
  4. Subscribe and Wait Switch
     • Some channels require you to subscribe to them and wait for a fixed time before you can comment on their videos.
     • If the channel you are trying to storm requires you to subscribe and wait, then you need to enable this switch.
  5. Subscribe and Wait Time
     • If you have enabled the Subscribe and Wait switch, then you need to enter the time in seconds you want to wait after subscribing to the channel.
     • This is the time you want to wait before starting the storm.
     • Example: 10 (for 10 seconds)
  6. Slow mode
     • Some channels have slow mode enabled, which means you can only send a limited number of messages in a fixed time.
     • If the channel you are trying to storm has slow mode enabled, then you need to enter the time in seconds you want to wait before sending each message.
     • Example: 5 (for 5 seconds)
  7. Channel selection
     • Basic
       • In basic mode you just enter the number of channels you want to use for the storm.
       • The application will automatically select the channels for you, starting from the first channel in the list, to the nth channel you provided.
     • Intermediate
       • In intermediate mode you can select a range of channels you want to use for the storm.
       • for example if you have 10 channels and you want to use channels from 3 to 7, then you can give start index as 3 and end index as 7.
       • The application will select the channels from the start index to the end index you provided.
     • Advanced
       • In advanced mode you can manually select the channels you want to use for the storm.
  8. Load in Background
     • If you don't want the browser ui to be visible while the storm is running, you can enable this switch.
     • This will load the browser in the background and the storm will run in the background.

     Note: ⚠ This feature is currently experimental and may not work as expected. We're actively working on fixing the bugs.

  9. Start Storm
     • After providing all the required information, you can click on the Start Storm button to start the storm.
     • The application will open the browser and start sending the messages in the chat.
     • You can see the progress of the storm in the application UI.
     • You can stop the storm at any time by clicking on the Stop Storm button.

Creating Channels

Make sure you have logged in first (see Step 1), then click on the Manage Environment button.

Without Logo

• Do not toggle the logo required switch
• Enter names of channels separated by a new line
• Click on the Create Channels button.
• This will start creating channels with the names provided without any logo.

With Logo

You can also create channels with logo, either random logo or custom logo provided by you

• Toggle the logo required switch

Random Logo

• Click on Random Logo radio button.
• Enter names of channels separated by a new line.
• Click on the Create Channels button.
• This will start creating channels with the names provided with random logo from google's logo collection.

Custom Logo

• Click on Custom Logo radio button.
• In this you need not provide channel names in the textbox.
• You need to have a directory in your local PC with image files with channel name as its name.
• If you want to create 10 channels with logo, you need to have 10 files in the directory, one for each channel, with the channel name as the file name and the logo as the image.
• For example, if you have an image file named Pro Gamer.png in the directory, then a channel named Pro Gamer with the logo Pro Gamer.png will be created.
• Note: only image files with .png .jpg .jpeg extension are supported.
• Enter the directory path in the textbox provided and click Validate .
• After validating, click on the Create Channels button.
• This will start creating channels with the names and logo provided.

Note: ⚠ Custom logo is currently experimental and may not work as expected. We're actively working on fixing the bugs.

Realtime Dashboard

Once you start a storm, the Realtime Dashboard provides comprehensive monitoring and control capabilities. It displays live statistics about your storm and allows you to manage individual instances in real-time.

Dashboard Metrics

The dashboard displays the following real-time metrics:

• Storm Status
  • Shows the current state of the storm: Running, Paused, or Stopped.
• Active Storming Instances
  • Displays the number of accounts currently active and sending messages in the chat.
• Dead Instances
  • Shows the number of accounts that have stopped storming due to errors, disconnections, or other issues.
• Total Messages Sent
  • The cumulative count of all messages sent by all active accounts since the storm started.
• Message Rate
  • Shows the current rate of messages being sent per minute across all active instances.
• Storm Duration
  • Displays the total elapsed time since you pressed the Start button.
• Live Log Feed
  • A real-time log stream showing all storm activities, including message sends, errors, and status changes.

Storm Controls

You can control the storm while it is running by using the following controls:

1. Pause
   • This will pause the storm and the application will stop sending messages in the chat.
   • The application will keep the browser open and wait for you to resume the storm.
2. Resume
   • This will resume the storm and the application will start sending messages in the chat again.
3. Change Messages
   • Sometime when the storm is running, you might want to change the messages you are sending in the chat.
   • You can click on the Change Messages button to change the messages.
   • This will open a dialog where you can enter the new messages you want to send in the chat.
4. Change Slow Mode
   • If you want to change the slow mode time while the storm is running, you can click on the Change Slow Mode button.
   • This will open a dialog where you can enter the new slow mode time you want to use.
5. Don't wait
   • Some time what happens is that when most of the channels are ready to storm and is still waiting for the remaining channels to be ready, you can click on the Don't wait button.
   • This will make the application to not wait for the remaining channels and start sending messages in the chat immediately.
6. Add Channels
   • Sometimes when the storm is running, you notice that there is more free RAM available on your system and you want to start storming with more channels, you can click on the Add Channels button.
   • This will open a dialog where you can select channels you want to add to the storm.
   • Note: You need to have enough temp profiles, and enough channels on your YouTube account to add more channels to the storm.
7. Stop Storm
   • If you want to stop the storm, you can click on the Stop Storm button.
   • This will stop the storm and the application will close all the browser instances opened by the application.

Channel Status Menu

The Channel Status Menu provides detailed visibility into all your accounts and their current states.

• Opening the Menu
  • Click the Channel Status button located below the Stop button in the dashboard.
• Information Displayed
  • Lists all accounts/channels associated with your logged-in StreamStorm account.
  • Shows the current status of each channel: Idle, Dead, Getting Ready, Ready, or Storming.
• Kill Individual Instance
  • Each channel entry has a Kill button next to it.
  • Clicking this button will immediately stop that specific instance from storming without affecting other active instances.
  • Useful for removing problematic accounts or freeing up resources during a storm.

View Configurations Menu

The View Configurations Menu displays all the parameters configured for the current running storm.

• Opening the Menu
  • Click the View Configurations button located below the Channel Status button in the dashboard.
• Information Displayed
  • Video URL being stormed.
  • Number of channels selected for storming.
  • Current slow mode setting.
  • Subscribe setting status.
  • Subscribe and Wait configuration (if enabled).
  • Load in Background setting status.
  • All configured messages being used for the storm.

Settings Menu

Access the Settings menu by clicking the settings icon in the application. The Settings menu contains the following sections:

General

• Login Method
  • Cookies Based Login (Default) - Uses saved cookies for authentication. More efficient and reliable.
  • Browser Profiles - Uses separate browser profiles for each channel. Legacy method that requires more storage.
• Clear Login Data
  • Remove all saved cookies, browser profiles, and channel data.
  • You will need to log in again after clearing the data.

Host Configuration

• Set the base URL of the StreamStorm backend server.
• The backend server runs on your local machine on port 1919 by default.
• Default URL: http://localhost:1919
• Change this if you're accessing the application from another device or using a custom server setup.

Accessing The Application From Another Device

You can access the application from another device on the same network or a different network. The device can be a mobile phone, tablet, or another computer. Make sure the application is running on your machine - don't close the UI, otherwise the local server will shut down.

• Same Network
  • Find your IP address by running ipconfig in the command prompt. Look for the IPv4 Address (e.g., 192.168.1.100).
  • Access the application by entering http://<your-ip-address>:1919 in the browser.
• Different Network
  • Configure port forwarding on your router to forward port 1919 to your machine's IP address.
  • Find your public IP by searching "What is my IP" on Google (e.g., 203.0.113.0).
  • Access the application by entering http://<your-public-ip-address>:1919 in the browser.

Appearance

• Theme
  • Light - Light color scheme for the application.
  • Dark - Dark color scheme for the application.

API Keys

Configure API keys for AI-powered features like message generation and channel name suggestions. All API keys are stored locally on your PC.

• OpenAI
  • API Key
  • Base URL (optional, for custom endpoints)
  • Model name
• Anthropic (Claude)
  • API Key
  • Model name
• Google (Gemini)
  • API Key
  • Model name

Precautions

• The less free RAM you have after clicking Start Storm, the more likely the storming process will be slower, and the more likely it is to fail. So choose the number of accounts responsibly. For example, if you have 10 GB of free RAM, use only 6-7 GB for storm and keep the rest free, for a smooth flow.

Using the StreamStorm MCP Server

StreamStorm exposes an MCP (Model Context Protocol) server that allows AI assistants to control the storm programmatically. The MCP server is accessible at http://localhost:1919/mcp when the application is running.

You can perform all the actions available in the UI through the MCP server, plus additional tools, and more advanced storm management capabilities.

Gemini CLI

You can add the StreamStorm MCP server to Gemini CLI using either the configuration file or the command line.

Option 1: Configuration File

Add the following to your Gemini CLI configuration:

{
  "mcpServers": {
    "StreamStorm": {
      "httpUrl": "http://localhost:1919/mcp"
    }
  }
}

Option 2: Command Line

gemini mcp add StreamStorm http://localhost:1919/mcp --transport http --scope user

Claude Desktop

Add the following to your Claude Desktop configuration file:

{
  "mcpServers": {
    "StreamStorm": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "http://localhost:1919/mcp"
      ]
    }
  }
}

ChatGPT

To use StreamStorm with ChatGPT, you need to expose the local server to the internet and configure the ChatGPT app.

1. Expose the server to the internet
   • You need to expose http://localhost:1919 to the internet using a tunneling service like Cloudflare Tunnel or ngrok.
   • For ngrok, run: ngrok http 1919
   • Note down the public URL provided by the tunnel service.
2. Enable Developer Mode
   • In ChatGPT, enable developer mode in your settings.
3. Create the App
   • Go to Settings → Apps → Create App.
   • Enter name: StreamStorm
   • Add a description for the app.
   • In the URL field, enter: <your-tunnel-url>/mcp
   • Select "No authentication".
   • Check the confirmation checkbox and click Create.

Sample Prompts

Here are some example prompts you can use with AI assistants to control StreamStorm:

• Start storming on https://www.youtube.com/watch?v=dQw4w9WgXcQ with 5 channels with slow mode 3 seconds
• Start storming on https://www.youtube.com/watch?v=dQw4w9WgXcQ with 5 channels with slow mode 3 seconds and also subscribe and wait for 30 seconds
• Start storming on https://www.youtube.com/watch?v=dQw4w9WgXcQ with 3 channels with crazy messages
• Pause the storm
• Resume the storm
• Stop the storm
• Change slow mode to 2 sec
• Add 2 more channels to the storm

...and many more! The AI assistant can understand natural language commands and translate them into appropriate tool calls.

Available Tools

The following tools are available through the MCP server as of 27-12-2025: