This page is a reference for all /-type commands that ERC recognizes. From within ERC you can type /HELP at the prompt to see a similar list.
Entries are in the format:
- COMMAND (ALIASES)
- usage
- description
- AMSG
- /AMSG message
- Send message to all channels of the current server that you are on.
- APPENDTOPIC (AT)
- /APPENDTOPIC topic
- Append topic to the current channel topic, separated by a space.
- AWAY reason
- /AWAY reason
- Mark the user as being away from current server, using reason.
- BANLIST (BL)
- /BANLIST
- Pretty-print the contents of
‘channel-banlist’. - CLEAR
- /CLEAR
- Wipe out window contents and give it a fresh start.
- CLEARTOPIC
- /CLEARTOPIC #channel
- Clear the topic for channel #channel or default channel if #channel is unspecified.
- COUNTRY
- /COUNTRY code
- display country name for the two letters country code passed as an argument.
- CTCP
- /CTCP nick command
- sends the ctcp command command to user nick.
- DEOP
- /DEOP nick1 nick2 nick3 …
- removes operator privileges from users nick1, nick2, nick3, … for current channel.
- DESCRIBE
- /DESCRIBE user action
- Pose some action to a certain user
- GAWAY
- /GAWAY reason
- mark the user as being away from all servers, using reason.
- GQUIT (GQ)
- /GQUI reason
- Disconnect from all servers at once with the same quit reason.
- HELP (H)
- /HELP arg
- Pop up help information. With no argument, display an apropos about erc commands. Otherwise, display help about the function or variable passed as argument arg if it is bound, or do a apropos search in the erc namespace. “/help HELP” shows you help about help.
- IDLE
- /IDLE nick
- Show the length of time nick has been idle.
- IGNORE
- /IGNORE user
- Ignore user. This should be a regexp matching nick!user@host.
- JOIN (J, CHANNEL)
- /JOIN #channel
- Join channel #channel or create it if it doesn’t exist. This command spawns a new buffer which contains this channel’s traffic. See also C-c C-j.
- KICK
- /KICK #channel nick reason or /KICK nick reason
- Kick the user “nick” from channel #channel, advertising it with reason.
- LASTLOG
- /LASTLOG line
- Show all lines in the curent buffer matching the regexp line.
- LOAD
- /LOAD script args
- load the script script, with optional arguments script args. Arguments are set as the local variable
‘erc-script-args’ in the namespace of script. - ME
- /ME action
- pose action action to current channel or query buffer
- MASSUNBAN (MUB)
- /MASSUNBAN
- Mass unban.
- MODE
- /MODE line
- Change or display the mode value of a channel or user.
- MSG (M)
- /MSG user-or-channel message
- send the private message message to user or channel user-or-channel.
- NAMES (N)
- /NAMES #channel
- briefly list the users in channel #channel.
- NICK
- /NICK nick
- set nick to nick.
- NOTICE
- /NOTICE user-or-channel message
- send the notice message to user or channel user-or-channel.
- OP
- /OP nick1, nick2, nick3 …
- set channel mode +o for nick1, nick2, nick3, … for current channel.
- OPS
- /OPS
- Show the ops in the current channel.
- PART (LEAVE)
- /PART #channel reason
- leave channel #channel or current channel if #channel is not specified and use reason, or use default reason if none specified. See also C-c C-p.
- PING
- /PING nick
- ping the user named nick and print elapsed time between ping and return.
- QUERY
- /QUERY nick
- open a query buffer with user nick
- QUIT (Q, BYE, EXIT, SIGNOFF)
- /QUIT reason
- disconnect from the current server, advertising it with reason or default reason if unspecified.
- QUOTE
- /QUOTE text
- Send text directly to the server.
- SAY
- /SAY text
- Send text to the current query or channel as a message, not a command.
- SERVER
- /SERVER server
- Connect to server, leaving existing connection intact.
- SET (VARIABLE, VAR)
- /SET variable value
- set variable variable to value, which is a lisp expression that is evaluated.
- SV
- /SV
- says the current ERC and Emacs version into channel.
- SM
- /SM
- says which modules are enabled
- SMV
- /SMV
- says the enabled modules with revision numbers
- TIME (DATE)
- /TIME
- Request the current time and date from the current server.
- TOPIC (T)
- /TOPIC #channel topic or /TOPIC channel-or-topic
- set topic for #channel or current channel if unspecified. If topic is not specified, current topic will be displayed instead of modifying it. You can also use C-c C-t to set the topic interactively.
- UNIGNORE
- /UNIGNORE user
- Remove the specified user from the ignore list.
- WHOAMI
- /WHOAMI
- Do a /WHOIS on your current nickname.
- WHOIS (WI)
- /WHOIS nick
- displays various information about user nick.
Commands provided by ERC modules, sorted by module:
ErcChess
- CHESS
- /CHESS nick
- Initiate a chess game via CTCP to nick. Nick should be the only arg to /chess.
ErcDCC
- DCC
- /DCC command user args
- Initiate a Direct Client to Client connection with user. command can be one of CLOSE, GET, SEND, LIST, CHAT, etc
- CREQ
- /CREQ type
- Set or get the DCC chat request flag. Possible values of type are: ask, auto, ignore.
- SREQ
- /SREQ type
- Set or get the DCC send request flag. Possible types are: ask, auto, ignore.
ErcEzbounce
- EZB
- /EZB command
- Send EZB command to the EZBouncer verbatim.
ErcMule
- LANG
- /LANG language
- Display the language name for the language code given by language.
ErcList
- LIST
- /LIST channels
- Displays a buffer containing a list of channels on the current server.
ErcNetsplit
- WHOLEFT (WL)
- /WHOLEFT
- Show who’s gone after a netsplit.
ErcNotify
- NOTIFY
- /NOTIFY or /NOTIFY nick1, nick2, nick3…
- With no arguments, list members of
‘erc-notify-list’ who are on this server. Or, with arguments, add nick1, nick2, nick3 to erc-notify-list. If you type a nick that is already in the notify list, it will be removed.
ErcPage?
- PAGE
- /PAGE user message
- Send a CTCP PAGE message to user. Note that you will only receive pages if
‘erc-page-mode’ is on.
ErcSound
- SOUND
- /SOUND line
- Play the sound given in line.
FIXME: Add more elaborate descriptions and add links. – BenjaminDrieu
ERC allows you to add your own commands as well. As long as you provide a defun with a name like erc-cmd-XXXX, then /XXXX (or /xxxx) will call that command. You can get a picture of what some of those should look like in erc.el, and on this wiki. Look at NowPlaying, for example. A final t is used to inform the calling function that everything went fine. If a erc-cmd-XXXX function returns nil, erc reports “Bad syntax” or a similar message.
ERC