Konversation commands

The following commands are interpreted by Konversation and may differ from standard IRC commands. Items inside square brackets are optional. Items separated by bar (|) are alternate forms of the command. Commands not listed here are sent to the server as entered.

/me msg

Sends msg to the channel preceded by your nickname. For example, if your nickname were Tux, typing /me brews a cup a tea. displays the message Tux brews a cup of tea. Unless they've filtered against these types of messages, all users see it. This kind of message is typically used to convey non-verbal information, such as your current emotional state, or what you are physically doing. If you are leaving your workstation for a short time, use the /away command instead.

/ame msg

Like the /me command above except that the message is sent to all the channels and queries you have open on all the servers you have connected in Konversation.

/join channel [pwd]

Joins channel. If the server permits it, and if the channel does not already exist, it is created and you are the channel operator. If the channel requires a password in order to join, specify as pwd. Most channel names begin with #.

/j channel [pwd]

Same as /join above.

/part [channel] [reason]

Leaves channel with reason and closes the corresponding channel tab. Within a Konversation channel or query tab, you can just enter /part which closes that channel or query with your default reason as given in the Settings.

/leave [channel] [reason]

Same as /part above.

/quit

When entered in any channel, query, or DCC tab, disconnects from the corresponding server and closes all channel, query, or DCC tabs open on that server.

/notice nick|channel msg

Sends msg to the user with nickname nick or to everyone in channel. The following is an example of what appears to you in the channel tab

[17:14] [Notice] Sending notice "I think I understand" to #konversation

And this is what the recipients see

[17:15] [Notice] -Eisfuchs- I think I understand

/query nick

Creates a new tab with the user's nick for private conversation, commonly known on IRC as a Query. Everything written here is only visible to you and your query partner. You may enter more than one nickname separated by spaces and a query tab will be opened for each nickname. Each such query tab will be private between you and the query partner.

/msg nick|channel message

Sends a private message to the user with nickname nick or to all users in channel. Unlike /query, does not open a new tab. If message begins with /me , the message is formatted in the same manner as a /me command.

Examples

/msg Eisfuchs I need some help with the msg command

/msg #konversation New version of Konvi is online!

/msg Eisfuchs /me is compiling the Handbook right now.

/smsg nick|channel message

Same as /msg except the message is not displayed on your screen. This is useful for preventing passwords and other sensitive information from remaining exposed on your screen or being logged.

/amsg nick|channel message

Like the /msg command above except that the message is sent to all the channels and queries you have open on all the servers you have connected in Konversation.

/op nick

When entered into a channel tab, attempts to give nick operator privilege for the channel. May not work if you lack sufficient privilege in the channel (you must be a channel operator yourself). You may enter more than one nickname separated by spaces.

/deop nick

When entered into a channel tab, takes away channel operator privilege from nick. You may enter more than one nickname separated by spaces.

/oper [nick]

Grants the user with nickname nick IRC-Op (Administrator) privilege. This only works if the nickname is listed in the server's O: line. IRC-Ops have the privilege to /kill nicknames, /connect servers to the IRC network, and more. If nick is not entered, attempts to grant yourself IRC-Op privilege. You will be prompted for your IRC-Op user name and password in either case.

/voice nick

In certain channels (with +m flag), users cannot send messages unless they have voice privilege. This command attempts to give nick voice privilege. You must have channel operator privilege to execute this command. This command is mostly used when you are an operator for a moderated channel.

/unvoice nick

Takes away voice privilege from nick in the channel.

/topic [channel] [message]

Attempts to set the topic of channel to message. When entered in a channel tab, channel may be omitted and defaults to the channel active in the tab. If message is omitted, displays the current topic of the channel. Changing a channel topic may fail if you lack sufficient privilege.

/away reason

If anyone tries to send you a private message or invite you to a channel, they will be told that you are away from your workstation for reason. To change your state back to normal, enter /away without a reason.

/aaway reason

Like the /away command above except that the command is sent to all the servers you have connected in Konversation.

/invite nick [channel]

Invites the user with nickname nick to join channel. This command is especially useful if the channel is invite-only. When entered in a channel tab, channel may be omitted.

/exec script [parameters]

Executes the Konversation-compatible shell script named script, passing it parameters. See Scripting for more information on using and writing scripts.

Examples:

/exec kdeversion

Sends your system's KDE and Qt™ version numbers to the channel.

/exec cmd uname -a

Sends your Linux® version string (the output of uname -a) to the channel.

/notify [nick]

Adds or removes nick from your Watched Nicks Online list. If the nickname is already in the list, it is removed. If it is not in the list, it is added. If nick is omitted, displays the current list of watched nicknames.

/kick nick reason

When entered in a channel tab, attempts to kick the user with nickname nick from the channel with reason. If reason is not entered, defaults to the reason in the Settings. This command may only be used in a channel tab.

/ban [-host|-domain| -userhost|-userdomain] [channel] user|mask

Attempts to ban the user or mask from channel. When entered in a channel tab, channel may be omitted. For more information on hosts, domains, and masks, see the documents at irchelp.org. To get the current ban list for a channel, enter /mode channel b.

/unban [channel] pattern

Reverts a previous banning from a channel. When entered in a channel tab, channel may be omitted.

/ignore [-all] nick

Adds nick to your Ignore list. You may specify more than one nickname separated by spaces. Channel messages from users on your Ignore list are not displayed. In addition, if you enter -all, all message types (queries, notices, CTCP, DCC, and Exceptions) from the user are ignored as well as channel messages.

/quote cmd

Sends cmd to the server.

/say msg

When entered in a channel tab, sends msg to the channel. This is the same as entering msg in the channel Input Line. Useful for sending IRC commands when you don't want to execute the command. Two command characters (//) in a row does the same thing as /say. Also used by scripts to send messages.

/raw [open|close]

Places the server log in raw mode (open) or stops raw mode (close). If neither open or close is entered, defaults to open. In raw mode, the log displays every message received from the server in native IRC format.

/konsole

Opens a new tab running a KDE Konsole.

/server [url] [pwd]

Connects to the server at address url. If url is omitted, connects to the server associated with the tab where you enter the command. This is useful for re-connecting to a server when disconnected. If the server requires a password in order to connect to it, enter it for pwd. If the server requires a port number other than the default (6667), enter the url like this: irc.kde.org:6665.

/dcc SEND nick [filename]

Sends filename to the user with nickname nick. If filename is omitted, a dialog appears for you to select a file.

/dcc

Opens the DCC Status tab.

/ctcp nick|channel ping

Sends a PING message to nick or channel. This is useful for determining if someone you are talking with has a high network lag, or (when sent to a channel) if your system has a high lag.

/ctcp nick|channel msg

Sends a message to nick or all users in channel. This is similar to the /msg command above, except that the message is sent using the CTCP protocol. The response on the other end depends on the IRC client program the user is running. For example, when conversing with another Konversation user, /ctcp Eisfuchs TIME will return the system time on Eisfuch's computer. /ctcp Eisfuchs VERSION will return the Konversation version number from Eisfuch's computer.