Home

Mediabot v3

Welcome to the official wiki for Mediabot v3.

Mediabot is a multi-purpose IRC bot written in Perl and built for real IRC communities: public commands, channel memory, quotes, factoids, URL details, radio helpers, social analytics, Partyline administration, monitoring, testing and long-running operations.

This wiki is the documentation hub for the project.

---

Current release status

• Stable release: 3.1
• Current development line: 3.2dev-*
• Next stable target: 3.3 — not released yet

Mediabot uses odd minor versions for stable lines and even minor versions for development/beta lines.

3.1                 current stable line
3.2dev-YYYYMMDD_*   current development builds
3.3                 future stable target

This wiki follows the current development tree. It may therefore document fixes and commands newer than the latest stable archive.

---

Start here

If you just want to use the bot

Read this first:

• Using Mediabot as a regular IRC user

Then keep these pages nearby:

• Public commands
• Social features and community analytics
• Command level index

If you want to install the bot

• Installation
• Configuration
• Running with systemd

If you operate or upgrade an existing instance

• Release and upgrade notes
• Database model
• Testing
• Troubleshooting

If you extend the bot

• Developing plugins
• Plugin and script bridge

---

What Mediabot can do

Depending on configuration and channel settings, Mediabot can handle:

• public help and command discovery;
• user activity and seen lookups;
• channel dashboards, rankings and milestones;
• quotes, quote games and quote hall of fame;
• shared factoids with ?keyword recall;
• polls, reminders, tell messages and notes;
• karma, trivia and games;
• URL title/details for common services;
• AI helpers when configured;
• radio and media helpers;
• private/admin channel operation;
• Partyline administration;
• monitoring and testing.

Recent development builds include commands such as:

seen, stats, mood, onthisday, milestone, recap, dashboard,
leaderboard, chronos, achievements, factoids, topquote,
convert, tell, quotegame, URL rich previews

---

Recommended reading order

For a normal user:

1. Using Mediabot as a regular IRC user
2. Public commands
3. Social features and community analytics
4. Command level index

For an operator:

1. Installation
2. Configuration
3. Running with systemd
4. Release and upgrade notes
5. Testing
6. Troubleshooting

For a contributor:

1. Developing plugins
2. Plugin and script bridge
3. Database model
4. Maintainer command audit

---

Upgrade reminder for existing databases

A fresh install follows install/mediabot.sql.

An existing instance must be checked against its real configuration and database. For example, for the Undernet instance:

perl tools/check_schema_drift.pl --conf=mbundernet.conf --generate-migration
perl tools/check_schema_drift.pl --conf=mbundernet.conf --strict --types

Do not guess schema state from the fresh install file alone.

---

Project philosophy

The goal is not just to keep adding commands.

The goal is to make Mediabot:

• usable by normal IRC users;
• understandable by beginners;
• safe to operate;
• documented enough to maintain;
• testable and releasable without guesswork.

(c) Teuk 2019-2026