Want a Bot?

Run your own XDCC file-sharing bot on IRC and get your packs indexed on our search engine

🤖

Share Your Files With the World

Set up your own XDCC bot in minutes using our custom iroffer software. Works both Windows and Linux. Serve files across multiple IRC networks, and your packs will automatically appear on XDCC-Search.com for thousands of users to find.

What Can the Bot Do?

📡

Multi-Network

Run your bot on multiple IRC networks simultaneously from a single instance

⚡

High Speed

Optimized DCC transfers with configurable buffer sizes up to 10Gbps connections

📂

Auto-Indexing

Monitors your file directories and automatically creates packs from new files

📢

Auto-Announce

Announces packs to channels with colorful formatting and new file alerts

🔒

Admin Controls

Password-protected admin commands via IRC private message for full remote management

🔍

Search Indexed

Your packs automatically get indexed on XDCC-Search.com for maximum visibility

EASY! Installation & Setup (takes less than 5 minutes and your bot is running)

1

Download the Bot

Grab the latest iroffer package from our downloads page.

wget https://bluetorrents.com/iroffer.tar.gz
2

Extract the Archive

Unpack it into your preferred directory.

tar -zxvf iroffer.tar.gz
3

Install Python 3.7+

The bot requires Python 3.7 or higher. Most modern Linux distros have this already.

python3 --version
4

Edit Your Config

Edit xdccbot_config.json with your IRC server, channels, nickname, and file directories. A default config is created on first run.

5

Launch the Bot

Start the bot and watch it connect, scan your files, and begin announcing packs.

python3 iroffer
💡 Pro Tip: Run the bot inside a screen or tmux session so it keeps running after you disconnect from SSH. Use screen -S iroffer to start, then Ctrl+A, D to detach. Use psmux for windows.

Configuration Guide

The heart of your bot is xdccbot_config.json. Below is a complete example configuration with all the important settings. Customize it to match your server, channels, and files.

xdccbot_config.json
{ // ─── IRC Server Settings ─── "server": "irc.coreirc.net", "port": 6667, "nick": "[EWG]your_nick", "ident": "ewg", "realname": "ELITEWAREZ iroffer | windox revised v3.7", "external_ip": "", // ─── Channels ─── "channels": [ "#elitewarez" ], "channels_new_only": [], // ─── Admin Access ─── "admin_password": "change_this_password", "admin_hosts": [ "*!*@your.hostname.here", "*!*@127.0.0.1", "your_nick!*@*" ], "admin_nicks": ["your_nick"], // ─── File Directories ─── "file_dirs": [ "/home/user/files/movies", "/home/user/files/tv" ], "file_extensions": [ ".mkv", ".avi", ".mp4", ".zip", ".tar", ".iso", ".mp3", ".ts", ".mpg", ".wmv" ], "file_exclude_patterns": [ "*.txt", "*.nfo", "*sample*", "*SAMPLE*" ], // ─── Announce Settings ─── "announce_color": [ "04", "07", "08", "09", "03", "10", "02", "12", "06", "13" ], "download_start_message": "Hi {nick}, enjoy {filename}! Visit https://xdcc-search.com to find more packs.", // ─── Transfer Limits ─── "max_transfers": 3, "max_transfers_per_user": 1, "max_queue": 50, "max_queue_per_user": 5, "max_speed_limit": 0, // ─── Announce Behavior ─── "announce_batch_size": 1, "announce_interval": 1, "auto_announce": true, "announce_new_files": true, "announce_removed_files": false, // ─── File Monitoring ─── "monitor_files": true, "auto_remove_deleted": true, "check_deleted_interval": 600, // ─── DCC Settings ─── "dcc_buffer_size": 2097152, "dcc_timeout": 30, "dcc_listen_timeout": 60, "user_inactive_timeout": 60, // ─── Misc ─── "auto_renumber_packs": false, "statefile": "xdccbot_state.json", "xdcclistfile": "xdccbot_packlist.txt", // ─── Additional Networks (optional) ─── "networks": [ { "name": "rizon", "server": "irc.rizon.net", "port": 6667, "nick": "[EWG]your_nick", "ident": "ewg", "channels": [ "#elitewarez" ], "channels_new_only": [], "enabled": true } ] }
⚠️ Important: Change "admin_password" to something strong and unique before running the bot. Also update "admin_hosts" to match your actual IRC hostmask so only you can control the bot.

Configuration Tips

🏷️ nick

Your bot's IRC nickname. Use [EWG]your_name format to be part of the EWG family.

🆔 ident

The bot's IRC username/ident. Defaults to ewg. Shown in your hostmask as nick!ident@host.

📢 channels

Channels that receive all pack announcements including full list cycles.

🆕 channels_new_only

Channels that only get notified when new packs are added — no full list spam.

📁 file_dirs

Point to your file directories. Supports multiple paths — the bot scans all of them.

🎯 file_extensions

Filter which file types to serve. Only files matching these extensions become packs.

🚀 max_transfers

How many simultaneous downloads your bot will serve. Adjust based on your bandwidth.

⏱️ max_speed_limit

Throttle bandwidth in KB/s. Set to 0 for unlimited speed.

📦 dcc_buffer_size

Buffer size for DCC transfers. Use 4194304 (4MB) for 10Gbps connections, 2097152 (2MB) for standard.

🔄 monitor_files

When enabled, the bot watches your directories and automatically picks up new files as packs.

🌐 networks

Add additional IRC networks to serve files on multiple networks from one bot instance.

🗑️ auto_remove_deleted

Automatically removes packs when files are deleted from disk. Keeps your list clean.

Running as a Service ( OPTIONAL )

For production use, run the bot as a systemd service so it starts automatically on boot and restarts if it crashes.

/etc/systemd/system/iroffer.service
[Unit] Description=XDCC iroffer Bot After=network.target [Service] Type=simple User=your_username WorkingDirectory=/home/your_username/iroffer ExecStart=/usr/bin/python3 /home/your_username/iroffer/iroffer Restart=always RestartSec=10 [Install] WantedBy=multi-user.target

Then enable and start it:

Terminal
sudo systemctl daemon-reload sudo systemctl enable iroffer sudo systemctl start iroffer sudo systemctl status iroffer

Multi-Network Setup

The bot can connect to multiple IRC networks simultaneously. Your primary server settings handle the main connection, and the "networks" array lets you add additional networks. Each network gets its own nickname, channels, and can be individually enabled or disabled.

💡 How It Works: The bot maintains separate connections to each network, announces packs in all configured channels, and handles download requests from users on any network. Your packs on all networks will be indexed by our search engine.

Getting Your Packs on XDCC-Search.com

Once your bot is running and announcing packs in supported channels, our monitoring system will automatically detect and index your packs. Here's what you need to know:

  1. Join a monitored channel — We index channels on CoreIRC, Rizon, SceneP2P, and other networks. #elitewarez is indexed on multiple networks.
  2. Enable auto-announce — Set "auto_announce": true so your packs get announced regularly.
  3. Be patient — New packs appear in search results within minutes of being announced.
  4. Keep the bot online — Packs from offline bots eventually get removed from the index.
🔍 Want a specific channel indexed? Contact us and we'll add your channel to our monitoring list.

Need Help?

Having trouble getting your bot set up? We're here to help.

  • Join #elite-chat on irc.coreirc.net or irc.rizon.net and ask for assistance
  • Use our contact form to send us a message
  • Check the How to Use XDCC guide if you're new to IRC

Thanks for sharing your files with the community.

The more bots we have, the stronger the network becomes.

— The King of Dreams