tkirc(1)

NAME

tkirc - Tcl/Tk based client to the Internet Relay Chat

SYNOPSIS

tkirc [-x ircpath] [-q] [-r] [-t filename] [nickname [server]]

DESCRIPTION

tkirc is a frontend for unix's ircII (shell-client for the Internet Relay Chat) based on Tcl/Tk. A nice graphical user interface brings you the world of IRC. Together with ircII and Tcl/Tk it should run under nearly all Unix-like operating systems.

OPTIONS

-x ircpath: You can declare another path for the ircII command. It's also possible to start ircII from another host via remote shell command rsh(1). See also: /EXCHANGE

-q: Start up tkirc quickly - don't load file $HOME/.tkircrc.

-r: Usually tkirc doesn't pay attention to file $HOME/.ircrc. If you use this option tkirc
will try to load two rc-files ($HOME/.tkircrc and $HOME/.ircrc) during its startup.

-t filename: This option allows you to specify a file that will be loaded during start instead of $HOME/.tkircrc or $HOME/.tkirc/tkircrc.

nickname: Set the nickname (overrides the environment variables IRCNICK, USER, LOGNAME and tkirc's variable preferred_nicknames).

server: Set the list of servers. See also ircII's manual for OPTIONS (server list)!

FEATURES

This section will show you some of tkirc's features that you possibly will never find, if you don't read this manpage or the file tkircrc-example. *grin*

nickname completion: If you have joined a channel, you can press TAB to complete the nicknames of other users. If the nickname is the first word in your command line, the value of variable nick_completion_suffix will be added.

more than one channel per window: You are able to join more than one channel in one window. The channelname above the userlist will be changed into a menubutton. All channels you have joined in that window will be displayed in window's title. If you type something without leading `/', it will be sent to that channel you see above the userlist.

nickname history: When you receive a private message or a private notice, the nickname of the sender will be added to the nickname-history. Press ALT-TAB and you will find a /msg nickname within your command line. Press ALT-TAB again and you will see that tkirc cycles the nicknames. Maximum length of nickname-history is set to 5 to prevent long sequences of ALT-TABs.

user definable colors and text styles: You are able to choose your own colors and text styles for different kinds of messages, if you don't like the default values. See also variable user_styles in file tkircrc-example.

function to detect netsplits and netjoins: If the value of variable react_to_netsplits is set to `1', tkirc will show you one message for netsplit or netjoin instead of long sequences of netsplit-signoffs or join-messages.

highlighted URLs: URLs (addresses for the World Wide Web) will be highlighted (like buttons for example) and you can perform actions on them. See variables on_urlclick and url_style!

highlighted message IDs: Message IDs (of news articles for example) will also be highlighted and you can also perform actions on them. See variables on_msgclick and msgid_style!

function to detect and prevent channel takeovers: If value of variable react_to_takeover is set to `1', tkirc will give you an audible and visible alarm. In the case that you have channel operator privileges at the moment of takeover, a request window will be opened and you can react with one ban and multiple kicks. Nothing will automatically happen. You have the choice to do something against the takeover. See also variables react_to_takeover, takeover_users, takeover_period, takeover_kick_reasons and takeover_star_patterns in file tkircrc-example!

ctcp-flood protection: tkirc also include a protection against ctcp-flooding. This feature is based on some settings of ircII. See also variables react_to_ctcp_flood, host_flood_ignore_period and global_flood_ignore_period!

file request for your commands: If you include :file to your command (you typed within one of tkirc's command lines), this :file will be replaced by the name of the file you selected through the request window. Example: Try /dcc send nick :file!

command history: On CURSOR-UP and CURSOR-DOWN the command history will be cycled.

progammable commands through Tcl/Tk: Beside ircII's aliases you are able to creat your own Tcl/Tk commands and add your own menu to tkirc's graphical user interface.

many other user definable features: This section is not a complete list of tkirc's features. You have to read the file tkircrc-example to see many more!

ircII's commands: Besides tkirc's additional commands (listed in next section) you are able to use many of ircII's features and commands.

COMMANDS

It's possible to use nearly all commands of ircII. Try command /help and you will see a list of tkirc's and of ircII's commands. This section lists the additional commands of tkirc and shows their usage.

/BANNICK nick: This command opens a new window you can select a banpattern with to ban user nick from the current channel.

/BANCOMMENT channel (number|pattern) comment: This command allows you to set a comment to a ban of channel channel. number or pattern selects the certain ban of channel's banlist.

/BANINFOS channel: This displays more informations of channel's bans than `/MODE channel b'

/CHAT nick1[,nick2[...]]: A new window will be opened for a private conversation with all users specified through nick1[,nick2[...]].

/CLEAR: The window you typed this command in will be cleared.

/CLEARALL: All windows will be cleared.

/CLOSE: The window you typed this command in will be closed.

/CLOSECRAPLOG: The craplog will be closed.

/CLOSELOG (channel|nick): The logfile you opened for conversation with channel or nick will be closed.

/CLOSELOGALL: The logfile for all kinds of irc-traffic will be closed.

/CLOSEMSGLOG: The logfile for whole traffic of private messages and notices will be closed.

/CRAPLOG filename [-d]: This command allows you to open file filename to log all kinds of crap in. Select option -d for additional time stamps.

/DCHAT nick: A new window will be opened for a direct client to client (DCC) conversation with user nick.

/EXCHANGE ircpath [nick [server]]

This command allows you to exchange the ircII command, tkirc is just running with. If you are able to use the remote shell command `rsh', you can start your ircII on another host. For example:

  /exchange "rsh <host> -l <login> <remote_ircpath>" <nickname>

This command is also available as shell option -x. Try to start from shell:

  ~> tkirc -x "rsh <host> -l <your_login> <irpath_on_that_host>"

/LOADBANINFOS channel filename: This tries to update baninfos of channel channel with the includes of file filename.

/LOG ( channel|nick) filename [-d] [-r]: The logfile filename will be opened for traffic of channel channel or for a private chat with user nick. Select option -d for additional time stamps or -r to log the messages how you receive them from your IRC-server.

/LOGALL filename [-d] [-r]: The file filename will be opened to log the whole irc-traffic in. Select option -d for additional time stamps or -r for raw messages.

/LOGS: A list of all opened logfiles will be displayed.

/MSGIDS: A window will be opened that shows you a list of all message IDs detected in your tkirc session.

/MSGLOG filename [-d] [-r]: This command allows you to open file filename to log all private messages and notices in. Select option -d for additional time stamps or -r for raw messages.

/NEWWIN: This command opens a new traffic window.

/NOTIFIES: This command opens a window to display all notified nicknames.

/SAVEBANINFOS channel filename: Tries to save baninfos of channel channel into file filename. You can load these baninfos, when you rejoin channel channel.

/SAVEBUFFER tofile: The buffer of the current window will be saved into file tofile.

/SEARCH text: This command highlights all occurrences of text in the text field and jumps to it/the next.

/SPLITS: Shows you a list of all detected netsplits.

/TAKEOVERS: Shows you a list of all detected (possible) channel takeovers.

/URLS: A window will be opened that shows you a list of all URLs detected in your tkirc session.

/WJOIN channel1 [,channel2 [,...]]: This command opens a new window for each channel and joins all of them.

FILES

$HOME/.tkircrc
$HOME/.tkirc/tkircrc

AUTHOR

tkirc was written by Andreas Gelhausen <[email protected]>.

This manual page was created by Roland Rosenfeld <[email protected]> for the Debian GNU/Linux system (but may be used by others).