Command level index

Command level index

Generated from the current Mediabot source tree.

• Project version: 3.2dev-20260523_014607
• Generated: 2026-05-24 05:26:25
• Source: Mediabot/Mediabot.pm internal help table

Use this page to understand which commands are available at each documented level.

Radio integration note

The radio integration added or updated several commands after the original command documentation generation date.

Important radio-related commands include:

listeners
song
radiostatus
radiomounts
radiocheck
radiocache
radiocacheprune
radiodlstatus
radiodlcancel
radioimport
radioimportdir
radioqueue
radiopush
radioskip
radioflush
play

Most radio administration commands are Master-only during rollout. m play is also kept Master-only for now, even if it appears in user-facing help, because it can start download/cache operations when enabled.

See:

• Radio integration

public

Recent command updates — 2026-06

The generated table below may lag behind the current development tree. Recent command syntax additions include:

active [today|yesterday|week|month|now|Nd|Nh]
ai models
ai summary [today|yesterday|week|last|Nd|Nh] [nick]
karmadiff [nick|all] [Nd|Nh]
karmahist [nick]        # uses KARMA_LOG when available, memory fallback otherwise
last <nick> [n]         # n = 1-5
trivia leaderboard [n]
trivia myscore [nick]
trivia reset [nick]
trivia [category] [easy|medium|hard]
wordcount [nick] [today|yesterday|week|Nd|Nh|all]

wordcount all may be slow on large channels. The bounded modes are preferred for routine use.

Command	Syntax	Level	Description
8ball	8ball <question>	public	Ask the Magic 8-ball a yes/no question.
abbrev	abbrev <text>	public	Generate an acronym from the initials of each word.
access	access [#channel]	public	Show your access level on a channel.
active	active [today|yesterday|week|month|now|Nd|Nh]	public	List active nicks for named calendar periods or rolling windows. now also reports present-but-silent nicks.
ai	ai <prompt> ; ai models ; ai summary [period] [nick]	public	Ask Claude. Includes dynamic model listing, history, quota, pin/persona tools, and channel-log summaries.
auth	auth	public	Check or refresh your authentication status.
birthdate	birthdate [nick]	public	Display a stored user birthdate.
birthday	birthday [nick]	public	Display birthday information.
calc	calc <expression>	public	Evaluate a safe calculator expression.
calclast	calclast	public	Show your last !calc results (session memory).
chaninfo	chaninfo #channel	public	Show information about a bot channel.
chanlist	chanlist	public	List channels known by the bot.
channellist	channellist	public	Alias for chanlist.
channels	channels	public	Alias for chanlist.
chanstatlines	chanstatlines #channel	public	Show channel line/statistics information.
choose	choose <a>|<b>	public	Random pick. Weight opt:N. Deduplicates (empty result → error).
colors	colors	public	Display IRC color information.
compare	compare <nick1> <nick2>	public	Compare message counts between two nicks on the channel.
cstat	cstat #channel	public	Show channel statistics.
date	date [timezone|user]	public	Display the current date/time for a timezone or user.
define	define <word>	public	Look up a word definition from Wiktionary.
f	f <player>	public	Display Fortnite stats when configured.
flip	flip	public	Flip a coin (heads or tails).
greet	greet [text]	public	Show or set a greeting.
heatmap	heatmap [nick]	public	Show hourly activity chart as ASCII bars.
help	help [#channel|command|docs|search <term>|level <level>]	public	Show command lists, search internal help, or documentation pointers.
karma	karma [nick] | karma + <nick> | karma - <nick>	public	Show karma/rank or explicitly vote +1/-1 for a nick present on the channel. Automatic nick++/nick-- scanning is disabled to avoid false positives such as Notepad++. Subcommands: top, bottom, log, diff, graph [nick] (sparkline 7d).
karmadiff	karmadiff [nick|all] [Nd|Nh]	public	Show karma delta for one nick, or top movers with all, over a configurable period.
karmahist	karmahist [nick]	public	Show recent karma changes from KARMA_LOG when available, with memory fallback.
karmainfo	karmainfo <nick>	public	Detailed karma stats: received, given, top voter.
karmatop	karmatop [n]	public	Show the top N karma scores (default 5). Use 'karmatop bottom [n]' for lowest scores.
karmawatch	karmawatch [nick]	public	Watch a nick's karma. Get notified on any vote (max 5 watches). Toggle on/off.
karmgraph	karmgraph [nick]	public	ASCII sparkline of karma changes over the last 7 days.
last	last <nick> [n]	public	Show the last message(s) from a nick on this channel, up to 5.
lastcom	lastcom [nick]	public	Show recent command usage.
leet	leet <text>	public	Convert text to leetspeak.
listeners	listeners	public	Show Icecast listener counts.
meteo	meteo [city]	public	Alias for weather.
monthstats	monthstats [nick]	public	Show activity count per month for the last 12 months.
morse	morse <text>	public	Encode text in Morse code.
mp3	mp3 <query>	public	Search or display MP3/radio related information.
nextsong	nextsong	public	Display next-song information when a scheduler is wired.
nicklist	nicklist #channel	public	List nicks currently known on a channel.
note	note <msg>	public	Save a note (max 200 chars, max 10). !notes to list/del/search/export.
notes	notes [del <n>]	public	List or delete personal notes.
poll	poll [secs] [weighted] <q>|opt1[:N]|opt2	public	Start a poll. 'weighted' enables weighted options (opt:N).
pollextend	pollextend <secs>	public	Extend the current poll timer by N seconds (10-600).
pollresult	pollresult	public	Show current or last poll results.
pollstatus	pollstatus	public	Show the current poll status without closing it.
q	q [nick|search]	public	Display a quote.
quote	quote [nick]|quote add <text>|quote count [nick]	public	Quote alias: fetch by nick, add a quote, or count quotes.
quotecount	quotecount [nick]	public	Count quotes by author on the channel.
remind	remind [!] <nick> <msg>	public	Set reminder. Subcommands: list, cancel |all, show.
remindlist	remindlist	public	List your pending reminders with remaining time and urgent flag.
remindsnooze	remindsnooze <id> <delay>	public	Snooze a reminder by 30m, 2h, 1d etc.
resolve	resolve <host|ip>	public	Resolve a hostname or IP address.
rnick	rnick #channel	public	Pick a random nick from a channel.
roll	roll [NdN]	public	Roll dice. Defaults to 1d6. Supports NdN format (e.g. 2d6, 1d20).
searchcmd	searchcmd <keyword> [limit]	public	Search dynamic PUBLIC_COMMANDS entries.
seen	seen <nick>	public	Show when a nick was last seen.
showcmd	showcmd <command>	public	Display a dynamic PUBLIC_COMMANDS command.
showcommands	showcommands [#channel]	public	List commands available for your level on a channel.
slap	slap [nick]	public	Slap a nick with a random object via CTCP ACTION.
song	song	public	Show the current Icecast song or stream title.
spike	spike	public	Show Spike memorial image.
stats	stats [nick]	public	Show channel/user statistics.
streak	streak [nick]	public	Show consecutive days of activity on the channel.
tellme	tellme <prompt>	public	Ask the configured ChatGPT/OpenAI integration.
tmdb	tmdb <movie or show>	public	Search TMDB when configured.
top	top [limit]	public	Show top channel activity statistics.
topsay	topsay [#channel]	public	Show top talkers.
trivia	trivia [category] [easy|medium|hard] ; trivia leaderboard [n] ; trivia myscore [nick] ; trivia reset [nick]	public	Trivia game with difficulty tags, leaderboard, personal score, and reset helpers.
triviascore	triviascore	public	Show trivia scores for the current channel session.
triviatop	triviatop [n]	public	Show top trivia scores from DB (hall of fame, max 15).
unvote	unvote	public	Cancel your vote in the current poll.
uptime	uptime	public	Show bot uptime.
verify	verify	public	Verify your authentication or account state.
version	version	public	Show bot version.
vote	vote <n>	public	Vote in the current poll. Shows live tally after each vote (U3).
weather	weather [city]	public	Display weather information.
when	when <nick>	public	Show when a nick first appeared on the channel.
whereis	whereis <nick>	public	Locate a nick or channel when known.
whoami	whoami	public	Show who the bot thinks you are.
whotalk	whotalk #channel	public	Show channel talk statistics.
whotalks	whotalks #channel	public	Alias for whotalk.
wordcount	wordcount [nick] [today|yesterday|week|Nd|Nh|all]	public	Count distinct words for a nick with optional period; all bypasses the 50k safety limit.
xlogin	xlogin <account>	public	Authenticate or check X login integration when configured.
yomomma	yomomma	public	Return a yomomma joke.
yt	yt <query>	public	Search YouTube when configured.

operator+

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

channel admin

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

admin

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

master

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

owner

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

authorized

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

private

Command	Syntax	Level	Description
ident	ident <login> <password>	private	Legacy/private authentication helper.
login	login <user> <password>	private	Authenticate with the bot.
logout	logout	private	Logout from the bot.
pass	pass <newpass>|pass <oldpass> <newpass>	private	Set first password, or change existing password with old password verification.
radiomounts	radiomounts	private	List Icecast mounts.
radiostatus	radiostatus	private	Show Icecast status.
register	register <owner> <password>	private	Register the first owner account.

private/admin

Command	Syntax	Level	Description
topic	topic #channel <topic>	private/admin	Change the topic of a channel.