wiki:FAQs

TracNav(Documentation)? This is part of the Documentation Project, please help document Colloquy if you know anything that would be relevant here for other users to know about.

Frequently Asked Questions for Colloquy users

Table of Contents

  1. General
    1. What is Colloquy?
    2. What is IRC?
    3. What is an IRC Server?
    4. What is an IRC Network?
    5. What is SILC?
    6. What is DCC? Does Colloquy support it?
    7. What is a Chat Room?
    8. What is a Channel?
    9. How is Colloquy like Irssi?
  2. Support
    1. Where do I install new Styles, Emoticons or Plugins?
    2. Is there a way to add chat rooms to the favorite menu for easy access?
    3. What is an ident server and what should I do to get servers like irc.efnet.net or irc.dal.net to work?
    4. Is there a way to see my sent history as well as to navigate around in the existing text with the arrow keys?
    5. How can I get servers to connect on launch?
    6. How can I set chat rooms to be joined automatically when I join a server?
    7. Where do I put my silc keys? (On my *NIX box, they're in ~/.silc)
  3. Pro user
    1. Why do you deviate from the standard IRC nomenclature? It's a channel, not a chat room. I suppose the idea is to make IRC easier to use, but on the other hand, a new set of names may confuse things more than it helps to clear them up: if a newbie googles for IRC help or asks for it on a channel, the answer is probably given using the standard IRC terminology.
    2. I am behind a router / firewall. Why don't file transfers / DCC chat / fserves work?
    3. Does colloquy have a way to ignore/hide parts, nicks, etc in a busy room?
    4. How do i connect to an Irssi Proxy using Colloquy?
    5. How do I make Colloquy use an SSH tunnel?
    6. How do I use Tor with Colloquy?
    7. Can I use Blowfish encryption with Colloquy?
    8. How can I get a text transcript?
    9. Can I connect to Colloquy's bouncer from a non-Mobile Colloquy client?
  4. Network specific issues
    1. DALnet
    2. EFnet
    3. freenode
  5. Troubleshooting & Feedback
    1. Where can I provide feedback?
    2. Where is the Colloquy IRC chat room?
    3. How do I report a bug?
    4. How do I suggest a new feature?
    5. What else can I do to help improve Colloquy?


General

What is Colloquy?

Colloquy is an open-source, free, IRC and SILC client for the Macintosh, specifically Mac OS X.

What is IRC?

IRC, or Internet Relay Chat, is a network of servers that make up a service allowing for text-based conversations between users over the Internet. Wikipedia on IRC

What is an IRC Server?

An IRC server is a commercial computer that your IRC client connects to in order to connect to an IRC network (e.g. irc.freenode.net). Wikipedia on IRC servers

What is an IRC Network?

An IRC Network is a one or more server that operates together, serving local channels. Wikipedia's list of IRC networks

What is SILC?

SILC stands for Secure Internet Live Conferencing. SILC is very much the same as IRC with the major difference being that all conversations are encrypted and much more secure then IRC. Wikipedia on SILC

What is DCC? Does Colloquy support it?

DCC stands for Direct Client-to-Client connection and is an addition to the IRC protocol. It is used to send files to other users on IRC and also allows direct chat between two IRC users. File Servers (fserves) rely on this. Colloquy currently supports DCC Chat, DCC Send and also passive DCC. (See "File Transfers" in Colloquy) Wikipedia on DCC

What is a Chat Room?

A chat room, or channel, is a particular subsection of an IRC Server in which users communicate to each other via text-based messages. This is the term Colloquy uses over channel. (Why?)

What is a Channel?

A channel is another name for a chat room. (See above.)

How is Colloquy like Irssi?

Colloquy used to be like Irssi by sharing the same Chat Core. However, we have now written our own chat core and are no longer connected to Irrsi.


Support

Where do I install new Styles, Emoticons or Plugins?

New Styles, Emoticons and Plugins can be installed in:

~/Library/Application Support/Colloquy/Styles
~/Library/Application Support/Colloquy/Emoticons
~/Library/Application Support/Colloquy/PlugIns

To activate them without restarting Colloquy, just type "/reload plugins" or "/reload styles" (without the quotes) depending on what you installed.

Is there a way to add chat rooms to the favorite menu for easy access?

Colloquy has many control-click (right-click) context menus. Adding a room to the favorites list is in the room/tab context menu. The favorites list is available from the File menu or the heart menu-button in the drawer.

What is an ident server and what should I do to get servers like irc.efnet.net or irc.dal.net to work?

The answer is available in the documentation.

Is there a way to see my sent history as well as to navigate around in the existing text with the arrow keys?

Sent history is controlled by the up/down arrow keys while holding option, switching between panes in a window with command-up/down, and scrolling with home/end/page up/page down; you can use any other key combination to navigate or select text. Change this within the hidden preferences.

How can I get servers to connect on launch?

There are two ways to do this. The best way is to choose Window -> Connections, and check the checkbox next to the server name under the star column. Or you could select the server of your choice in the Connections window and click the "Info" button on the toolbar, select the "Automatic" tab and then check "Connect on launch." Either one will have your server automatically connected when you open Colloquy.

How can I set chat rooms to be joined automatically when I join a server?

Choose Window -> Connections, then click the server of your choice and click the "Info" button on the toolbar. Select the "Automatic" tab, and then add the chat rooms you want to automatically join that server by clicking the appropriate "+" button.

Where do I put my silc keys? (On my *NIX box, they're in ~/.silc)

The keys private_key.prv and public_key.pub need to be located in ~/Library/Application? Support/Colloquy/Silc/?. On first connection, the server's public key will be added in the Server Keys directory in the path above. Server passwords and channel passwords may or may not be necessary, depending on the configuration of the Silc server you're connecting to.


Pro user

Why do you deviate from the standard IRC nomenclature? It's a channel, not a chat room. I suppose the idea is to make IRC easier to use, but on the other hand, a new set of names may confuse things more than it helps to clear them up: if a newbie googles for IRC help or asks for it on a channel, the answer is probably given using the standard IRC terminology.

This question keeps coming up in the Colloquy room/channel. The chat room term I use is protocol generic, leaving Colloquy untethered to a specific protocol if the day comes to add new chat technology that might use different terms. This is the reasoning behind using the term "Chat Room", and not using "IRC" in the interface either, along with the easy to understand nature for new, and casual users.

I am behind a router / firewall. Why don't file transfers / DCC chat / fserves work?

For direct client-to-client connections to work, at least one of the two users must be able to act as server. To do that in Colloquy follow these steps:

  • Passive DCC: Turn on "Send Files Passively" in Colloquys "File Transfer" preferences (this means, the other user needs to act as the server and it may also be your only option if you have no control over your firewall / router). Try this first.
  • Firewall: depending on how your firewall works (if you are using one at all) you need to
    • either "open" the ports specified in Colloquys "File Transfer" preferences (default is 1024 to 1048) for TCP and UDP (this applies to OS X' built-in firewall)
    • or allow Colloquy to act as a server / accept connections from the internet
    • or both.
  • Router: You should try after each of these steps.
    • Turn on "Automatically open ports in router" in Colloquys "File Transfer" preferences (even if your router supports this, you may still need to enable either UPnP or NAT-PMP in your router settings as well).
    • If your router doesnt support either UPnP or NAT-PMP you need to manually tell your router to "forward" the ports specified in Colloquy's "File Transfer" preferences (default is 1024 to 1048) to your computer.

Refer to the manual of your firewall / router on how to do this.

Does colloquy have a way to ignore/hide parts, nicks, etc in a busy room?

Colloquy does behave much better with no join/part event messages. There is no preference for this yet, but you can do a CSS trick to disable all event messages. This requires the latest release.

When using a custom style Variant, Option-Click the Customize button in Appearance Preferences. The CSS file should open, then add:

.event {
    display: none;
}

Now type "/reload style" in the busy room. All the event messages will disappear and no new ones will show up.

NOTE: If you created a new variant in this process make sure to re-select "Default" from the style toolbar item to see immediate changes in a room. (All other rooms will be updated at next launch.)

A custom style has been created for Keynote IRC coverage (but can be used for any busy room). The style has a variant that will hide events, allowing you can switch back and forth to show and hide them. Just download the style and double click to install, following any on-screen dialogs. Make sure to pick the style for the room you want or set it as the default (make sure to re-select "Default" from the style toolbar item to see immediate changes in a room.)

How do i connect to an Irssi Proxy using Colloquy?

First, set up the Irssi Proxy on the host computer (or server). Then create a new connection in Colloquy and point it to the host computer like it was a normal IRC server.

How do I make Colloquy use an SSH tunnel?

First, you need to create the SSH tunnel by running the following command in you Terminal app (you also need to adapt it do your situation):

ssh -n -L 6667:irc.server.example.com:6667 you@homemachine.whatever.com

Then you need to make a new connection in Colloquy, use localhost as server address and 6667 as port.

How do I use Tor with Colloquy?

See here for instructions on using Colloquy in conjunction with Tor.

Can I use Blowfish encryption with Colloquy?

Yes, there is a plugin and instructions by Guillaume Boudreau.

How can I get a text transcript?

Get the PrettyPrint plugin. You can then transform a Colloquy transcript (which is xml) to MediaWiki? format. If you don't have a mediawiki available for viewing, try using Wikipedia Sandbox. Paste your converted transcript there, hit preview, snag the html or cut and paste the formatted transcript from your browser. It might be nice to modify the xsl in prettyprint to provide a format like html, or reStructuredText.

Can I connect to Colloquy's bouncer from a non-Mobile Colloquy client?

Yes. The username for the connection is "<ircusername>@<ircserver>", while the server password that you use to connect is "<bounceruser>:<bouncerpass>". The server is, of course, the IP or hostmask of the computer running Colloquy with the bouncer enabled. This is, however, currently unsupported beyond noting that it is possible to do.


Network specific issues

DALnet

  • Some DALnet servers require running an ident server.
  • Some of the servers in the network are reserved for certain regions (some EU servers are scandinavian only for example).
  • Also we were told that some of the servers in the network are known to be unable to connect to for some users (there will be absolutely nothing in your console, even if you had it open while trying to connect), this is not a Colloquy issue. This concerns servers with "ix" in their name, also some european servers and maybe others, too. Look at this list of alternative servers and connect to them directly instead of connecting to irc.dal.net (for example we found punch.va.us.dal.net to be working).

EFnet

freenode

  • By default direct chat with a registered user is only allowed for other registered users.

Troubleshooting & Feedback

Where can I provide feedback?

Colloquy is still a product in development, and we are interested in hearing your comments. Write us here or join us in the Colloquy IRC chat room (See below.).

Where is the Colloquy IRC chat room?

The Colloquy chat room is a good place to talk about Colloquy issues with other users, and to give feedback about Colloquy; this room is monitored occasionally by the developers.

How do I report a bug?

If you think you've found a Colloquy bug, check to see if you are running an earlier Colloquy version. Please upgrade if possible before filing bugs that may have already been fixed.

Next search through the tickets to see if anyone else has already filed it. If you can't find a ticket filed, you are ready to file a ticket. Keep in mind, the better your bug report, the higher the chance that your bug will be addressed quickly.

Once your bug is filed, and you gave us an email address, you will receive email when it is updated or the status changes. After the bug is considered fixed, you will usually be asked to update to the most recent release of Colloquy and try it, to make sure that the fix works for you.

How do I suggest a new feature?

Suggestions are always welcome, but you should be aware that due to different reasons (main purpose of Colloquy, Human Interface Guidelines, limited time on the developers side) not all of them will make it into a release.

To suggest a new feature the same steps apply as to file a bug (See above.). The only difference is that when you file a new ticket you have to select "enhancement" rather than "defect".

What else can I do to help improve Colloquy?

You might want to start by reading the Development Guide.

Last modified 9 days ago Last modified on Apr 8, 2014 2:23:13 PM