Personal tools

Dtella:Installation Guide for Macs

From Dtella Wiki

Jump to: navigation, search

Enjoy! If you have a router, you will need to consult the Router Setup Guide.


Installing Dtella on a Mac

  1. You will need a DC client for Mac. The best client for Mac is EiskaltDC++ (So here are instructions for Shakespeer because we haven't updated our wiki properly)
  2. Download Dtella. Go to and download the latest DMG image. Open the DMG file, open Finder, under devices click "dtella-purdue-*" (the * will be the version number) and drag the Dtella icon to the Applications folder.
  3. Go to your Applications folder and double click Dtella. You will not see any application appear, as it is running in the background.
  4. Start Shakespeer and click on Bookmarks.
  5. Click the plus at the bottom of the screen.
  6. Add the following information:
  Name: Dtella
  Nickname: whatever you want (don't use spaces or punctuation in your name)
  Check connect at launch
Dtella Settings.png
  1. Click OK.
  2. Under Preferences, select the share tab and then choose the folders/files you want to share
  3. Hit the [+] button to add some files to your share. Make sure to add at least 5GB of media (such as music, movies, games, etc). Don't share anything from your Applications folder. Don't forget to set a download location and incomplete download location on this screen as well.
    Shakespeer share.png
  4. Finally, click on network and choose a port. The default of 1412 works just fine, but anything over 1024 will do. Make sure the connection mode is set to "Active mode" and the checkboxes match what is shown in the screenshot. Remember, if you are behind a firewall or router, this port needs to be forwarded for both TCP and UDP port types to your computer along with the Dtella UDP port.
    Shakespeer network tab.jpg
  5. Click on Dtella@Purdue on the left and you should be ready to download! You can search for files using the search box in the top right corner.

Running Dtella at Startup

This works on 10.4 (Tiger), 10.5 (Leopard), 10.6 (Snow Leopard), and 10.7 (Lion).

  1. Open System Preferences
  2. Go to Accounts
  3. Click the Login Items tab
  4. Click the [+] Button
  5. Add Dtella from your Applications folder and check the box that makes it hidden.


Download Problems

If you don't have a router or firewall, then make sure in Shakespeer's preferences that the Download folder and Incomplete folder options under the Share tab exist. In the latest versions of Shakespeer, they don't create the Incomplete folder for you; if this happens, you will not be able to download anything. The easiest way to tell if this is happening is if the icon for the Incomplete folder looks like a blank white page. The easiest way to fix it is to set the Incomplete folder to the same location as the Download folder.

Firewall/Router Configuration

If you have a firewall or router, you must forward a UDP port and a TCP port. The UDP port is how Dtella communicates with other nodes and is set using the
 !UDP <port> 
command in chat. The TCP port is used during file transfers and needs to be set in the Shakespeer settings. In Shakespeer, you only have the option of setting one port number for both TCP and UDP, therefore it MUST be different from the port you chose for Dtella. You only need to forward the Dtella UDP port and the Shakespeer port. OS X does have a built-in firewall, but this is disabled by default. If you turned it on, you need to allow Dtella and Shakespeer though it. If you have a router, see this guide: Router_Setup_Guide.

If you have any problems use the online IRC client to ask for help.