The IRC Driven Channel Bot is an intelligent bot that provides various features for IRC channels registered on our website. It can:

• Log channel conversations and make them searchable
• Track channel users and their activity
• Provide weather information
• Allow users to submit and search quotes
• Announce channel news automatically
• Expand URLs to show rich previews
• Link IRC identities to website accounts
• Display channel statistics

1. Navigate to your channel's page on IRC Driven
2. Click on "Admin" in the channel menu
3. Go to "Settings"
4. Check the "Enable Channel Bot" option
5. Invite the bot to your channel on IRC (see below)
6. If your channel is moderated, give the bot voice (+v) so it can speak; otherwise no modes are needed

Inviting the bot:

Use /invite [botname] #yourchannel on IRC. Network admins can also enable the bot by inviting it directly—if your IRC identity is linked and the channel is indexed, the bot will join and enable automatically.

Note: You must be a channel admin on the website to enable the bot (or a network admin to use the invite method).

The bot responds to the following commands in the channel (use ! prefix):

Private Commands: Send these via /msg [botname] command:

• LOGIN username token - Link your IRC identity to your website account
• HELP - Get help via private message

The bot can log all channel activity including:

• Messages
• Actions (/me commands)
• Joins/Parts/Quits
• Nick changes
• Mode changes
• Topic changes
• Kicks

Features:

• Full-text search: Search through logged conversations using PostgreSQL full-text search
• Day separators: Logs are organized by day for easy navigation
• User tracking: Links authenticated users to their website profiles
• Export options: Download logs in mIRC format (RAW)
• Privacy control: Logs can be made private (channel admins only)

Enable logging in your channel's settings and choose whether logs should be public or private.

IRC Login allows you to link your IRC identity to your website account. This enables:

• Your messages to show with your profile link in logs
• Using your saved weather location with !weather
• Submitting quotes with attribution
• Access to authenticated-only features

How to login manually:

1. Go to your IRC Link settings on the website
2. Generate an authentication token
3. Send a private message to the bot: /msg [botname] LOGIN yourusername yourtoken

Auto-Login: Once you've logged in successfully once, you can enable auto-login in your IRC Link settings. The bot will automatically recognize you when you join channels based on your hostmask.

Security: Auto-login supports both strict and non-strict ident. Strict ident (user@host) provides better security than non-strict (~user@host).

When users post URLs in the channel, the bot can automatically fetch and display information about them. Special handling is provided for:

Enable URL expansion in your channel's bot settings to automatically show these rich previews.

Channel admins can post news articles on the website that will be automatically announced in the IRC channel.

Features:

• New articles are announced automatically when published
• Only approved and public articles are announced
• Announcements include title and link to the full article
• Can be enabled/disabled per channel

Enable news announcements in your channel's bot settings to keep your community informed.

The quotes system allows users to save memorable moments from channel conversations.

Submitting Quotes:

• Use !quote add followed by the quote text
• You must be logged in to submit quotes
• Quotes can include multiple lines using your configured delimiter (default: |)
• Example: !quote add <alice> This is great! | <bob> I agree!

Viewing Quotes:

• !quote [uuid] - Display a specific quote
• !quote random - Show a random approved quote
• !quote search [text] - Search quotes by keyword

Approval Process:

• Quotes submitted via IRC are automatically linked to your channel and network
• They appear on your channel's quotes page immediately
• Site admins can approve quotes to appear on the main quotes page

Enable quotes in your channel's bot settings and customize the delimiter character if needed.

The weather command provides current weather information using OpenWeatherMap.

Usage:

• !weather London - Get weather for a specific location
• !weather 90210 - Use zip codes
• !weather - Use your saved location (requires login)

Saving Your Location:

1. Log into the website
2. Go to your IRC Link settings
3. Set your weather location using the interactive map
4. Now you can use !weather without specifying a location

Enable weather commands in your channel's bot settings.

The bot tracks channel users and their activity, displaying this information on your channel's users page.

Information Tracked:

• Currently online users with their status (op, voice, etc.)
• User join/part/quit times
• Last seen timestamps
• Quit messages
• Links to website profiles for authenticated users

Features:

• Online users are sorted by status
• Shows user count and online count
• History of all users who have been in the channel
• Automatic updates every 5 minutes via WHO refresh

User tracking is automatically enabled when the bot joins your channel.

Channel admins can configure the following settings:

Access these settings from your channel's admin panel under "Bot Settings".

As a channel admin, you have several options for managing logs:

Bulk Delete:

• Use checkboxes to select multiple log entries
• Click "Delete Selected" to remove them
• Useful for removing spam or unwanted content

Search & Filter:

• Use the search box to find specific messages
• Click on a username to filter by that user
• Search results are ranked by relevance

Export:

• Click the "RAW" button to view logs in mIRC format
• Download logs for archival purposes
• Import into other log viewers

Privacy: You can make logs private in your channel settings so only admins can view them.

If the bot isn't responding, verify the following:

1. Bot is enabled: Check your channel settings to ensure the bot is enabled
2. Bot is in channel: Look for the bot in your channel's user list
3. Moderated channels: If your channel is moderated (+m), the bot needs voice (+v) to speak
4. Command is enabled: Check that the specific feature (weather, quotes, etc.) is enabled in settings
5. Correct syntax: Use ! prefix for channel commands, /msg for private commands
6. Network connection: Ensure the bot's connection to the network is stable

Common Issues:

• Weather not working: Make sure you've either specified a location or logged in with a saved location
• Quotes require login: You must be logged in to submit quotes
• Private commands: LOGIN must be sent via private message, not in channel

If problems persist, contact site staff for assistance.