Command level index

Mediabot command level index

This page is generated from the internal help table in Mediabot/Mediabot.pm in the May 2026 development snapshot.

It is intended as a wiki-ready index of every built-in command documented by Mediabot itself, grouped by required user level.

Dynamic commands stored in PUBLIC_COMMANDS are not listed here because they are database content, not built-in source commands.

public

No privileged account is normally required. Some commands may still depend on channel settings or optional API keys.

Command	Syntax	Level	Description
access	access [#channel]	public	Show your access level on a channel.
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.
chaninfo	chaninfo #channel	public	Show information about a bot channel.
chanlist	chanlist	public	List channels known by the bot.
channels	channels	public	Alias for chanlist.
channellist	channellist	public	Alias for chanlist.
chanstatlines	chanstatlines #channel	public	Show channel line/statistics information.
colors	colors	public	Display IRC color information.
cstat	cstat #channel	public	Show channel statistics.
date	`date [timezone	user]`	public
f	f <player>	public	Display Fortnite stats when configured.
greet	greet [text]	public	Show or set a greeting.
help	`help [#channel	command	docs
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.
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.
q	`q [nick	search]`	public
resolve	`resolve <host	ip>`	public
rnick	rnick #channel	public	Pick a random nick from a channel.
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.
song	song	public	Show the current Icecast song or stream title.
tellme	tellme <prompt>	public	Ask the configured ChatGPT/OpenAI integration.
tmdb	tmdb <movie or show>	public	Search TMDB when configured.
topsay	topsay [#channel]	public	Show top talkers.
uptime	uptime	public	Show bot uptime.
verify	verify	public	Verify your authentication or account state.
version	version	public	Show bot version.
weather	weather [city]	public	Display weather information.
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.
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.
8ball	8ball <question>	public	Ask the Magic 8-ball a yes/no question.
choose	`choose	`	public
flip	flip	public	Flip a coin (heads or tails).
morse	morse <text>	public	Encode text in Morse code.
roll	roll [NdN]	public	Roll dice. Defaults to 1d6. Supports NdN format (e.g. 2d6, 1d20).
slap	slap [nick]	public	Slap a nick with a random object via CTCP ACTION.
abbrev	abbrev <text>	public	Generate an acronym from the initials of each word.
active	active [period]	public	List nicks active in the last N hours or days (e.g. 24h, 7d).
calclast	calclast	public	Show your last !calc results (session memory).
calc	calc <expression>	public	Evaluate a safe calculator expression.
stats	stats [nick]	public	Show channel/user statistics.
top	top [limit]	public	Show top channel activity statistics.
compare	compare <nick1> <nick2>	public	Compare message counts between two nicks on the channel.
heatmap	heatmap [nick]	public	Show hourly activity chart as ASCII bars.
monthstats	monthstats [nick]	public	Show activity count per month for the last 12 months.
streak	streak [nick]	public	Show consecutive days of activity on the channel.
when	when <nick>	public	Show when a nick first appeared on the channel.
wordcount	wordcount [nick]	public	Count distinct words spoken by a nick on the channel.
karma	karma [nick]	public	Show karma. Subcommands: karma top [n], karma log [nick]. 30s cooldown per target.
karmatop	karmatop [n]	public	Show the top N karma scores (default 5). Use 'karmatop bottom [n]' for lowest scores.
karmahist	karmahist [nick]	public	Show the last 5 karma changes on the channel (optionally filtered by nick).
remind	remind <nick> <msg>	public	Set a reminder. Delay: 'dans 2h', 'in 30m', 'tomorrow'. Subcommands: list, cancel , show.
remindlist	remindlist	public	List your pending reminders on this channel.
quotecount	quotecount [nick]	public	Count quotes by author on the channel.
note	note <message>	public	Save a personal note (max 10, in-memory).
notes	notes [del <n>]	public	List or delete personal notes.
poll	`poll [secs]	opt1	opt2`
pollresult	pollresult	public	Show current or last poll results.
vote	vote <n>	public	Vote in the current poll. Shows live tally after each vote (U3).
trivia	trivia [start N]	public	Start a trivia question. Use 'trivia start N' for a multi-round game (N up to 20).
triviascore	triviascore	public	Show trivia scores for the current channel session.
define	define <word>	public	Look up a word definition from Wiktionary.
ai	ai <prompt>	public	Ask Claude. Subcommands: reset, history, quota, persona, model, stats, forget, clear all (Owner).
last	last <nick>	public	Show the last message posted by a nick on this channel.

private

Designed for private-message usage, usually related to login/password/account handling.

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	pass `	private
radiomounts	radiomounts	private	List Icecast mounts.
radiostatus	radiostatus	private	Show Icecast status.
register	register <owner> <password>	private	Register the first owner account.

authorized

Requires an authenticated/authorized user, often for database-backed command management.

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 [on	off]`	authorized
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.

operator+

Requires operator-level channel access or equivalent privileged user level.

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+
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+
voice	voice #channel [nick]	operator+	Give voice on a channel.

channel admin

Requires channel-admin rights for the target channel.

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

Requires bot admin rights.

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
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
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> `	admin
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
userinfo	userinfo <nick>	admin	Show information about a user.
users	users	admin	List or count known users.

master

Requires Master-level access. Treat as sensitive.

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.
rehash	rehash	master	Reload bot configuration.
update	update	master	Disabled IRC update command. Use the deploy script manually.
karmareset	karmareset <nick>	master	Reset a nick's karma to 0 on this channel.
pollstop	pollstop	master	Close the active poll.

owner

Requires Owner-level access. Treat as highly sensitive.

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

private/admin

Private/admin operational command.

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