Repository navigation
Commands tools
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.
abbrev · calc · calclast · colors · commands · convert · date · define · f · help · leet · meteo · morse · note · notes · qlog · remind · remindlist · remindsnooze · resolve · spike · tell · tmdb · uptime · version · weather · yomomma
Generate an acronym from the initials of each word.
Access: public. IRC surfaces: channel.
!abbrev <text>
Evaluate a safe calculator expression.
Access: public. IRC surfaces: channel.
!calc <expression>
Expression max 128 characters, parsed through the safe calculator; examples 2+2, sqrt(16). It is not Perl or shell evaluation. calclast reads up to three caller session results.
Show your most recent !calc results (session memory).
Access: public. IRC surfaces: channel.
!calclast [1-3]
Display IRC color information.
Access: public. IRC surfaces: channel.
!colors <text...>
Applies/display IRC color variants to required text; there is no argument-free color reference in this handler.
Alias for help commands.
Access: public. IRC surfaces: channel + private message.
!commands
Registered channel/PM discovery name routed to the help handler. Bare invocation shows its default command discovery view. Use channel help commands [category] for category selection; help itself is not PM-registered.
Convert units: length, mass, temperature, volume, speed, data (e.g. convert 100 km mi).
Access: public. IRC surfaces: channel.
!convert <value> <from> [to|in] <to>
Input max 64 joined characters. Units must share a supported family (length, mass, temperature, volume, speed, data). Examples 100 km mi, 100 c f. Optional English to/in separators are ignored by the parser.
Display the current date/time for a timezone or user.
Access: public. IRC surfaces: channel.
!date [timezone|handle|fr|moscow|la|dk|me|list]
!date user add <handle> <timezone>
!date user del <handle>
No argument uses America/New_York, not the caller’s timezone. Aliases: fr→Europe/Paris, moscow→Europe/Moscow, la→America/Los_Angeles, dk→Europe/Copenhagen. Known handle reads its stored timezone. me is a playful reply; list prints the legacy timezone link. user add/del requires Administrator+; delete an existing timezone before replacing it.
Look up a word definition from Wiktionary.
Access: public. IRC surfaces: channel.
!define <word>
Display Fortnite stats when configured.
Access: public. IRC surfaces: channel.
!f <player>
Show command lists, search internal help, or documentation pointers.
Access: public. IRC surfaces: channel.
!help
!help <command>
!help <#channel>
!help commands [category]
!help docs
!help search <term...>
!help level <public|private|admin|owner|master|authorized|operator>
Lists built-ins and instance-specific commands. Documentation aliases: wiki/doc/docs/documentation. Built-in catalogue aliases: internal/internals/commands. Search aliases: search/find/grep. Role query aliases: level/role; matches substrings in legacy help labels, so use admin rather than administrator. Themed shortcuts: social/memory/profile/profiles; game/games/playful; chanset/chansets/settings/flags; logs/tools for statistics. help <category> lists a category when it does not collide with a command; help stats shows the command, help commands stats selects the category. Search is literal text in internal help. Discovery does not grant authorization. The commands name invokes the same handler on its registered channel/PM surfaces.
Convert text to leetspeak.
Access: public. IRC surfaces: channel.
!leet <text>
Alias for weather.
Access: public. IRC surfaces: channel.
!meteo [city]
Encode text in Morse code.
Access: public. IRC surfaces: channel.
!morse <text>
Save a note (max 200 chars, max 10). !notes to list/del/search/export.
Access: public. IRC surfaces: channel.
!note <text...>
!note search <text...>
!note export
Personal in-memory notes: max ten, 200 characters each. Search and export are subcommands of note, not notes. Replies are private. Restart durability is not implied.
List or delete personal notes.
Access: public. IRC surfaces: channel.
!notes
!notes del [number]
Lists personal session notes; del uses one-based numbering, default 1. Search/export belong to note.
Search channel logs.
Access: Administrator+. IRC surfaces: channel.
!qlog [-n <nick>] [#channel] <word1> [word2 ...]
Optional -n filter precedes optional channel, then required search words. PM requires target channel. This searches channel logs, not the quote store.
Set reminder. Subcommands: list, cancel /all, show.
Access: public. IRC surfaces: channel.
!remind [!] <nick> <message...>
!remind [!] <nick> <in|dans> <duration> <message...>
!remind [!] <nick> tomorrow <message...>
!remind [!] <nick> at HH:MM <message...>
!remind [!] daily HH:MM <nick> <message...>
!remind [!] weekly <day> HH:MM <nick> <message...>
!remind list
!remind show
!remind cancel <id|all>
Ordinary reminders are delivered when the target returns/speaks; explicit time creates a scheduled reminder. Delay formats parsed after in/dans: Nh, NhNm, Nm, Nd, Nw. Weekly day tokens are mon tue wed thu fri sat sun; clock is 00:00–23:59 in the bot’s scheduling timezone. Leading ! marks urgent. Max ten pending reminders per caller/channel and 512 message characters. list reads your pending entries; show reads channel pending entries; cancellation is caller-owned. Plain tell <nick> <message> uses the same handler; choose the canonical remind forms for scheduling. No catch-all “free-form date” parser is promised.
List your pending reminders with remaining time and urgent flag.
Access: public. IRC surfaces: channel.
!remindlist
Lists the caller’s pending reminders; alias for the list view, with no parameters.
Snooze a reminder by 30m, 2h, 1d etc.
Access: public. IRC surfaces: channel.
!remindsnooze <id> <delay>
Targets a pending reminder ID owned by the caller. Delay combines positive d/h/m/s components, e.g. 1h30m; total must be greater than zero. Reschedules the entry; it does not create another reminder.
Resolve a hostname or IP address.
Access: public. IRC surfaces: channel.
!resolve <host|ip>
Show Spike memorial image.
Access: public. IRC surfaces: channel.
!spike
No command parameters. Channel-scoped results refer to the invocation channel.
Leave a message for a nick, delivered when they next join or speak here.
Access: public. IRC surfaces: channel.
!tell <nick> <msg>
Leaves a message for a nick on the current channel through the reminder handler. The documented everyday form is tell <nick> <message>; time and recurrence forms are explained under remind.
Search TMDB when configured.
Access: public. IRC surfaces: channel.
!tmdb <movie or show>
Show bot uptime.
Access: public. IRC surfaces: channel.
!uptime
No command parameters. Channel-scoped results refer to the invocation channel.
Show bot version.
Access: public. IRC surfaces: channel.
!version
No command parameters. Channel-scoped results refer to the invocation channel.
Display weather information.
Access: public. IRC surfaces: channel.
!weather [city...]
!weather compare <city1> <city2>
Requires +Weather. Normal city may contain words; the comparison dispatch consumes two city tokens, so use single-token city names for that form. meteo maps to ordinary weather and does not dispatch compare.
Return a yomomma joke.
Access: public. IRC surfaces: channel.
!yomomma
No command parameters. Channel-scoped results refer to the invocation channel.
Complete index · Command notation
Units are case-insensitive. Volume names use the US measures in the converter; data is bytes (decimal kb versus binary kib). Source and destination must be in the same family.
| Canonical unit | Accepted spellings |
|---|---|
mm |
mm, millimeter, millimetre, millimeters, millimetres
|
cm |
cm, centimeter, centimetre, centimeters, centimetres
|
m |
m, meter, metre, meters, metres
|
km |
km, kilometer, kilometre, kilometers, kilometres
|
in |
in, inch, inches, "
|
ft |
ft, foot, feet, '
|
yd |
yd, yard, yards
|
mi |
mi, mile, miles
|
nmi |
nmi, nauticalmile, nauticalmiles
|
mg |
mg, milligram, milligrams
|
g |
g, gram, grams, gramme, grammes
|
kg |
kg, kilogram, kilograms, kilo, kilos
|
t |
t, tonne, tonnes, metricton
|
oz |
oz, ounce, ounces
|
lb |
lb, lbs, pound, pounds
|
st |
st, stone, stones
|
c |
c, celsius, centigrade, °c
|
f |
f, fahrenheit, °f
|
k |
k, kelvin
|
ml |
ml, milliliter, millilitre, milliliters, millilitres
|
l |
l, liter, litre, liters, litres
|
gal |
gal, gallon, gallons
|
qt |
qt, quart, quarts
|
pt |
pt, pint, pints
|
cup |
cup, cups
|
floz |
floz, fluidounce, fluidounces
|
kmh |
kmh, km/h, kph
|
mph |
mph, mi/h
|
ms |
ms, m/s
|
kn |
kn, knot, knots
|
b |
b, byte, bytes
|
kb |
kb, kilobyte, kilobytes
|
mb |
mb, megabyte, megabytes
|
gb |
gb, gigabyte, gigabytes
|
tb |
tb, terabyte, terabytes
|
kib |
kib |
mib |
mib |
gib |
gib |
tib |
tib |
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