XDCC Search Bot

A fully functional IRC bot for searching and managing XDCC file advertisements.

Features

• XDCC Monitoring: Automatically parses XDCC advertisements from a monitored channel
• Search Commands: Multiple search commands (.s, .search, !search)
• Latest Entries: View newest additions with .latest [keyword]
• Admin Management: Add entries manually via add command in admin channel
• User Requests: Users can request files via request command
• Color Coded: Beautiful color-coded messages using mIRC color codes

Installation

1. Install Python dependencies:

pip install -r requirements.txt

2. Configure the bot by editing config.json:
   • Set your IRC server details
   • Configure channel names
   • Set admin nicknames (optional)

Configuration

Edit config.json to customize:

• IRC Server: Server address, port, SSL settings
• Channels:
  • xdcc_source: Channel to monitor for XDCC advertisements
  • chat: Channel where users interact with the bot
  • admin: Private channel for admin commands
• Admin Nicks: List of admin nicknames (empty = anyone in admin channel)

Usage

Running the Bot

python3 bot.py

Joining the Chat Channel

1. Connect to IRC server: irc.rizon.net:6667
2. Join the chat channel: /join #xdcc-chat
3. Use commands like .latest, .s keyword, etc.

See HOW_TO_JOIN.md for detailed instructions on connecting with various IRC clients.

User Commands (in chat channel)

• .latest [keyword] - Show latest XDCC entries (optionally filtered by keyword)
• .s <keyword> - Search for files
• .search <keyword> - Search for files
• !search <keyword> - Search for files
• request <filename> | <description> - Request a file

Admin Commands (in admin channel)

• add <filename> | <description> - Manually add a new XDCC entry

Examples

.latest anime
.s movie
.search documentary
request My Favorite Show | Season 1 Complete

Database

The bot uses SQLite database (xdcc.db) to store:

• XDCC entries (filename, description, timestamp, source)
• User requests

Color Scheme

The bot uses mIRC color codes:

• Green: Announcements and success messages
• Yellow: Filenames and search results
• Cyan: Info messages and separators
• Red: Error messages
• Pink: Requests

Notes

• The bot automatically parses XDCC advertisements from the source channel
• New entries are automatically announced in the chat channel with colors
• Rate limiting is applied to prevent flooding
• The bot supports reconnection on disconnect