# BitBot IRC Bot

**Category:** Standalone_Bot
**Original Author:** jesopo

## Description
BitBot is a modular event-driven IRC bot designed to automate various tasks on IRC networks. It includes features such as command handling, channel management, and user interaction.

## Key Features
- **Command Handling**: Implements commands for actions like changing nicknames, sending raw IRC lines, kicking users, and more.
- **Channel Management**: Manages channel settings, including joining channels automatically upon connection.
- **User Interaction**: Provides functionality to send messages, handle CTCP requests, and manage user access levels.
- **Configuration Settings**: Allows setting various bot behaviors through configuration files.

## File Analysis
- **accept_invite.py** — Handles accepting invites on specific IRC servers.
- **acronym.py** — Fetches possible meanings of acronyms from an external API.
- **admin.py** — Manages administrative actions like changing the nickname and sending raw IRC commands.
- **badwords.py** — Manages a list of bad words in channels, allowing users to add or view them.
- **birthday.py** — Handles birthday-related commands for users.
- **bitcoin.py** — Fetches current Bitcoin exchange rates from an external API.
- **bot_channel.py** — Sets the main channel where the bot will join upon connecting.
- **botlist.py** — Sends a predefined message when certain commands are received in channels.
- **channel_access.py** — Manages user access levels and permissions within channels.
- **channel_blacklist.py** — Refuses to join specified channels based on settings.
- **channel_keys.py** — Manages channel-specific keys or passwords for secure connections.
- **channel_op.py** — Defines ban formats and kick reasons for different access levels.
- **channel_save.py** — Joins autojoin channels upon connecting to a server.
- **check_certificate.py** — Checks the validity of SSL certificates before establishing a connection.
- **check_mode.py** — Manages channel modes and their associated permissions.
- **coins.py** — Implements betting and lottery functionalities with various commands.
- **command_suggestions.py** — Provides suggestions for unknown or misspelled commands.
- **config.py** — Contains configuration settings and handling logic.
- **ctcp.py** — Responds to CTCP requests from users.
- **database_backup.py** — Backups the bot's database at regular intervals.
- **deferred_read.py** — Delays parsing of certain IRC messages until after the 001 message is received.
- **define.py** — Fetches definitions for given words using an external API.
- **dice.py** — Rolls dice with specified parameters.
- **duckduckgo.py** — Retrieves first search result from DuckDuckGo.
- **ducks.py** — Spawns ducks in channels based on user activity and settings.
- **echo.py** — Echoes messages, performs actions, and sends private messages.
- **eightball.py** — Provides random answers to yes/no questions.
- **eval_lua.py** — Evaluates Lua code snippets provided by users.
- **eval_python.py** — Evaluates Python code snippets provided by users.
- **factoids.py** — Manages factoid-based knowledge base.
- **fake_echo.py** — Forwards messages to the bot itself for monitoring purposes.
- **format_activity.py** — Formats and logs IRC activity events.
- **github.py** — Retrieves information from GitHub, including issues and pull requests.
- **google.py** — Searches Google for a given query.
- **greeting.py** — Sends greetings to users upon joining channels.
- **hash.py** — Hashes strings using various algorithms.
- **help.py** — Provides help documentation for commands.
- **highlight_spam.py** — Protects against highlight spam by kicking or banning offenders.
- **ids.py** — Displays user IDs and account information.
- **ignore.py** — Manages ignored users, channels, and commands.
- **imdb.py** — Searches for movie and TV show information on IMDb.
- **imgur.py** — Retrieves image details from Imgur.
- **in.py** — Sets reminders based on time intervals.
- **info.py** — Provides version and other informational data about the bot.
- **ip_addresses.py** — Resolves IP addresses to their geolocation data.
- **ircv3.py** — Implements support for IRCv3 capabilities like stats, event playback, and more.
- **ircv3_botignore.py** — Ignores messages from specific bots.
- **ircv3_chathistory.py** — Manages chat history and event playback.
- **ircv3_echo_message.py** — Echoes sent messages for debugging purposes.
- **ircv3_labeled_responses.py** — Supports labeled responses with message tags.
- **ircv3_message_tracking.py** — Tracks and logs message IDs.
- **ircv3_metadata.py** — Sets metadata about the bot on connected servers.
- **ircv3_multiline.py** — Handles multiline messages in IRC.
- **ircv3_resume.py** — Manages server state resumption.
- **ircv3_server_time.py** — Retrieves and sets server time information.
- **ircv3_sts.py** — Implements Server Time Security (STS) for secure connections.
- **isup.py** — Checks if a given URL is up or not.