Repository navigation
Command reference
Teuk edited this page Oct 6, 2026
·
2 revisions
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.
Coverage: 249 names/aliases; 242 channel and 97 PM registrations. Each name appears exactly once below. The parameter links include subcommands, defaults, ranges and side effects beyond the short built-in help.
Identity, accounts and access · Channels and moderation · Bot operation, messages and timers · Dynamic commands and responders · Quotes and automatic quotes · News, RSS, VDM and DansTonChat · AI and Hailo · Statistics, profiles and channel history · Games, votes, karma and factoids · Radio and media · Help, reminders and everyday tools
| Command | Main syntax | Access | IRC surfaces | Parameters |
|---|---|---|---|---|
access |
!access [#channel] <handle|=nick> |
public | channel/PM | Details |
addhost |
!addhost <handle> <hostmask> |
Master+ | channel/PM | Details |
adduser |
!adduser <handle> [-n] <hostmask> [Owner|Master|Administrator|User] |
Master+ | channel/PM | Details |
auth |
!auth <nick> |
Administrator+ | channel/PM | Details |
birthdate |
!birthdate |
public | channel/PM | Details |
birthday |
!birthday <handle> |
public | channel | Details |
checkhost |
!checkhost <hostmask> |
admin | channel/PM | Details |
checkhostchan |
!checkhostchan [#channel] <hostname> |
admin | channel/PM | Details |
checknick |
!checknick <nick> |
Master+ | channel/PM | Details |
deluser |
!deluser <handle> |
Master+ | channel/PM | Details |
greet |
!greet [#channel] [nick] |
public | channel/PM | Details |
ident |
/msg BotNick ident <login> <password> |
private | PM | Details |
login |
/msg BotNick login <user> <password> |
private | PM | Details |
logout |
/msg BotNick logout |
private | PM | Details |
modinfo |
!modinfo [#channel] automode <handle> <OP|VOICE|NONE> |
Authenticated; Administrator+ or command-specific channel level | channel/PM | Details |
moduser |
!moduser <handle> level <Owner|Master|Administrator|User> [force] |
Administrator+ | channel/PM | Details |
pass |
/msg BotNick pass <newpass> |
private | PM | Details |
register |
/msg BotNick register <owner> <password> |
private | PM | Details |
useradd |
!useradd <handle> [-n] <hostmask> [Owner|Master|Administrator|User] |
Master+ | channel/PM | Details |
userinfo |
!userinfo <handle> |
Administrator+ | channel/PM | Details |
users |
!users |
Master+ | channel/PM | Details |
verify |
!verify <nick> |
Administrator+ | channel/PM | Details |
whoami |
!whoami |
public | channel/PM | Details |
xlogin |
!xlogin <account> |
public | channel | Details |
| Command | Main syntax | Access | IRC surfaces | Parameters |
|---|---|---|---|---|
add |
!add #channel <nick> <level> |
Authenticated Administrator+ or channel 400+ | channel/PM | Details |
addbadword |
!addbadword #channel <word> |
Master+ | channel | Details |
addchan |
!addchan <#channel> <handle> |
Administrator+ | channel/PM | Details |
antifloodset |
!antifloodset [#channel] |
Master+ | channel/PM | Details |
ban |
!ban [#channel] <nick|mask> [duration] [level] [reason] |
Authenticated Administrator+ or channel 75+ | channel | Details |
bans |
!bans [#channel] |
Authenticated Administrator+ or channel 75+ | channel | Details |
chaninfo |
!chaninfo #channel |
public | channel/PM | Details |
chanlist |
!chanlist |
Master+ | channel/PM | Details |
channellist |
!channellist |
Master+ | channel/PM | Details |
channels |
!channels |
Master+ | channel/PM | Details |
chanset |
!chanset [#channel] <+Capability|-Capability> |
Authenticated Administrator+ or channel 450+ | channel/PM | Details |
del |
!del #channel <nick> |
Authenticated Administrator+ or channel 400+ | channel/PM | Details |
deop |
!deop [#channel] [nick] |
Authenticated Administrator+ or channel 100+ | channel/PM | Details |
devoice |
!devoice [#channel] [nick] |
Authenticated Administrator+ or channel 25+ | channel/PM | Details |
ignore |
!ignore [#channel] <hostmask> |
Administrator+ | channel/PM | Details |
ignores |
!ignores |
admin | channel/PM | Details |
invite |
!invite [#channel] [nick] |
Authenticated Administrator+ or channel 100+ | channel/PM | Details |
join |
!join #channel |
Authenticated Administrator+ or channel 450+ | channel/PM | Details |
kb |
!kb [#channel] <nick|mask> [duration] [level] [reason] |
Authenticated Administrator+ or channel 75+ | channel | Details |
kick |
!kick [#channel] <nick> [reason] |
Authenticated Administrator+ or channel 50+ | channel/PM | Details |
kickban |
!kickban [#channel] <nick|mask> [duration] [level] [reason] |
Authenticated Administrator+ or channel 75+ | channel | Details |
nicklist |
!nicklist #channel |
Administrator+ | channel/PM | Details |
op |
!op [#channel] [nick] |
Authenticated Administrator+ or channel 100+ | channel/PM | Details |
part |
!part #channel [reason] |
Authenticated Administrator+ or channel 500+ | channel/PM | Details |
purge |
!purge #channel |
Administrator+ | channel/PM | Details |
rembadword |
!rembadword #channel <word> |
Master+ | channel | Details |
rnick |
!rnick #channel |
Administrator+ | channel/PM | Details |
tmdblangset |
!tmdblangset [#channel] <language> |
channel admin | channel | Details |
topic |
/msg BotNick topic #channel <topic> |
Authenticated Administrator+ or channel 50+ | PM | Details |
unban |
!unban [#channel] <id|mask> |
Authenticated Administrator+ or channel 75+; ban-level check | channel | Details |
unignore |
!unignore [#channel] <hostmask> |
Administrator+ | channel/PM | Details |
voice |
!voice [#channel] [nick] |
Authenticated Administrator+ or channel 25+ | channel/PM | Details |
| Command | Main syntax | Access | IRC surfaces | Parameters |
|---|---|---|---|---|
act |
!act #channel <text> |
Administrator+ | channel/PM | Details |
addtimer |
!addtimer <name> <seconds> <raw IRC command> |
Owner | channel/PM | Details |
alias |
!alias <alias> <command> |
Owner | channel | Details |
debug |
!debug [0..5] |
Owner | channel/PM | Details |
die |
!die [reason] |
Master+ | channel/PM | Details |
dump |
/msg BotNick dump <raw IRC command> |
Owner | PM | Details |
echo |
!echo <text> |
Public (legacy help says admin) | channel/PM | Details |
exec |
!exec <command> |
Owner | channel | Details |
lastcom |
!lastcom [count] |
Master+ | channel/PM | Details |
msg |
!msg <nick|#channel> <text> |
Administrator+ | channel/PM | Details |
nick |
!nick <newnick> |
Owner | channel/PM | Details |
rehash |
!rehash |
Master+ | channel/PM | Details |
remtimer |
!remtimer <name> |
Owner | channel/PM | Details |
say |
!say #channel <text> |
Administrator+ | channel/PM | Details |
status |
!status |
Master+ | channel/PM | Details |
timers |
!timers |
Owner | channel/PM | Details |
update |
!update [check|status|now] |
Master+ | channel/PM | Details |
| Command | Main syntax | Access | IRC surfaces | Parameters |
|---|---|---|---|---|
addcatcmd |
!addcatcmd <category> |
Administrator+ | channel/PM | Details |
addcmd |
!addcmd <command> <message|action> <category> <text> |
Administrator+ | channel/PM | Details |
addresponder |
!addresponder [#channel] <chance> <trigger> | <answer> |
Master+ | channel | Details |
chcatcmd |
!chcatcmd <new_category> <command> |
Administrator+ | channel/PM | Details |
chowncmd |
!chowncmd <command> <username> |
Master+ | channel/PM | Details |
cmdvars |
!cmdvars |
public | channel/PM | Details |
countcmd |
!countcmd |
Public read (legacy help says authorized) | channel/PM | Details |
delresponder |
!delresponder [#channel] <trigger...> |
Master+ | channel | Details |
holdcmd |
!holdcmd <command> [on|off|toggle] |
Administrator+ | channel/PM | Details |
lastcmd |
!lastcmd |
Public read (legacy help says authorized) | channel/PM | Details |
modcmd |
!modcmd <command> <message|action> <category> <text> |
Administrator+ and owner of command, or Master+ | channel/PM | Details |
mvcmd |
!mvcmd <old> <new> |
Master+ | channel/PM | Details |
owncmd |
!owncmd |
Public read (legacy help says authorized) | channel/PM | Details |
popcmd |
!popcmd <handle> |
Public read (legacy help says authorized) | channel/PM | Details |
remcmd |
!remcmd <command> |
Administrator+ and owner of command, or Master+ | channel/PM | Details |
searchcmd |
!searchcmd <text...> [limit] |
public | channel/PM | Details |
showcmd |
!showcmd <command> |
public | channel/PM | Details |
showcommands |
!showcommands [#channel] |
public | channel/PM | Details |
testcmd |
!testcmd <command> [arguments] |
Administrator+ | channel/PM | Details |
topcmd |
!topcmd |
Public read (legacy help says authorized) | channel/PM | Details |
| Command | Main syntax | Access | IRC surfaces | Parameters |
|---|---|---|---|---|
halloffame |
!halloffame [n] |
public | channel | Details |
q |
!q help |
Public reads/add; authenticated deletion with ownership/channel checks | channel | Details |
quote |
!quote <nick> |
public | channel | Details |
quotecount |
!quotecount [nick] |
public | channel | Details |
randomquote |
!randomquote [#channel] |
Authenticated Administrator+ or target channel 450+ | channel/PM | Details |
topquote |
!topquote [n] |
public | channel | Details |
| Command | Main syntax | Access | IRC surfaces | Parameters |
|---|---|---|---|---|
actu |
!actu [topic...] [en|fr|es] |
public | channel | Details |
actualite |
!actualite [topic...] [en|fr|es] |
public | channel | Details |
actualites |
!actualites [topic...] [en|fr|es] |
public | channel | Details |
bashfr |
!bashfr |
public | channel | Details |
dtc |
!dtc |
public | channel | Details |
news |
!news [topic...] [en|fr|es] |
public | channel | Details |
rss |
!rss [help|syntax] |
List/info public; fetch previews User+; changes and limit status Administrator+ or channel 400+ | channel | Details |
vdm |
!vdm [id] |
public | channel | Details |
| Command | Main syntax | Access | IRC surfaces | Parameters |
|---|---|---|---|---|
ai |
!ai <prompt...> |
Master+ | channel/PM | Details |
chatgpt |
!chatgpt <prompt> |
public | channel | Details |
claude |
!claude <prompt...> |
Master+ | channel/PM | Details |
gemini |
!gemini <prompt> |
public | channel | Details |
hailo |
!hailo help |
Master+; savebrain Owner | channel | Details |
hailo_chatter |
!hailo_chatter [#channel] [0..100] |
Master+ | channel | Details |
hailo_ignore |
!hailo_ignore <nick> |
Master+ | channel | Details |
hailo_status |
!hailo_status [#channel] |
Master+ | channel | Details |
hailo_unignore |
!hailo_unignore <nick> |
Master+ | channel | Details |
openai |
!openai [status|config|help|defaults|profiles] |
Owner | channel | Details |
recap |
!recap [<N>m|<N>h] [ai] [en|fr|es|lang=fr] |
public | channel | Details |
tellme |
!tellme <prompt> |
public | channel | Details |
| Command | Main syntax | Access | IRC surfaces | Parameters |
|---|---|---|---|---|
achievements |
!achievements [nick|list|all|top|progress [nick]] |
public | channel | Details |
achievs |
!achievs [nick|list|all|top|progress [nick]] |
public | channel | Details |
active |
!active [today|yesterday|week|month|now|<N>d|<N>h] |
public | channel | Details |
ambiance |
!ambiance |
public | channel | Details |
awards |
!awards [7d|30d] |
public | channel | Details |
capabilities |
!capabilities |
public | channel | Details |
caps |
!caps |
public | channel | Details |
chanstatlines |
!chanstatlines #channel |
Administrator+ | channel/PM | Details |
chanstats |
!chanstats |
public | channel | Details |
chrono |
!chrono [short|brief|full] |
public | channel | Details |
chronos |
!chronos [short|brief|full] |
public | channel | Details |
compare |
!compare <nick1> <nick2> [<N>d|<N>w|<N>m|<N>y|all] |
public | channel | Details |
cstat |
!cstat #channel |
Administrator+ | channel/PM | Details |
dashboard |
!dashboard |
public | channel | Details |
features |
!features |
public | channel | Details |
heatmap |
!heatmap [nick] |
public | channel | Details |
last |
!last <nick> [1..5] |
public | channel | Details |
lb |
!lb [msgs|karma|trivia|duels|achievs] [<N>h|<N>d|<N>w] [full|long|compact|short] |
Administrator+ | channel | Details |
leaderboard |
!leaderboard [msgs|karma|trivia|duels|achievs] [<N>h|<N>d|<N>w] [full|long|compact|short] |
Administrator+ | channel | Details |
memory |
!memory |
public | channel | Details |
milestone |
!milestone |
public | channel | Details |
milestones |
!milestones |
public | channel | Details |
monthstats |
!monthstats [nick] |
public | channel | Details |
mood |
!mood |
public | channel | Details |
obs |
!obs |
public | channel | Details |
observatory |
!observatory |
public | channel | Details |
onthisday |
!onthisday [MM-DD|MM/DD|MM.DD] |
public | channel | Details |
otd |
!otd [MM-DD|MM/DD|MM.DD] |
public | channel | Details |
profil |
!profil [nick] |
public | channel | Details |
profile |
!profile [nick] |
public | channel | Details |
radar |
!radar [Nd] |
public | channel | Details |
seen |
!seen <nick|wildcard> [#channel] |
public | channel | Details |
stats |
!stats [nick] |
public | channel | Details |
streak |
!streak [nick] |
public | channel | Details |
timeline |
!timeline [short|brief|full] |
public | channel | Details |
top |
!top [1..10] [bots|nobots] [today|yesterday|week|<N>d|<N>h] |
public | channel | Details |
topsay |
!topsay [#channel] <nick> |
Administrator+ | channel/PM | Details |
when |
!when <nick> |
public | channel | Details |
whereis |
!whereis <nick> |
public | channel | Details |
whotalk |
!whotalk #channel |
Administrator+ | channel/PM | Details |
whotalks |
!whotalks #channel |
Administrator+ | channel/PM | Details |
wordcount |
!wordcount [nick] |
public | channel | Details |
yearbook |
!yearbook [YYYY] |
public | channel | Details |
| Command | Main syntax | Access | IRC surfaces | Parameters |
|---|---|---|---|---|
8ball |
!8ball <question> |
public | channel | Details |
affinity |
!affinity <nick1> [nick2] |
public | channel | Details |
choose |
!choose <option[:weight]> | <option[:weight]> [| ...] |
public | channel | Details |
compat |
!compat <nick1> [nick2] |
public | channel | Details |
duel |
!duel <nick> |
public | channel | Details |
factoid |
!factoid <keyword> |
public | channel | Details |
factoids |
!factoids [pattern|top] |
public | channel | Details |
flip |
!flip |
public | channel | Details |
forget |
!forget <keyword> |
public | channel | Details |
horo |
!horo [nick|signe] |
public | channel | Details |
horoscope |
!horoscope [nick|signe] |
public | channel | Details |
karma |
!karma [nick] |
public | channel | Details |
karmadiff |
!karmadiff [nick] |
public | channel | Details |
karmahist |
!karmahist [nick] |
public | channel | Details |
karmainfo |
!karmainfo <nick> |
public | channel | Details |
karmareset |
!karmareset <nick> |
Master+ | channel | Details |
karmatop |
!karmatop [bottom] [1..10] |
public | channel | Details |
karmawatch |
!karmawatch [nick] |
public | channel | Details |
karmgraph |
!karmgraph [nick] |
public | channel | Details |
learn |
!learn <keyword> = <value> |
public | channel | Details |
poll |
!poll [weighted] [10..3600] <question> | <option[:weight]> | <option[:weight]> [| ...] |
Master+ | channel | Details |
pollextend |
!pollextend <secs> |
public | channel | Details |
pollresult |
!pollresult |
public | channel | Details |
pollstatus |
!pollstatus |
public | channel | Details |
pollstop |
!pollstop |
Master+ | channel | Details |
pollvoters |
!pollvoters |
Master+ | channel | Details |
qg |
!qg [stop|top] |
public | channel | Details |
quotegame |
!quotegame [stop|top] |
public | channel | Details |
roll |
!roll [<N>d<S>|<sides>] [<signed modifier>] [adv|advantage|dis|disadvantage] |
public | channel | Details |
slap |
!slap [nick] |
public | channel | Details |
trivia |
!trivia [category] [easy|medium|hard] |
Public play/read; reset privileged | channel | Details |
triviareset |
!triviareset <nick> |
Master+ | channel | Details |
triviascore |
!triviascore |
public | channel | Details |
triviastop |
!triviastop |
Master+ | channel | Details |
triviatop |
!triviatop [n] |
public | channel | Details |
unvote |
!unvote |
public | channel | Details |
vote |
!vote <n> |
public | channel | Details |
whatis |
!whatis <keyword> |
public | channel | Details |
| Command | Main syntax | Access | IRC surfaces | Parameters |
|---|---|---|---|---|
deltrack |
!deltrack <id_mp3> |
Master+ on +Radio | channel | Details |
listeners |
!listeners |
public | channel | Details |
mp3 |
!mp3 <query> |
public | channel | Details |
nextsong |
!nextsong |
Administrator+ on +Radio | channel | Details |
play |
!play <artist title or YouTube URL> |
Public on +Radio; Master+ local/PM control | channel/PM | Details |
queue |
!queue |
Public on +Radio; Master+ local control | channel | Details |
radiocache |
!radiocache |
Master+ | channel | Details |
radiocacheprune |
!radiocacheprune [confirm] |
Master+ | channel | Details |
radiocheck |
!radiocheck |
Master+ | channel | Details |
radiodlcancel |
!radiodlcancel |
Master+ | channel | Details |
radiodlstatus |
!radiodlstatus |
Master+ | channel | Details |
radioflush |
!radioflush |
Master+ | channel/PM | Details |
radioimport |
!radioimport <absolute-mp3-path> [artist - title] |
Master+ | channel/PM | Details |
radioimportdir |
!radioimportdir [directory] |
Master+ | channel | Details |
radiomounts |
!radiomounts |
Master+ | channel/PM | Details |
radiopush |
!radiopush <absolute-mp3-path> |
Master+ | channel/PM | Details |
radioqueue |
!radioqueue |
Public on +Radio; Master+ local/PM control | channel/PM | Details |
radioskip |
!radioskip |
Master+ | channel/PM | Details |
radiostatus |
!radiostatus |
Master+ | channel/PM | Details |
rplay |
!rplay <artist or title> |
Public on +Radio | channel | Details |
song |
!song |
public | channel/PM | Details |
yt |
!yt <query...> |
public | channel | Details |
| Command | Main syntax | Access | IRC surfaces | Parameters |
|---|---|---|---|---|
abbrev |
!abbrev <text> |
public | channel | Details |
calc |
!calc <expression> |
public | channel | Details |
calclast |
!calclast [1-3] |
public | channel | Details |
colors |
!colors <text...> |
public | channel | Details |
commands |
!commands |
public | channel/PM | Details |
convert |
!convert <value> <from> [to|in] <to> |
public | channel | Details |
date |
!date [timezone|handle|fr|moscow|la|dk|me|list] |
public | channel | Details |
define |
!define <word> |
public | channel | Details |
f |
!f <player> |
public | channel | Details |
help |
!help |
public | channel | Details |
leet |
!leet <text> |
public | channel | Details |
meteo |
!meteo [city] |
public | channel | Details |
morse |
!morse <text> |
public | channel | Details |
note |
!note <text...> |
public | channel | Details |
notes |
!notes |
public | channel | Details |
qlog |
!qlog [-n <nick>] [#channel] <word1> [word2 ...] |
Administrator+ | channel | Details |
remind |
!remind [!] <nick> <message...> |
public | channel | Details |
remindlist |
!remindlist |
public | channel | Details |
remindsnooze |
!remindsnooze <id> <delay> |
public | channel | Details |
resolve |
!resolve <host|ip> |
public | channel | Details |
spike |
!spike |
public | channel | Details |
tell |
!tell <nick> <msg> |
public | channel | Details |
tmdb |
!tmdb <movie or show> |
public | channel | Details |
uptime |
!uptime |
public | channel | Details |
version |
!version |
public | channel | Details |
weather |
!weather [city...] |
public | channel | Details |
yomomma |
!yomomma |
public | channel | Details |
Partyline dot-commands, dynamic templates, plugins and script bridge and channel capabilities have their own references. They are not counted as additional built-in IRC names.
Continue with the task navigation and the complete name index above; detailed forms are organized by family.
Continue with the task navigation and the complete name index above; detailed forms are organized by family.
Continue with the task navigation and the complete name index above; detailed forms are organized by family.
Continue with the task navigation and the complete name index above; detailed forms are organized by family.
Continue with the task navigation and the complete name index above; detailed forms are organized by family.
Continue with the task navigation and the complete name index above; detailed forms are organized by family.
Continue with the task navigation and the complete name index above; detailed forms are organized by family.
Continue with the task navigation and the complete name index above; detailed forms are organized by family.
Continue with the task navigation and the complete name index above; detailed forms are organized by family.
Continue with the task navigation and the complete name index above; detailed forms are organized by family.
Continue with the task navigation and the complete name index above; detailed forms are organized by family.
Continue with the task navigation and the complete name index above; detailed forms are organized by family.
Continue with the task navigation and the complete name index above; detailed forms are organized by family.
Continue with the task navigation and the complete name index above; detailed forms are organized by family.
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