mIRC Commands

The following commands are mostly unique to mIRC, though some are only modifications or extensions of standard IRC commands.

Note: To view the full list of commands see the Search dialog.

/ajinvite [on | off]

Turns auto-join on invite on or off.

/alias [filename] <aliasname> <command>

Adds, removes, replaces aliases; it is limited to single line aliases and will not affect multiple line definitions.

/alias /moo /me moos!

This will replace the first matching alias with the new command. To remove an existing aliases:

/alias /moo

To add an alias to a specific alias file, you would use:

/alias moo.txt /moo /me moos!

If you don't specify a filename, it defaults to using the first filename in which the alias exists, or if it doesn't exist then it uses the first loaded aliases file.

/amsg <message>

This and the /ame command send the specified message or action to all open channel windows.

/anick <nickname>

Changes your alternate nickname.

/autojoin [-nsdN]

Can be used in the on CONNECT event or Perform section to delay or prevent autojoining of channels

Where -n = join now, -s = skip autojoin, -dN = delay autojoin for N seconds.

Note: This also affects the rejoining of open channel windows during a reconnect.

/background [-aemsgdluhcfnrtpx] [window] [filename]

Changes the background picture setting for a window. This can also be changed via a windows System Menu.

-a = active window

-m = main mIRC window

-s = status window

-g = finger window

-d = single message window

-e = set as default

-cfnrtp = center, fill, normal, stretch, tile, photo

-l = toolbar

-u = toolbar buttons

-h = switchbar

You can right-click in the toolbar/switchbar to pop up a menu for changing these settings. Toolbar buttons can use RGB Color 255,0,255 for transparency, the BMP must be of the same form as that in mIRC resources. It should be a 16 or 256 color BMP.

-x = no background picture

Note: The window name should only be specified if none of the window switches are specified. The filename does not need to be specified if you are only changing the display method.

/ban [-kruN] [#channel] <nickname|address> [type]

Bans someone from the current channel using their address. To do this, it first does a /userhost on the user, which gives it the user's address, and then it does a /mode # +b <user address>.

If you specify the -k switch, mIRC performs a ban/kick combination on the nickname.

If you specify the -uN switch, mIRC pauses N seconds before removing the ban.

If you specify the -r switch, /ban removes the ban of the specified type for that nickname, eg. /ban -r nick 2

If you do not specify a ban type, then mIRC uses the whole nick!*user@host to do the ban. If you are banning an IP address then a wild card replaces the last number of the IP address. If you are on the channel then the #channel specification is not necessary.

If you specify a wildcard address it is used as-is, if you specify a full address then the type mask is applied to it.

For a list of ban types see the $mask identifier.

Note: This command uses the IAL maintained by mIRC.

/beep <number> <delay>

Beeps a number of times with a delay.

/channel [#channel]

Pops up the channel central window for the channel window you're currently in. You can also specify a #channel name to open the channel central for a channel you've already joined but which isn't the active window.

/clear [-sghlc] [windowname]

Clears the buffer of the current window. If you specify a window name, that window's buffer will be cleared.

The -s switch clears the status window.

The -g switch clears the finger window.

The -l switch clears the side-listbox in a custom window.

The -c switch clears the click history in a picture window.

The -h switch clears the editbox command history for a window.

/clearall [-snqmtgu]

Clears the buffers of the specified windows, where s = status, n = channel, q = query, m = message window, t = chat, g = finger, u = custom.

If no switches are specified all windows are cleared.

/clipboard [-an] <text>

Copies the specified text to the clipboard. The -a switch makes it append the text to any existing text in the clipboard. The -n switch appends a $crlf to the text.

/close [-icfgms@] [nick1] ... [nickN]

Closes all windows of the specified type and the specified nicknames. If no nicknames are given, all windows of the specified type are closed. The type of window is denoted by c for chat, f for fserve, g for get, i for inactive dcc windows, m for message (query), s for send, and @ for custom windows.

You can specify the Nth window for -cfgs by appending a number, eg. /close -s4 nick, would close the 4th open dcc send to nick.

You can also use a wildcard as the window name and all matching windows will be closed.

/color [-lrs] <name> <index>

Allows you to change the color settings for items in the Colors dialog.

The -l switch reloads the color settings from the mirc.ini file.

The -r switch resets the Nth color in the 16 color palette to its default RGB value, with /color -r <N>. To change the color of the Nth color in the 16 color palette to a new value, you can use /color <index> <rgb>

To change the color of a text item in the color dialog, you can specify the name of the item, eg. Normal text, along with a new palette index.

The -s switch changes the active scheme, with /color -s <scheme name>

/copy -ao <filename> <filename>

Copies a file to another filename or directory. You can also use wildcards for the source filename, and a directory name for the destination. The -o switch overwrites a file if it exists. The -a switch appends the first file to the second one.

/creq [+m|-m] [ask | auto | ignore]

This is the command line equivalent of setting the DCC Chat request radio buttons in the dcc options dialog (see /sreq below). The +m|-m switch turns the minimize setting on|off.

/ctcpreply <nick> <ctcp> [message]

Sends a reply to a ctcp query.

/ctcpreply goat HELP no help available.

/debug [-cinpt] [N] [on | off | @window | filename] [identifier]

Outputs raw server messages, both incoming and outgoing, to a debug.log file, or a custom @window.

/debug -n @moo, opens a custom @window minimized

/debug -c off, turns off debugging and closes the associated custom @window

/debug -pt, wraps or timestamps messages

/debug N @moo, uses color N for messages

The -i switch calls the specified identifier before a debug line is logged. The return value of the identifier is used as the debug line.

The $debug identifier returns the name of debug file or @window.

Note: /debug works independently for each server connection.

/describe <nick|channel> <message>

Sends an action to the specified nickname or channel, the same as the /me command, except that /me is used while in a query or channel window so you don't need to specify the target when using it.

/disconnect

Forces a disconnect from a server. This is different from the /quit command which sends a quit message to the server and waits for the server to disconnect you.

/dll <name.dll> <procname> [data]

This allows you to call routines in a DLL designed to work with mIRC.

/dns [-ch] [nick|address]

Resolves an address. If mIRC sees a "." in the name you specify it assumes it's an address and tries to resolve it. Otherwise it assumes it's a nickname and performs a /userhost to find the user's address and then resolves it. If you specify an IP address, it looks up the host name.

You can queue multiple /dns requests, and you can view the current queue by using /dns with no parameters.

The -c switch clears all currently queued DNS requests, except for the one currently in progress.

The -h switch forces /dns to treat the parameter as a hostname.

Note: Due to way the DNS lookup works, any DNS related functions currently in progress eg. connecting to a server, must be resolved before subsequent requests. This means that if a prior DNS is having problems resolving, subsequent DNS requests have to wait until it times out before they can be resolved.

/dqwindow [on|off|show|hide|min]

Manipulates the single message window.

/ebeeps [on | off]

Enables or disables the sounds in the Sounds dialog.

/echo [color] [-cdeghiNtsaqlbfnmr] [color name] [#channel|[=]nick] <text>

Prints text in the specified window using the specified color (0 to 15).

/echo 3 #mIRC Testing

would print "Testing" in the color green in channel window #mIRC, assuming it's already open.

If a channel/nickname isn't specified, the -s switch echoes to the status window, the -d switch echoes to the single message window, and the -a switch echoes to the currently active window.

The -e switch encloses the line in line separators.

The -iN switch indents the wrapped line by N characters.

The -h switch forces lines to hard-wrap so resizing the window doesn't change the line.

The -t switch prefixes the line with a timestamp if global time stamping is on or timestamping is on for that window.

The -q switch makes it not display the text if called from an alias using the . prefix.

The -l switch makes it apply the highlight settings to the line that's displayed.

The -bf switches make it apply the beep/flash settings in the window it is echoing to.

The -n switch prevents the echo from highlighting the window switchbar icon.

The -m switch indicates that the line should be treated as a user message, not an event.

The -g switch prevents the line from being logged to the log file.

The -r switch applies the strip settings in the messages dialog.

The -c switch uses the specified color name from the colors dialog.

Note: This text is only displayed in your own window, it isn't sent to the server, no one else can see it.

/editbox [-safnop|[=]window] <text>

Fills the editbox of the current window with the specified text.

The -s switch specifies the Status window.

The -a switch specified the Active window.

The -f switch sets the focus to the editbox.

The -p switch indicates that a space should be appended to text.

The -n switch fills the editbox and presses the enter key in the editbox.

The -o switch applies the command to the second editbox in a channel window.

To specify a dcc chat window, prefix the nickname with an = equal sign.

/emailaddr <address>

Changes the email address in the Connect dialog.

/exit

Close down mIRC and exit.

/filter [-asdfkwxnpriocteubglLz] [n-n2] [c s] <infile | dialog id> <outfile | dialog id | alias> [alias] <matchtext>

This command scans lines of text in a window or file and if any of them contain matchtext, they are written out to another window or file which you can then use.

The infile can be a filename or a window name (custom or normal). The outfile can be a filename or a custom window name. You should specify the -fw switches if the names are ambiguous eg.

/filter -ff in.txt out.txt *mirc*

This indicates that both are filenames, and:

/filter -wf #in.txt #out.txt *help*

indicates that the first is actually a window name, and the second is a filename.

The -a switch sorts filtered lines by calling the optional [alias]. The alias is passed two lines in $1 and $2, it must compare these and return -1, 0, or 1 to indicate relative sort order of these lines to each other.

The -x switch excludes matching lines.

The -n switch prefixes lines with a line number.

The -s switch makes the status window the infile.

The -d switch makes the single message window the infile.

The -p switch wraps the text output in a custom window.

The -r switch specifies the range of lines n to n2 for filtering.

The -b switch strips BURK codes when matching text.

The -g switch indicates that matchtext is a regular expression.

The -z switch retains line colors when filtering between custom windows.

The -k switch indicates that you have specified an <alias> as the output instead of a window name. The alias will be called with the result of each filtered line.

The -i switch indicates that you have provided a [dialog id] custom dialog control as the input.

The -o switch indicates that you have provided a [dialog id] custom dialog control as the output.

The -c switch clears the output window/file before writing to it.

The -t switch sorts the output based on [c s], column C using character S as the columns separator.

The -e specifies a descending sort, and -u a numeric sort.

The -l switch filters from the side-listbox in the first window, and -L filters to the side-listbox in the second window.

You can filter blank lines by specifying $crlf for the matchtext.

This command also fills the $filtered identifier with the number of matches found, if any.

Note: If the input and output are the same window/file, mIRC will process the request correctly.

/findtext -n <text>

This searches active window for the specified text (same as Control+F).

/flash [-bNwNrN] [window] <text>

This flashes the specified mIRC window/icon with text in the titlebar but only if mIRC is not the active application.

The -bN switch makes mIRC beep N times.

The -wN switch makes mIRC play the Flash sound specified in the Event Beeps section N times.

The -rN switch makes mIRC repeat the flash N times.

In all cases, if N is not specified the flash/sound continues indefinitely.

/flushini <filename>

Flushes the specified INI file to the hard disk. INI files are cached in memory, so you may want to do this to make sure that your INI is updated properly.

/font [-asgbdz|window] <fontsize> <fontname>

This allows you to change the font for the current window. If no parameters are specified, the font dialog pops up, otherwise the specified parameters are used. You can make the font bold by using the -b switch.

The -a switch applies the setting to the active window, -s to the status window, and -g to the finger window.

The -d switch makes the font the default for that type of window, eg. for all channels, or all chats.

The -z switch clears all font settings and sets all windows to the specified font. If no font is specified, all windows are set to default font settings.

Note: If you use a negative number for the font size, it will match the size of fonts in the font dialog.

/fullname <name>

Changes the full name in the connect dialog.

/help [keyword]

Brings up the section in the mIRC help file which matches the specified keyword.

/hop [-cn] [#channel] [message]

Parts the current channel and joins a new one. If no new channel is specified, it parts and rejoins the current channel without closing the window.

The -c switch cycles the specified channel by parting and rejoining it.

The -n switch minimizes the channel window.

/join [-inx] <#channel>

This is a standard IRC command for joining a channel.

The -i switch makes you join the channel to which you were last invited.

The -n and -x switches minimize/maximize the channel window when you join it.