Using Mediabot

Using Mediabot as a regular IRC user

This page is the beginner-friendly guide to Mediabot v3.

You do not need to be a bot administrator to use most of the commands on this page. In many channels you do not even need to be registered with the bot: you can ask for help, look up stats, play small games, save personal notes, use factoids, vote in polls, check quotes, paste URLs, and read channel history.

The exact command prefix depends on the instance. In examples below, the prefix is shown as !.

If your bot is configured with another prefix, replace ! with that prefix.

!help
!help convert
!help factoids

Some instances also accept the short form without the prefix when talking directly to the bot in private. In a channel, use the configured prefix unless your local network says otherwise.

---

First five commands to try

!help
!help commands
!help search quote
!help convert
!help level public

What these do:

• !help opens the main help screen.
• !help commands lists command categories.
• !help search quote searches help text.
• !help convert shows detailed help for a command.
• !help level public lists commands available to regular users.

---

Reading command syntax

Mediabot help uses a few common conventions.

Notation	Meaning	Example
<nick>	required value	!seen Teuk
[nick]	optional value	!stats or !stats Teuk
<a> | <b>	choose one form	!vote 1 or another option number
NdN	dice format	!roll 2d6
MM-DD	month/day date	!onthisday 12-25

The bot usually answers in the channel for social commands, and by private NOTICE for long output such as help, feature lists, dashboards, and history summaries.

---

If a command is silent

Silence usually means one of these things:

1. The command is disabled on this channel.
2. The feature needs an API key or optional service.
3. The command is private/admin-only.
4. The bot is rate-limiting output to avoid flooding.
5. The command needs channel history, quotes, or data that does not exist yet.

Useful checks:

!features
!help <command>
!help chansets
!whoami
!access

---

Common user workflows

Find out what is happening in the channel

!mood
!dashboard
!leaderboard 7d
!milestone
!onthisday

Good for active channels with history. !mood gives recent energy and who is driving the conversation. !milestone shows the total public messages logged and the next round milestone.

Look up a person

!seen SomeNick
!profile SomeNick
!stats SomeNick
!karma SomeNick

!seen shows the last known activity and now cleans formatting/control characters from the last message. On active channels it may also show a [N msg in last 24h] activity hint.

Leave a message for someone

!tell SomeNick Please check the logs when you get back

The message is delivered when the nick joins or speaks on the channel. !tell is an alias for the reminder/tell behavior.

Save a shared fact for the channel

!learn coffee = black gold of the morning
!whatis coffee
?coffee
!factoid coffee
!factoids top

?coffee is the fast recall shortcut. If a factoid is unknown, the shortcut stays silent so normal conversation is not spammed.

Convert units

!convert 100 km mi
!convert 100 c f
!convert 1 kg in lb
!convert 1 gb mib

The converter is offline and supports length, mass, temperature, volume, speed, and data units.

Use quotes

!quote
!quote SomeNick
!quote add this will be remembered
!topquote
!halloffame

!topquote ranks the most recalled quotes. It needs the QUOTES.hits migration on upgraded databases, but it has a safe fallback before migration.

Make a poll

!poll 60 Lunch? | pizza | sushi | salad
!vote 2
!pollstatus
!pollresult

Some admin/master commands can close or inspect polls, but regular users can usually vote.

Play lightweight games

!roll 2d6
!flip
!8ball will this deploy work?
!duel SomeNick
!quotegame

duel, horoscope, compat, and quotegame depend on the +Games channel setting.

Paste a URL

If +UrlTitle is enabled, just paste a link. The bot can show badges and details for many services.

Examples of supported behavior in current development builds:

[AppleMusic] Abbey Road (2019 Mix) - by The Beatles - album - 1969 - 17 tracks
[X] jack (@jack) on X: "just setting up my twttr"
[Facebook] public title - short description
[Instagram] public title
[Spotify] title - by artist - album - year - duration

The exact output depends on what the remote site exposes publicly.

---

Commands that need channel settings

Some commands are public but gated by channel feature flags.

Feature flag	Affects
+Games	duel, horoscope, compat, quotegame
+Factoids	learn, whatis, forget, factoids, factoid, ?keyword
+DidYouMean	suggestions for mistyped commands
+OnThisDay	onthisday, otd, daily digest if configured
+UrlTitle	automatic URL details
+Youtube / +YoutubeSearch	YouTube URL/search helpers
+Claude	Claude/AI behavior when configured
+AchievementAnnounce	public achievement announcements

Regular users can inspect many of these with:

!features
!help chansets

Changing channel settings usually requires channel admin rights.

---

When you need to be logged in

Most public commands do not require bot login.

You may need to authenticate for:

• private/admin commands;
• changing passwords;
• adding users or channels;
• changing channel settings;
• managing dynamic commands;
• operator or master commands.

Useful identity commands:

!whoami
!auth
!access
/msg bot login <user> <password>

Never paste passwords in a public channel.

---

More detailed pages

• Public commands
• Social features and community analytics
• Private and admin commands
• Command level index
• Radio integration
• Configuration