Repository navigation
Commands statistics
Reviewed against Mediabot 3.6dev-20261006_084503 (snapshot of 6 October 2026). This is the development-line reference; consult the tagged source for stable-release behaviour.
Examples use !; replace it with the configured trigger (m, #, etc.). See notation, transport and permissions. Each entry names its registered IRC surfaces; a handler accepting a private context does not itself make a name callable by PM. Plugin and dynamic-command policy may add restrictions.
achievements · achievs · active · ambiance · awards · capabilities · caps · chanstatlines · chanstats · chrono · chronos · compare · cstat · dashboard · features · heatmap · last · lb · leaderboard · memory · milestone · milestones · monthstats · mood · obs · observatory · onthisday · otd · profil · profile · radar · seen · stats · streak · timeline · top · topsay · when · whereis · whotalk · whotalks · wordcount · yearbook
Show achievements for yourself, a nick, the catalogue, the top unlocks, or how close you are to the next ones.
Access: public. IRC surfaces: channel.
!achievements [nick|list|all|top|progress [nick]]
No argument shows caller; a nick selects that profile. list/all is the catalogue; top shows unlock ranking; progress [nick] explains progress. +AchievementAnnounce controls automatic public unlock announcements, not the existence of earned achievements.
Alias of achievements; the same options, defaults and checks apply.
Access: public. IRC surfaces: channel.
!achievs [nick|list|all|top|progress [nick]]
List nicks active in the last N hours or days (e.g. 24h, 7d).
Access: public. IRC surfaces: channel.
!active [today|yesterday|week|month|now|<N>d|<N>h]
Default rolling 24h. now means 60 minutes; today, yesterday, week, month are calendar windows. Positive numeric Nh/Nd select rolling windows; output is capped at thirty nicks.
Alias of mood; the same options, defaults and checks apply.
Access: public. IRC surfaces: channel.
!ambiance
Celebrate recent channel roles across activity, karma, quotes and factoids.
Access: public. IRC surfaces: channel.
!awards [7d|30d]
Default 7d; only 7d or 30d, with no additional argument. Combines activity, karma, quotes and factoids.
Alias of features; the same options, defaults and checks apply.
Access: public. IRC surfaces: channel.
!capabilities
Alias of features; the same options, defaults and checks apply.
Access: public. IRC surfaces: channel.
!caps
Show channel line/statistics information.
Access: Administrator+. IRC surfaces: channel + private message.
!chanstatlines #channel
Alias of dashboard; the same options, defaults and checks apply.
Access: public. IRC surfaces: channel.
!chanstats
Alias of chronos; the same options, defaults and checks apply.
Access: public. IRC surfaces: channel.
!chrono [short|brief|full]
Show a compact or full narrative timeline of the current channel.
Access: public. IRC surfaces: channel.
!chronos [short|brief|full]
Default full; brief aliases short. The narrative is derived from channel history and durable community data.
Compare message counts between two nicks on the channel.
Access: public. IRC surfaces: channel.
!compare <nick1> <nick2> [<N>d|<N>w|<N>m|<N>y|all]
Periods use days/weeks/months/years; here m is months, not minutes. Omitted period is the handler’s all-time comparison.
Show channel statistics.
Access: Administrator+. IRC surfaces: channel + private message.
!cstat #channel
Show a compact dashboard for the current channel.
Access: public. IRC surfaces: channel.
!dashboard
No command parameters. Channel-scoped results refer to the invocation channel.
Show active channel capabilities and important chansets.
Access: public. IRC surfaces: channel.
!features
No command parameters. Channel-scoped results refer to the invocation channel.
Show hourly activity chart as ASCII bars.
Access: public. IRC surfaces: channel.
!heatmap [nick]
Show the last message posted by a nick on this channel.
Access: public. IRC surfaces: channel.
!last <nick> [1..5]
Default 1 line; bounded to 1–5 recent messages from this channel.
Alias of leaderboard; the same options, defaults and checks apply.
Access: Administrator+. IRC surfaces: channel.
!lb [msgs|karma|trivia|duels|achievs] [<N>h|<N>d|<N>w] [full|long|compact|short]
Show channel rankings, optionally limited to recent msgs/karma. Administrator+.
Access: Administrator+. IRC surfaces: channel.
!leaderboard [msgs|karma|trivia|duels|achievs] [<N>h|<N>d|<N>w] [full|long|compact|short]
Options can be combined in any order. Default is compact all-time sections. Positive periods are capped at one year: 8760h, 365d, or 52w. Period filtering applies to messages/karma; all-time-only sections are not relabelled as windowed data. full/long requests expanded output.
Take a bounded random trip into this channel's history (older than 30 days).
Access: public. IRC surfaces: channel.
!memory
Requires the current channel and +OnThisDay; recalls a historical item at least 30 days old. No arguments.
Show channel milestones: total messages, next round milestone, progress and ETA. Alias: milestones
Access: public. IRC surfaces: channel.
!milestone
No command parameters. Channel-scoped results refer to the invocation channel.
Alias of milestone; the same options, defaults and checks apply.
Access: public. IRC surfaces: channel.
!milestones
Show activity count per month for the last 12 months.
Access: public. IRC surfaces: channel.
!monthstats [nick]
!monthstats <nick1> vs <nick2>
Shows the last twelve months, optionally comparing two nicks; default single target is caller.
Read the channel mood: sentiment, energy, who's driving it, and today's peak hour.
Access: public. IRC surfaces: channel.
!mood
No command parameters. Channel-scoped results refer to the invocation channel.
Alias of observatory; the same options, defaults and checks apply.
Access: public. IRC surfaces: channel.
!obs
Show a compact live channel and bot status view.
Access: public. IRC surfaces: channel.
!observatory
No command parameters. Channel-scoped results refer to the invocation channel.
Resurface what happened on this channel on a calendar day (today, or a given MM-DD) in past years. Alias: otd
Access: public. IRC surfaces: channel.
!onthisday [MM-DD|MM/DD|MM.DD]
Default is today; date is month then day, with calendar validation. Requires +OnThisDay. otd takes the same date parameter.
Alias of onthisday; the same options, defaults and checks apply.
Access: public. IRC surfaces: channel.
!otd [MM-DD|MM/DD|MM.DD]
Show a compact channel profile for a nick.
Access: public. IRC surfaces: channel.
!profil [nick]
Alias of profil; the same options, defaults and checks apply.
Access: public. IRC surfaces: channel.
!profile [nick]
Show current or historical channel activity radar.
Access: public. IRC surfaces: channel.
!radar [Nd]
No argument reads the live activity radar. A <N>d historical window is clamped to 1–30 days.
Show when a nick was last seen.
Access: public. IRC surfaces: channel.
!seen <nick|wildcard> [#channel]
Optional channel is after the nick. Wildcard example: !seen teu*; exact nick resolution and channel-scoped lookup remain distinct. It is not a public cross-network search service.
Show channel/user statistics.
Access: public. IRC surfaces: channel.
!stats [nick]
Show consecutive days of activity on the channel.
Access: public. IRC surfaces: channel.
!streak [nick]
Alias of chronos; the same options, defaults and checks apply.
Access: public. IRC surfaces: channel.
!timeline [short|brief|full]
Show top channel activity statistics.
Access: public. IRC surfaces: channel.
!top [1..10] [bots|nobots] [today|yesterday|week|<N>d|<N>h]
Order is count, optional bot filter, then period. Default count 5, clamped 1–10; omitted period is all history. bots selects bots; nobots excludes them. This is not Administrator-only leaderboard.
Show top talkers.
Access: Administrator+. IRC surfaces: channel + private message.
!topsay [#channel] <nick>
Reads one nick’s channel activity through the legacy reporting path; target is required. In PM specify channel.
Show when a nick first appeared on the channel.
Access: public. IRC surfaces: channel.
!when <nick>
Locate a nick or channel when known.
Access: public. IRC surfaces: channel.
!whereis <nick>
Show channel talk statistics.
Access: Administrator+. IRC surfaces: channel + private message.
!whotalk #channel
Alias of whotalk; the same options, defaults and checks apply.
Access: Administrator+. IRC surfaces: channel + private message.
!whotalks #channel
Count distinct words spoken by a nick on the channel.
Access: public. IRC surfaces: channel.
!wordcount [nick]
Revisit a channel year: activity, peaks, top voices, quotes and factoids. Defaults to the last completed year.
Access: public. IRC surfaces: channel.
!yearbook [YYYY]
Default last completed year; accepted year 2000 through current year. Requires +OnThisDay.
Mediabot v3 documentation · Home · Installation · Commands · Troubleshooting · GitHub
- Start: notation and parameters
- Public commands
- Complete command reference
- Private and admin commands
- News and RSS
- Quotes and automatic quotes
- Dynamic commands
- AI and Hailo
- Access levels
- Chansets