!filesay

The !filesay command allows streamers and moderators to execute multiple commands or messages stored in a text file hosted at a public URL. Each line in the text file is sent as a separate command/message to the chat. This is extremely useful for performing bulk actions, such as banning multiple users listed in a file.

Usage

To execute the commands/messages from a file URL:

!filesay <url>

Important

• The URL must point to a raw text file (e.g., a Pastebin raw link, a GitHub raw file link).
• Each line in the file will be executed as if typed directly into chat. Ensure the commands are valid (e.g., !ban username).
• There might be rate limits on how many lines can be processed quickly.

Examples

Example File (https://pastebin.com/raw/examplebans):

/ban BotUser1 Spamming
/ban TrollAccount2 Being disruptive
/timeout AnotherUser 600 Repeat offences

Using the command:

Example chat

BroadcasterName:!filesay https://pastebin.com/raw/examplebans

StreamElements:Executing 3 lines from URL...

StreamElements:BotUser1 has been permanently banned from the chat.

StreamElements:TrollAccount2 has been permanently banned from the chat.

StreamElements:AnotherUser has been timed out for 600 seconds.

Parameters

• <url> (Required): The direct URL to a plain text file where each line contains a command or message to be sent.

Configuration

• No specific module needs to be enabled, but the command relies on the bot having the necessary permissions to execute the commands listed within the file (e.g., ban permissions).
• The command’s permission level can be adjusted under Chatbot -> Chat Commands -> Default Commands.

Related Commands

• !nuke: Times out all users who recently chatted based on a specific phrase.
• !nukeusername: Times out all users whose usernames match a pattern.