# BitBot IRC Bot

**Category:** mIRC_Bot
**Original Author:** jesopo

## Description
BitBot is a modular event-driven IRC bot designed to automate various channel interactions such as joining channels, managing user access levels, handling commands, and more.

## Key Features
- **Modular Structure**: The bot uses a modular approach with separate files for different functionalities.
- **Join Management**: Automatically joins specified channels on connection.
- **User Access Control**: Manages user permissions through settings like `accept-invites`, `bot-channel`.
- **Command Handling**: Supports various commands such as nick change, raw IRC command execution, and more.
- **Channel Operations**: Handles channel operations including bans and kicks based on access levels.
- **Event Hooks**: Utilizes hooks for events like joining a server or receiving messages.

## File Analysis
- **accept_invite.py** — Sets whether the bot accepts invites on a given server.
- **acronym.py** — Provides possible meanings for acronyms using an external API.
- **admin.py** — Allows changing the nickname and sending raw IRC commands.
- **badwords.py** — Manages badword lists in channels.
- **birthday.py** — Handles birthday-related messages.
- **bitcoin.py** — Fetches current Bitcoin exchange rates.
- **bot_channel.py** — Sets the main channel for the bot to join on connection.
- **botlist.py** — Sends a predefined message when certain commands are triggered.
- **channel_access.py** — Manages user access levels in channels.
- **channel_blacklist.py** — Refuses joining specified channels.
- **channel_keys.py** — Manages channel keys for authentication.
- **channel_op.py** — Sets and enforces channel operator permissions.
- **channel_save.py** — Automatically joins specified channels on connection.
- **check_certificate.py** — Checks the validity of the server's SSL certificate.
- **check_mode.py** — Manages low and high access modes in channels.
- **coins.py** — Implements a betting system with various commands.
- **command_suggestions.py** — Provides command suggestions based on user input.
- **config.py** — Handles configuration settings for the bot.
- **ctcp.py** — Responds to CTCP requests.
- **database_backup.py** — Backups the database at regular intervals.
- **deferred_read.py** — Postpones parsing of certain lines until after 001 is received.
- **define.py** — Fetches definitions for words using an API.
- **dice.py** — Rolls dice with specified parameters.
- **duckduckgo.py** — Provides a DuckDuckGo search result.
- **ducks.py** — Spawns ducks in channels based on user messages.
- **echo.py** — Echoes, actions, and sends messages to targets.
- **eightball.py** — Provides random responses like an eight-ball.
- **eval_lua.py** — Evaluates Lua code snippets.
- **eval_python.py** — Evaluates Python code snippets.
- **factoids.py** — Manages factoid commands.
- **fake_echo.py** — Sends messages as if they were from the bot itself.
- **format_activity.py** — Formats and logs activity in channels.
- **github.py** — Fetches information about GitHub repositories, issues, and pull requests.
- **google.py** — Provides Google search results.
- **greeting.py** — Sends a greeting message to users when they join a channel.
- **hash.py** — Hashes strings using various algorithms.
- **help.py** — Provides help documentation for commands.
- **highlight_spam.py** — Protects against highlight spam in channels.
- **ids.py** — Displays user and account information.
- **ignore.py** — Manages ignored users and commands.
- **imdb.py** — Fetches information about movies and TV shows from IMDb.
- **imgur.py** — Retrieves image details from Imgur.
- **in.py** — Sets reminders for future events.
- **info.py** — Provides version and other bot-related information.
- **ip_addresses.py** — Manages IP address lookups and nameservers.
- **ircv3.py** — Implements IRCv3 capabilities like stats, echo messages, and more.
- **ircv3_botignore.py** — Ignores specific message tags from bots.
- **ircv3_chathistory.py** — Handles chat history playback.
- **ircv3_echo_message.py** — Echoes sent messages with labels.
- **ircv3_labeled_responses.py** — Manages labeled responses for commands.
- **ircv3_message_tracking.py** — Tracks message IDs and read status.
- **ircv3_metadata.py** — Sets metadata tags for the bot.
- **ircv3_multiline.py** — Handles multiline messages.
- **ircv3_resume.py** — Resumes sessions with server state information.
- **ircv3_server_time.py** — Manages server time synchronization.
- **ircv3_sts.py** — Implements Server Time Stamp (STS) for secure connections.
- **isup.py** — Checks if a given URL is up.