-
Notifications
You must be signed in to change notification settings - Fork 1
Home
Welcome to the official wiki for Mediabot v3.
Mediabot is a multi-purpose IRC bot written in Perl and built around real IRC operations: channel administration, user and channel management, command dispatching, database-backed public commands, URL and media helpers, Partyline administration, monitoring, testing, and long-running bot maintenance.
This wiki is the documentation hub for the project.
- Stable release:
3.1 - Current development line:
3.2-dev
The project follows a simple versioning rule:
- odd minor versions are stable releases;
- even minor versions are development / beta lines.
Examples:
-
3.1= stable release; -
3.2-dev= current development branch; -
3.3= next stable release target.
Use the stable release if you want a predictable install baseline. Use the development line if you want the current work-in-progress version from Git.
If you want to install Mediabot from scratch, start here:
This page covers the Debian install path, database setup, Perl modules, runtime dependencies, and release-vs-development installation choices.
If you already installed the bot and want to understand the configuration files and channel feature flags:
Important runtime flags include:
+Games+AchievementAnnounce+UrlTitle+Youtube+YoutubeSearch+RandomQuote+Claude+NoColors+AntiFlood
If you want to know what users and operators can do:
- Public commands
- Social features and community analytics
- Private and admin commands
- Command level index
For runtime operation and troubleshooting:
Recent Mediabot v3 development builds include a guarded extension bridge for trusted external Perl, Python and Tcl scripts.
Start here:
The bridge is disabled by default, dry-run by default, and scripts must talk to Mediabot through a strict JSON protocol. This keeps existing IRC commands safe while allowing maintainers to add small language-specific integrations when needed.
Depending on configuration and enabled features, Mediabot can handle:
- IRC administration and moderation;
- user, hostmask and channel management;
- database-backed public commands;
- URL title handling and media helpers;
- YouTube, TMDB, music and radio-related helpers;
- Partyline-based remote administration;
- Prometheus metrics;
- runtime testing and schema drift validation;
- social and community analytics.
Recent development builds also include a richer social layer:
-
achievements/achievs -
profil/profile radar-
dashboard/chanstats -
leaderboard/lb -
chronos/chrono/timeline -
features/capabilities/caps -
observatory/obs -
mood/ambiance duel-
horoscope/horo -
compat/affinity -
quotegame/qg
These commands are documented in:
If you are new to the project:
- Installation
- Configuration
- Public commands
- Social features and community analytics
- Private and admin commands
- Partyline
- Testing
- Troubleshooting
- Release and upgrade notes
If you are working on the bot rather than only using it, the most useful pages after installation are:
- Testing
- Database model
- Maintainer command audit
- Monitoring with Prometheus and Grafana
- Release and upgrade notes
These pages are especially important when preparing a new release, validating a fresh install, or checking an existing database with the schema drift tools.
The goal is not just to keep adding features.
The goal is to make Mediabot:
- installable on a fresh system;
- maintainable;
- understandable;
- documented;
- observable;
- releasable without guesswork.
The wiki should describe the bot as it actually exists: stable install path, current development features, real runtime commands, and the operational practices used to keep it running.
If you are here to install Mediabot, go directly to:
If you are here to explore what the current development version can do:
(c) TeuK 2019-2026