Command level index

Command level index

This page groups Mediabot commands by practical access level.

The exact runtime authorization still depends on configuration, hostmask/authentication, channel policy and instance rollout decisions. A command listed as public can still depend on a channel feature flag, an API key, or an optional service.

The example prefix is !.

---

Public / regular users

Most users can try these directly in a channel, subject to feature flags and instance policy.

Command	Syntax	What it does
8ball	8ball <question>	Ask the Magic 8-ball a yes/no question.
abbrev	abbrev <text>	Generate an acronym from the initials of each word.
access	access [#channel]	Show your access level on a channel.
achievements	`achievements [nick	list
achievs	`achievs [nick	list
active	active [period]	List nicks active in the last N hours or days (e.g. 24h, 7d).
affinity	affinity <nick1> [nick2]	Alias for compat.
ai	ai <prompt>	Ask Claude. Subcommands: summary [periode] [N] [Nl] [public] [nick] (details: ai summary help), pin, relay, forget, models, stats, reset, history, ai persona.
ambiance	ambiance	Alias for mood.
auth	auth	Check or refresh your authentication status.
birthdate	birthdate [nick]	Display a stored user birthdate.
birthday	birthday [nick]	Display birthday information.
calc	calc <expression>	Evaluate a safe calculator expression.
calclast	calclast [1-3]	Show your most recent !calc results (session memory).
capabilities	capabilities	Alias for features.
caps	caps	Alias for features.
chaninfo	chaninfo #channel	Show information about a bot channel.
chanlist	chanlist	List channels known by the bot.
channellist	channellist	Alias for chanlist.
channels	channels	Alias for chanlist.
chanstatlines	chanstatlines #channel	Show channel line/statistics information.
chanstats	chanstats	Alias for dashboard.
choose	`choose	`
chrono	`chrono [short	full]`
chronos	`chronos [short	full]`
colors	colors	Display IRC color information.
commands	commands	Alias for help commands.
compare	compare <nick1> <nick2>	Compare message counts between two nicks on the channel.
compat	compat <nick1> [nick2]	Compare IRC affinity between two nicks. Gated by +Games.
convert	convert <value> <from> <to>	Convert units: length, mass, temperature, volume, speed, data (e.g. convert 100 km mi).
cstat	cstat #channel	Show channel statistics.
dashboard	dashboard	Show a compact dashboard for the current channel.
date	`date [timezone	user]`
define	define <word>	Look up a word definition from Wiktionary.
duel	duel <nick>	Challenge a present nick to a d20 duel. Gated by chanset +Games.
f	f <player>	Display Fortnite stats when configured.
factoid	factoid <keyword>	Show details of a fact: author, dates, recall count.
factoids	factoids [pattern|top]	List channel facts (glob pattern), or 'top' for the most recalled.
features	features	Show active channel capabilities and important chansets.
flip	flip	Flip a coin (heads or tails).
forget	forget <keyword>	Delete a channel fact (author or channel op only).
greet	greet [text]	Show or set a greeting.
halloffame	halloffame [n]	Alias for topquote.
heatmap	heatmap [nick]	Show hourly activity chart as ASCII bars.
help	`help [#channel	command
horo	horo [nick]	Alias for horoscope.
horoscope	horoscope [nick]	Show a deterministic daily IRC horoscope. Public use is gated by +Games.
karma	karma [+/-/++/--] [nick]	Show karma or vote: !karma + / !karma - . Requires nick on channel.
karmadiff	karmadiff [nick]	Show karma delta for nick in the last 24h.
karmahist	karmahist [nick]	Show the last 5 karma changes on the channel (optionally filtered by nick).
karmainfo	karmainfo <nick>	Detailed karma stats: received, given, top voter.
karmatop	karmatop [n]	Show the top N karma scores (default 5). Use 'karmatop bottom [n]' for lowest scores.
karmawatch	karmawatch [nick]	Watch a nick's karma. Get notified on any vote (max 5 watches). Toggle on/off.
karmgraph	karmgraph [nick]	ASCII sparkline of karma changes over the last 7 days.
last	last <nick>	Show the last message posted by a nick on this channel.
lastcom	lastcom [nick]	Show recent command usage.
lb	`lb [msgs	karma
leaderboard	`leaderboard [msgs	karma
learn	learn <keyword> = <value>	Store a shared channel fact. Recall with whatis.
leet	leet <text>	Convert text to leetspeak.
listeners	listeners	Show Icecast listener counts.
meteo	meteo [city]	Alias for weather.
milestone	milestone	Show channel milestones: total messages, next round milestone, progress and ETA. Alias: milestones
milestones	milestones	Alias for milestone.
monthstats	monthstats [nick]	Show activity count per month for the last 12 months.
mood	mood	Read the channel mood: sentiment, energy, who's driving it, and today's peak hour.
morse	morse <text>	Encode text in Morse code.
mp3	mp3 <query>	Search or display MP3/radio related information.
nextsong	nextsong	Display next-song information when a scheduler is wired.
nicklist	nicklist #channel	List nicks currently known on a channel.
note	note <msg>	Save a note (max 200 chars, max 10). !notes to list/del/search/export.
notes	notes [del <n>]	List or delete personal notes.
obs	obs	Alias for observatory.
observatory	observatory	Show a compact live channel and bot status view.
onthisday	onthisday [MM-DD]	Resurface what happened on this channel on a calendar day (today, or a given MM-DD) in past years. Alias: otd
otd	otd	Alias for onthisday.
play	play <query>	Queue a cached/downloaded radio track via Liquidsoap. Master-only during rollout.
poll	`poll [secs] [weighted]	opt1[:N]
pollextend	pollextend <secs>	Extend the current poll timer by N seconds (10-600).
pollresult	pollresult	Show current or last poll results.
pollstatus	``	Show the current poll status without closing it.
profil	profil [nick]	Show a compact channel profile for a nick.
profile	profile [nick]	Alias for profil.
q	`q [nick	search]`
qg	`qg [stop	top]`
quote	`quote [nick]	quote add
quotecount	quotecount [nick]	Count quotes by author on the channel.
quotegame	`quotegame [stop	top]`
radar	radar [Nd]	Show current or historical channel activity radar.
radiocache	radiocache	Show MP3 cache database/file consistency summary. Master-only.
radiocacheprune	radiocacheprune [confirm]	Dry-run or delete MP3 cache rows whose files are missing. Master-only.
radiocheck	radiocheck	Check local radio cache, yt-dlp, cookies, Liquidsoap, and Icecast configuration. Master-only.
radiodlcancel	radiodlcancel	Cancel the current non-blocking yt-dlp download. Master-only.
radiodlstatus	radiodlstatus	Show current non-blocking yt-dlp download status. Master-only.
radioflush	radioflush	Flush the Liquidsoap queue and skip. Master-only.
radioimport	radioimport <absolute-mp3-path> [artist - title]	Index a local MP3 file into the radio cache. Master-only.
radioimportdir	radioimportdir [directory]	Index all readable MP3 files from a local directory into the radio cache. Master-only.
radiomounts	radiomounts	List Icecast mounts.
radiopush	radiopush <absolute-mp3-path>	Push a local MP3 file into the Liquidsoap Mediabot queue. Master-only.
radioqueue	radioqueue	Show the Liquidsoap Mediabot request queue. Master-only.
radioskip	radioskip	Skip the current Liquidsoap queue item. Master-only.
radiostatus	radiostatus	Show Icecast status.
recap	recap [30m|2h] [ai]	Summarize what you missed on this channel (stats, or AI summary with 'ai').
remind	remind [!] <nick> <msg>	Set a reminder/tell. Subcommands: list, cancel |all, show.
remindlist	``	List your pending reminders with remaining time and urgent flag.
remindsnooze	remindsnooze <id> <delay>	Snooze a reminder by 30m, 2h, 1d etc.
resolve	`resolve <host	ip>`
rnick	rnick #channel	Pick a random nick from a channel.
roll	roll [NdN]	Roll dice. Defaults to 1d6. Supports NdN format (e.g. 2d6, 1d20).
searchcmd	searchcmd <keyword> [limit]	Search dynamic PUBLIC_COMMANDS entries.
seen	seen <nick>	Show when a nick was last seen.
showcmd	showcmd <command>	Display a dynamic PUBLIC_COMMANDS command.
showcommands	showcommands [#channel]	List commands available for your level on a channel.
slap	slap [nick]	Slap a nick with a random object via CTCP ACTION.
song	song	Show the current Icecast song or stream title.
spike	spike	Show Spike memorial image.
stats	stats [nick]	Show channel/user statistics.
streak	streak [nick]	Show consecutive days of activity on the channel.
tell	tell <nick> <msg>	Leave a message for a nick, delivered when they next join or speak here.
tellme	tellme <prompt>	Ask the configured ChatGPT/OpenAI integration.
timeline	`timeline [short	full]`
tmdb	tmdb <movie or show>	Search TMDB when configured.
top	top [limit]	Show top channel activity statistics.
topquote	topquote [n]	Channel hall of fame: the most-recalled quotes (default 5, max 10). Alias: halloffame
topsay	topsay [#channel]	Show top talkers.
trivia	trivia [cat] [start N]	Trivia. 'categories' to list. Named cats: science, history, music, film, tv...
triviascore	triviascore	Show trivia scores for the current channel session.
triviatop	triviatop [n]	Show top trivia scores from DB (hall of fame, max 15).
unvote	unvote	Cancel your vote in the current poll.
uptime	uptime	Show bot uptime.
verify	verify	Verify your authentication or account state.
version	version	Show bot version.
vote	vote <n>	Vote in the current poll. Shows live tally after each vote (U3).
weather	weather [city]	Display weather information.
whatis	whatis <keyword>	Recall a shared channel fact stored with learn. Shortcut: ?keyword
when	when <nick>	Show when a nick first appeared on the channel.
whereis	whereis <nick>	Locate a nick or channel when known.
whoami	whoami	Show who the bot thinks you are.
whotalk	whotalk #channel	Show channel talk statistics.
whotalks	whotalks #channel	Alias for whotalk.
wordcount	wordcount [nick]	Count distinct words spoken by a nick on the channel.
xlogin	xlogin <account>	Authenticate or check X login integration when configured.
yomomma	yomomma	Return a yomomma joke.
yt	yt <query>	Search YouTube when configured.

Channel operators

Command	Syntax	What it does
act	act #channel <text>	Send an IRC action to a channel through the bot.
ban	`ban #channel <mask	nick> [duration]`
bans	bans #channel	List known bans for a channel.
deop	deop #channel [nick]	Remove operator status on a channel.
devoice	devoice #channel [nick]	Remove voice status on a channel.
invite	invite #channel <nick>	Invite a nick to a channel.
kb	kb #channel <nick> [reason]	Alias for kickban.
kick	kick #channel <nick> [reason]	Kick a user from a channel.
kickban	kickban #channel <nick> [reason]	Kick and ban a user from a channel.
op	op #channel [nick]	Give operator status on a channel.
unban	`unban #channel <mask	id>`
voice	voice #channel [nick]	Give voice on a channel.

Channel admins

Command	Syntax	What it does
add	add #channel <nick> <level>	Add or update a user access level on a channel.
addbadword	addbadword #channel <word>	Add a badword filter entry for a channel.
antifloodset	antifloodset #channel <key> <value>	Adjust anti-flood settings for a channel.
chanset	chanset #channel <setting> <value>	Change a channel setting.
del	del #channel <nick>	Remove a user from channel access.
rembadword	rembadword #channel <word>	Remove a badword filter entry.
tmdblangset	tmdblangset #channel <lang>	Set TMDB language for a channel.

Dynamic command maintainers

Command	Syntax	What it does
addcatcmd	addcatcmd <category>	Create a PUBLIC_COMMANDS category.
addcmd	addcmd <category> <command> <action>	Create a dynamic command stored in PUBLIC_COMMANDS.
chcatcmd	chcatcmd <command> <category>	Move a dynamic command to another category.
chowncmd	chowncmd <command> <nick>	Change the owner of a dynamic PUBLIC_COMMANDS command.
countcmd	countcmd	Count dynamic PUBLIC_COMMANDS entries.
holdcmd	`holdcmd [on	off]`
lastcmd	lastcmd [limit]	Show recently used dynamic commands.
modcmd	modcmd <command> <new action>	Modify a dynamic PUBLIC_COMMANDS command.
mvcmd	mvcmd <old> <new>	Rename a dynamic PUBLIC_COMMANDS command.
owncmd	owncmd [nick]	List dynamic commands owned by a user.
popcmd	popcmd	Show popular dynamic commands.
remcmd	remcmd <command>	Remove a dynamic PUBLIC_COMMANDS command.
topcmd	topcmd	Show most used dynamic commands.

Private authentication commands

Use these in private with the bot. Do not paste passwords in a public channel.

Command	Syntax	What it does
ident	ident <login> <password>	Legacy/private authentication helper.
login	login <user> <password>	Authenticate with the bot.
logout	logout	Logout from the bot.
pass	`pass	pass `
register	register <owner> <password>	Register the first owner account.

Private or admin command

Command	Syntax	What it does
topic	topic #channel <topic>	Change the topic of a channel.

Bot admins

Command	Syntax	What it does
addchan	addchan #channel	Add a channel to the bot configuration.
addhost	addhost <nick> <hostmask>	Add a hostmask to a known user.
addresponder	addresponder <trigger> <response>	Add an automatic responder.
addtimer	addtimer <name> <seconds> <command>	Add a bot timer.
adduser	adduser <handle> [-n] <hostmask> [level]	Create a bot user.
checkhost	checkhost <hostmask>	Search users matching a hostmask.
checkhostchan	checkhostchan #channel <hostmask>	Search channel users matching a hostmask.
checknick	checknick <nick>	Search known hostmasks for a nick.
delresponder	delresponder <trigger>	Remove an automatic responder.
deluser	deluser <nick>	Delete a bot user.
echo	echo <text>	Echo text for debugging.
hailo_chatter	`hailo_chatter [on	off]`
hailo_ignore	hailo_ignore <nick>	Ignore a nick for Hailo learning or replies.
hailo_status	hailo_status	Show Hailo status.
hailo_unignore	hailo_unignore <nick>	Remove a nick from the Hailo ignore list.
ignore	`ignore <nick	mask>`
ignores	ignores	List ignore entries.
join	join #channel	Make the bot join a channel.
modinfo	modinfo <nick>	Show moderation information about a user.
moduser	moduser <nick> <field> <value>	Modify a bot user.
msg	`msg <nick	#channel> `
nick	nick <newnick>	Change the bot nickname.
part	part #channel [reason]	Make the bot leave a channel.
purge	purge #channel	Purge or reset channel runtime information.
qlog	qlog #channel <query>	Search channel logs.
remtimer	remtimer <name>	Remove a bot timer.
say	say #channel <text>	Send a channel message through the bot.
status	status	Show bot runtime status.
timers	timers	List bot timers.
unignore	`unignore <nick	mask>`
useradd	useradd <handle> [-n] <hostmask> [level]	Legacy alias for adduser.
userinfo	userinfo <nick>	Show information about a user.
users	users	List or count known users.

Masters

Command	Syntax	What it does
debug	debug <level>	Change or display debug verbosity.
die	die [reason]	Ask the bot to quit.
dump	dump	Dump internal debug information.
exec	exec <command>	Execute a shell command. Dangerous and admin-only.
karmareset	karmareset <nick>	Reset a nick's karma to 0 on this channel.
pollstop	pollstop	Close the active poll.
pollvoters	pollvoters	Show who voted for what in the current poll.
rehash	rehash	Reload bot configuration.
triviareset	triviareset <nick>	Reset a nick's trivia score in DB.
triviastop	triviastop	Stop the active trivia game on this channel.
update	update	Disabled IRC update command. Use the deploy script manually.

Owners

Command	Syntax	What it does
alias	alias <alias> <command>	Create or manage IRC command aliases (alias list, alias del ).
openai	openai help	Show and change safe OpenAI/tellme runtime settings.

---

Important feature flags

Chanset	Effect
+Games	Allows duel, horoscope, compat, quotegame.
+Factoids	Allows shared channel facts.
+DidYouMean	Enables mistyped-command suggestions.
+OnThisDay	Allows on-this-day channel history.
+UrlTitle	Enables automatic URL details.
+Youtube / +YoutubeSearch	Enables YouTube URL/search behavior.
+RandomQuote	Enables random quote behavior where used.
+Claude	Enables configured Claude/AI features.
+AchievementAnnounce	Enables public achievement unlock announcements.
+NoColors	Reduces/strips colored output where supported.
+AntiFlood	Enables anti-flood checks.

---

Compatibility note

top is the historical Mediabot top command.

leaderboard / lb are the newer social leaderboard commands.

They are intentionally separate.