Java IRC Client Help

Java IRC Client Help Index (V1.39.5)

Index:

How do I ... (FAQs)
File menu
Room menu
Browser menu
Host function menu
Tools menu
Options menu
DCC menu
Help menu
Buttons
Line commands
Miscellaneous functions

Menu items:

File menu:
- Connect:
  To connect to an IRC server, use this menu and select Connect menu item. If the IRC server is already listed in the popup window, you can select a server in the list and click on the button 'Connect' or you can double click on the server item in the list for immediate connection. If you click on a server item that you are currently connected to, you will be disconnected from that server and then reconnect to that server. You should not make multiple connections to the same server.
  If the server you want to connect is not in the list, type in the server name in the entry field below and append the port of that server separated by ':'. If you don't specify the port, default port 6667 will be appended automatically.
  Example: type in irc.ionet.net:6666 (default port number is 6667).
  Server status:
  By using this menu item, you can get the information about the server's connections. Such as how many users are online, how many channels are available.
  Save transcript:
  Save conversations in this room. When the file dialog box pops up type in a file name that you want to save the transcript, then click on 'Save' or 'Ok' button.
  Recorder:
  This menu item allows you to continuously saving all the text in message window until you chosen the menu item again to stop it. All the text, including text in the buffer and the text displayed before you stop the recording. Before recording starts, you are asked to provide a file name to record the message. A default file is picked for you. You can modify it as desired.
  Away:
  Mark yourself as being away and set a message in case others send you private messages. You can also choose a nick name to show that you are away. If you choose to set an away nick name, your nick name will be changed automatically when you set you are away and the nick name will be restored when you set that you are back.
  Note: the away nick name feature only works when you use the GUI. It doesn't work when you use the command line to set away.
  There is a toolbar item for Away function as well.
  Clear window:
  Clear the message window. The text in the buffer is also cleared.
  What's up:
  Request up to 10 lines of messages from a user (last 10 lines in that user's window). This function works only if the user you request message is also using this IRC client. You can only make such request in a room once after joining the room.
  Save profile:
  This menu item saves all the client settings you set for all the IRC servers. From version 1.38, you can set and save different settings for different connections.
  Disconnect:
  Disconnect current connection. The server list window will popup for you to choose another server.
  Exit:
  Disconnect from the IRC server and quit the chat client.
Room menu:
- Join/New:
  When using the client for the first time, you need to set up room names that you frequently join.
  To set up the room names, type in a room name, then clicked on 'Add' button, then, select that yellow icon (single click) and then click on 'Select Icon' button. Included in this package, there are some room icons you can use under the 'gif' directory. But you can select any other icons you like for a specific room. After set all the room names, click the 'Save' button. Next time when you choose the menu item, you can double click on the icon to join a room.
  If you want to join a non-frequent joined room, simply type the the room name in the entry field and click on 'Join' button.
  Note: You can join up to 10 rooms for each IRC connection.
  New private:
  Same as 'Join/New', but people can join this room only after you invite them.
  Change room:
  Switch to a newly specified room from current room without closing the window.
  Room list:
  Display a list of rooms available to join. You can search rooms with a specific string (keyword) in the room name or topic to reduce the room list.
Browser menu:
- Accept all push/Deny all push:
  Allow/Deny URL push from any people.
  Accept one push:
  Allow only one specified person to push you URLs. Override 'Accept all push'.
  If no nick name is entered in the entry, then 'Accept all push' will apply.
  Accept from nick:
  Display the current person(nick) that you allow to push URLs.
  Select previous URLs sent:
  Display a list of URLs you previously sent to other people.
  Display a URL selected in the message box or typed in the entry field to a browser. This feature only works for Windows and OS/2 platforms.
Host function menu:
Host functions are only available to hosts (channel operators) of the room:
- Room status:
  Open room status dialog window.
  Check the boxes to set new settings for the room.
  Modify the room topic and click 'Apply' button to change topic.
  Add as host:
  Give selected people host's privileges.
  Remove as host:
  Revoke host's privileges from selected users.
  Allow to speak:
  Allow selected users to speak in a moderated room.
  Disallow to speak:
  Disallow the selected users to speak in a moderated room.
  Ban users:
  Ban selected users/user pattern to join the room.
  You can specify the ban mask in the entry field and then use this menu item.
  Auto host control:
  Automatically adds/removes specified nick names as room hosts. It works only when a user join the room, be added/removed as a host and user nick name change. A user will be matched by his/her nick name and/or part of his/her host machine name or domain. The more information you put in the entry, the more specific a user will be checked. E.g., if you provide both nick name AND host machine name, then host control will apply to only users using that nick name AND login from that host machine.
  When checkbox 'All but listed left' is checked, any user whose name is not listed in the 'Add as host' column are considered listed in 'Remove as host'.
  When the 'Auto control mode' is turned off or you are not a host, auto host control will be disabled.
Tools menu:
- Client to client:
  A set of CTCP commands you can use.
  If there are users selected in the room, CTCP requests will be sent only to the selected users. Otherwise, requests will be sent to all users in the room.
  Before using the Action command, enter an action description in the entry field.
  Search people:
  Search people in this room with nick name, and select that person. You should first select a nick name string in the message box or type in the nick name you want to search in the entry field, then use this menu item.
  Alarm clock:
  A clock that can count up or down. For count down, you can specific a time limit at which you will be prompted.
  Shortcut actions:
  Allows you to send CTCP actions with a single click. Actions are customizable by editing the 'shortcut' file under 'gif' directory. Use $# to represent the nick name(s) you selected.
  Monitor a room:
  Prompts you with a dialog window or sound when the specified user(s) have activity in this room. This function will be disabled if the radio button "off" is selected in the dialog window.
  Notify when user logon: You can specify up to nine nick names that you want to be prompted when they connect/disconnect the IRC network.
  Stock watch:
  Automatically quotes the stocks you want to monitor. Up to 20 stocks. (At present, the stock quotes are randomly generated numbers. We provided a sample CGI for you to implement the stock quote service if you have a stock quote server.)
  Ignored user list:
  You can specifiy up to 10 users, defined by their nick name and host name that you want to ignore.
  Allow messages from selected:
  When enabled, only messages from selected user will be displayed.
  Block messages from selected (ignore selected):
  When enabled, only messages from the non-selected users will be displayed.
  Post Ad:
  Administration function. Posting Ads to tickers in the specified rooms.
Options menu:
- Color:
  Set background colors for a window specified in the sub-menu.
  Font:
  Set font for a window specified in the sub-menu.
  Sort audience list:
  When enabled, user list will be sorted. This is the default setting.
  Ticker mode:
  Set ticker to be scrollable, static or hided.
  Firewall:
  For people behind a socks firewall, you can set the socks server so that your IRC connection and DCC connection can go through the socks server. If you connect an IRC server that is inside your firewall you can by-pass the firewall by prefix 'NS!' to the server name.
  Server password:
  If the server you connect to has a server connection password, you can specify the password using this menu item and then connect to the server.
  Audio:
  If you have a multi-media computer, when this option is turned on for a room, you will hear sound when people join/leave the room.
  Private message audio prompt:
  If you have a multi-media computer, when a user chats with you in private and you choose not to use a private chat window, this menu item enables you to hear the audio prompt. It is useful when you want to monitor infrequent private messages.
  Activity log:
  When enabled, display activity with time stamps in the window.
  When disabled, room activities, such as join, leave, quit will not be displayed.
  Enable CTCP:
  When enabled, other people can get CTCP responses from you.
  When disabled, other people will get a message of "CTCP refused".
  You can always send CTCP commands no matter what state this option is in.
  Message wrap:
  When enabled, text displayed in the message window will be wrapped according to the width of the window. You may disable this option when you need to display computer program-like messages.
  Private chat window:
  When turned on, any incoming private messages will be directed to a private chat window.
  Time stamp:
  When turned on, any message will be time stamped.
  To front with new message:
  When turned on, any new IRC message will bring the room window to the front. This option is useful when you want to monitor infrequent public messages.
  Identd:
  When turned on, the client will start an ident daemon. This allows you to connect to servers that requires identd check.
  Auto log all:
  When turned on, all the messages will be logged.
DCC menu: This client is capable of doing all DCC functions through socks firewall using socks 4.0 protocol. If your IRC connection is through the socks firewall, DCC connections will go through the firewall machine as well. To make it more efficient, you should prefix IRC server inside a firewall with 'NS!' so that all connections by-pass the socks server.
- DCC Chat:
  Selected a user and then use this menu item (or popup menu) to start a DCC chat session.
  DCC Send:
  Selected a user and then use this menu item (or popup menu) to start a DCC Send file session.
  DCC Receive:
  Selected a user and then use this menu item (or popup menu) to start a DCC Receive file session. DCC Receive protocol only works between different versions of this client.
  DCC Viewer:
  With this viewer, you can preview or view a file before/after you have DCC Send/Receive session. The viewer can show Images, Text and au format audio files.
  DCC Auto get:
  When turned on, your client will automatically receive a DCC Send session initiated by another user. The files will be saved under 'incoming' directory.
Help menu:
- Help index:
  Display the help information about the usage of this IRC client.
  For Windows and OS/2 users, this menu item will display the help HTML file in your default browser. For other platforms, this feature is not working.
  Upgrade IRC client:
  This feature allows you to upgrade your IRC client from a selected user automatically. To perform an upgrade, select a user that uses a newer version of this client, then select this menu item. When upgrade completes, you will be prompted whether to restart the client to use the upgraded code or wait until next time you start the client.
  About:
  Information about this applet.

Buttons:

Leave room: Close this room window.
Invite: If you are the host of this room, you can invite other people to join this room.
Enter the nick name/search pattern you want to invite, then click 'Invite'.
Search pattern: example: *.ibm.com
Kick out: If you are the host of this room, you can kick people out of this room.
Select person(s) then click 'Kick out'.
Push URL: Enter the URL in the entry first, then click this button.
If there are people selected for private talk, URL will only be sent to those people.
Get Info: Get information about the first selected person in the list.
Double click on a user's nick name can also get you that user's information.
If no person selected, your own information will be displayed.
If you know the nick name of a person, type the nick name, then push this button. This will retrieve info for this nick.
Double click (or use mouse to highlight a nick name) in the message area, then press any key to get that nick name's info.
Set Topic: Set the topic for this room.

Commands:

All commands should start with '/' and they are NOT case sensitive.

AWAY/BACK
syntax: /away [message] or /back
Set yourself away with a message or set yourself back.
CLEAR
syntax: /clear
Clear the text in the window and also clear the text in the buffer.
CTCP/PING/TIME/FINGER/VERSION/OS/JVM
Syntax: /ctcp nickname ctcp_command or /ctcp_command nickname
Example: /ctcp BlueKing ping or /ping BlueKing
DCC CHAT/SEND/RECEIVE
Syntax: /dcc dcc_command nickname
Start a DCC session
FLOOD
syntax: /flood nickname
Open up the flood control window.
JOIN
syntax: /join #roomname
Join a new room
KICK
syntax: /kick nickname
Kick the specified user out of this room. You must be a room host to be able to kick.
MAXLINE
syntax: /maxline a_number
Set the text message box buffer size, i.e. how many lines of text the message box keeps for scrolling back. The default is maxline=200.
ME
Syntax: /me action
It can be used to show a gesture, feeling, etc. as the third person.
Example: /me says hello to all
MSG
Syntax: /msg nickname message
Send a private message to the specified person
NOTICE
Syntax: /notice {nickname|#roomname} a_notice_message
Send a notice to a room or a person
NOTIFY
syntax: /notify nickname
Add the specified user into the notify list
QUERY
syntax: /query nickname
Start a private chat session with the specified user. A private chat window will popup.
QUIT
syntax: /quit message
Quit the IRC server with the specified message displayed to other clients.
SETADM
syntax: /setadm nickname
set nickname to be the admin that can post ads. This command is intended to be used with the applet version of the client that displays the ads.
USERLIST
syntax: /userlist left/right/none
Set the audience list to the specified position in the chat window or remove the audience list.

Miscellaneous functions:

Change nick name: type the new nick name in the nick name entry, then press the ENTER key.
Join a room: double clicking on a room name in a user info window will let you join that room.
Use the arrow keys (up and down) to retrieve a previously typed line.
Auto nick name completion: The client will automatically complete a nick name in your message when you type the message in the format of nick: message. The nick you type doesn't have to be a complete nick name. For example: for BlueKing, you can simply type 'blue' or even BK. The feature tries to find the best match according to your abbreviated nick name. It only completes a nick name if there is only one nick name is found to fit the specified pattern.
Toggle selected users: You can use the Esc key to toggle the selected users in the audience list.
Nick name selected in the message box can be used a parameter for most of the functions. It even strips the '<' and '>' around the nick name so that you can double click on a nick name.
Popup menus are available to all chat windows (room chat, private chat and DCC chat).
Copy and paste functions in all chat windows.

IRC Client for Java V1.39.