DCC File Transfer Information

Wiki Home

Direct Client-to-Client (DCC) is an extension of the IRC protocol that enables the ability to transfer files between users. It works by establishing a direct connection between yourself and another user allowing small and large files alike to be sent to each other without the need for a 3rd party service.

DCC provides the ability for friends, family, and even complete strangers to exchange files without the worry of having to setup separate accounts on file sharing websites which tend to be slow or trusting their data to "the cloud."

How does it work?

When a file transfer is initiated, Textual sends information about yourself and the file to the person receiving it. This information includes your own IP address, the port on which to connect, the filename, and the total file size. Once the file transfer request is received, the person receiving it can either chose to accept the transfer or ignore it.

If they accept the transfer, their IRC client will attempt to establish a connection to the IP address and port that was included part of the transfer request. Once a successful connection is established, the file is sent.

Technically speaking, the sender of a file acts as a file server which the receiving user connects to.

This of course all works in reverse if a file is sent to you.

How do I accept a sent file?

When a file transfer request is received, it is placed in the File Transfers window. This window can be found by going to the main menu in the top left of the screen, selecting the Window menu, and selecting the item labeled File Transfers.

From within this window, file transfers which are being sent as well received can be managed.

By right clicking (or control clicking) one or more items in this window, a menu is presented which contains multiple actions which can be performed on each transfer. These actions include the ability to start and stop a transfer.


For visual reference, the File Transfers window looks similar to the following:

image 1

Is there anything I need to know before sending files?

Yes. When sending a file, the person receiving it will have difficulties if you are on a wireless network.

This is because the receiver must establish a connection to you as the sender and to do so, they must connect to your Mac. However, being on a wireless network means that your Mac is not directly facing the Internet.

For a receiver to be able to connect to you, something known as port forwarding is required.

When sending a file, Textual attempts automatic port forwarding using UPnP and NAT-PMP. However, this automation does not always work due to limitation in hardware or misconfiguration.

If you are only interested in receiving files, not sending them, then this does not apply to you.

That's okay, so how do I actually send a file?

There are two ways to send a file through Textual:

The first way is to right click (or control click) the nickname of the user you wish to send a file to. In the menu that appears, browse to the submenu labeled Client-to-Client. From within this menu, select the item Send fileā€¦.

Alternatively, dragging any file on top of a nickname on the user list of a channel will send a transfer request.

Are there any configuration options available?

There certainly are. In Preferences select the Advanced tab. In the menu that appears, chose the File Transfers item.

I am on native IPv6? Can I use DCC?

Sending and receiving files between yourself and other users of Textual is supported on native IPv6. Support for it on other IRC clients is currently limited so it may not work if a file transfer is attempted with a user that is not on Textual.

Textual only provides support for native IPv6. IPv6 tunnels are not supported due to networking difficulties.

I received an error. What does it mean?

The following are common errors that can be encountered during a file transfer:

Transfer with [user] failed. There is no open port.

This error occurs when Textual tries to send a file but was unable to find a port which was open for listening.

Transfer with [user] failed. Could not read source file.

This error occurs because Textual tried to access a file which may no longer exist or has inappropriate file permissions.

Transfer with [user] failed. Unknown source IP address.

This error occurs when trying to send a file when the IP address of the sending machine is not available. By default, Textual tries to request the value of your IP address from an external source. However, sometimes this may fail. Restarting Textual may resolve this issue. If it does not, an IP address may need to be entered manually in Preferences.

Transfer with [user] failed. Connection was disconnected.

This is a general error that can occur for multiple reasons. If this error occurs during a file transfer, then the sender may have cancelled the transfer or there was a slight Internet hiccup that could not be recovered from.

Transfer with [user] failed. Could not establish connection.

This error occurs when a connection cannot be established to the user sending a file. This is likely due to their Mac being behind a firewall or wireless network which is not forwarded properly.


 
Last modified: January 22, 2014


The contents of this webpage are released into the Public Domain for unlimited distribution.