Home

Mediabot v3

Welcome to the official wiki for Mediabot v3, a multi-purpose IRC bot written in Perl for long-running IRC communities.

Mediabot provides public commands, channel memory, quotes, factoids, social analytics, URL and media helpers, radio integration, Partyline administration, monitoring, tests and upgrade tooling.

---

Current release status

Line	Status
3.3	Current stable release — published 2026-07-12
3.1	Previous stable release
3.4dev	Next development line

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

The wiki documents the 3.3 stable release as its conservative production baseline. Development-only behavior is kept separate in Development line 3.4dev.

Official 3.3 links

• GitHub release 3.3
• Download tar.gz
• Download tar.xz
• SHA-256 sums
• SHA-512 sums
• Release provenance
• Archive manifest

The previous 3.1 archives remain available for historical and rollback use.

---

Start here

Use the bot

• Using Mediabot as a regular IRC user
• Public commands
• Social features and community analytics
• Command level index

Install or configure the bot

• Installation
• Configuration
• Running with systemd

Upgrade or operate an existing instance

• Release 3.3 and upgrade notes
• Database model
• Testing
• Troubleshooting
• Monitoring with Prometheus and Grafana

Extend the bot

• Developing plugins
• Plugin and script bridge

---

What is in Mediabot 3.3?

Depending on configuration and channel settings, Mediabot can handle:

• public help and command discovery;
• user activity, profiles and seen lookups;
• channel dashboards, rankings, history and milestones;
• quotes, quote games and quote hall of fame;
• persistent shared factoids with ?keyword recall;
• polls, reminders, delayed tell messages and notes;
• karma, trivia, achievements and lightweight games;
• URL details for common services;
• optional AI helpers;
• radio and media helpers;
• private/admin channel operation;
• Partyline administration;
• Prometheus monitoring;
• static, live, security and startup-integrity validation.

Useful 3.3 commands include:

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

The detailed command syntax belongs in Public commands, while installation and upgrade procedures are kept in their dedicated pages to avoid duplicating operational instructions here.

---

Existing database reminder

A fresh install uses the current install/mediabot.sql reference schema.

An existing instance must be checked against the real configuration and real database. Generate a reviewable plan first:

perl tools/check_schema_drift.pl \
  --conf=mediabot.conf \
  --generate-migration \
  --types \
  --indexes

After reviewing and applying only the required ordered migrations:

perl tools/check_schema_drift.pl \
  --conf=mediabot.conf \
  --strict \
  --types \
  --indexes

Do not infer an upgrade from the fresh-install SQL file alone. See Release 3.3 and upgrade notes.

---

Project philosophy

The goal is not merely to add commands. Mediabot should remain:

• useful to normal IRC users;
• understandable by new operators;
• safe to install and upgrade;
• maintainable over long periods;
• testable and releasable without guesswork.

(c) Teuk 2019-2026