UMD:Setup Guide For Linux

An easy guide to installing and working with Dtella on a Linux installation.

Contents 1 Installing Dtella on Linux 1.1 Prerequisites 1.2 Install Dtella 2 Notes 2.1 Linux DC Clients 2.2 Running Dtella on Startup 2.2.1 Gnome 2.2.2 KDE

Installing Dtella on Linux

Prerequisites

• You must first install Python (version >= 2.4), Twisted Libraries, and PyCrypto Libraries to run Dtella. You have the following choices to install python and the required libraries on your respected distribution.
  • If using Gentoo run

    emerge twisted twisted-names pycrypto

  • If using a Debian based distribution such as Ubuntu use

    apt-get install python python-twisted python-crypto

  • If using a Fedora based distribution which supports yum use

    yum install python python-twisted python-crypto

  • If using a Suse based distribution use

    yast2 -i python-twisted python-crypto

  • If you want to install python from source Grab the sources from [http://www.python.org/download/] and install it yourself also you will need to install twisted from [http://twistedmatrix.com] and pycrypto from [http://sourceforge.net].

Install Dtella

Grab the latest release from http://umd.dtella.org Open up a terminal emulator and cd to the directory where you downloaded the tar.bz2 file and the uncompress it with the command:

bunzip2 -c <name of archive> | tar xvf -

The command should spit out the names of all of the files being extracted. The command should create a folder called dtella-purdue-X.X.X in the directory you extracted the archive in. You need to issue the following commands while substituting <extracted folder> with it's actual directory:

mkdir ~/.dtella
mv <extracted folder>/* ~/.dtella

This will move the contents of Dtella into a new hidden file called .dtella that way it doesn't show up in a normal ls or file manager so it doesn't clutter your home directory. Now we will need to create a script that you can run in order to start Dtella. So issue the following command:

sudo gedit dtella

If you are using KDE you will want to replace gedit with kate. After opening the file paste the following two lines of code into the file:

#!/bin/bash
python ~/.dtella/dtella.py &

After pasting, save the file. You will then need to make the file executable using the command:

chmod +x dtella

Enter your password when prompted. So now whenever you want to connect to dtella you must open up a terminal and type:

./dtella

It will then load for a second and then say it is listening on port 7314. You can now delete any leftover files that you downloaded.

Notes

Linux DC Clients

If you don't already have a DC client you will need to install one.

• LDCC Console based direct connect client.
• Linux DC++ A project to port the DC++ direct connect client to Linux.
• Valknut QT based direct connect client.
• Asami DC DC client written in Ruby for Gnome.
• Chiyo Another DC client for Gnome.
• DC-QT Another QT based DC client.

Running Dtella on Startup

You can remove your ~/dtella script after you get dtella to run on startup with one of the following methods.

Gnome

1. Go to System -> Preferences -> Sessions.
2. The Sessions Dialog will open. Click on the Startup Programs tab.
3. Click Add.
4. Another dialog will appear. In the textbox put the following code, replacing <username> with your username:

   python /home/<username>/.dtella/dtella.py

5. Click OK.
6. Click Close.

KDE

• Programs that you wish to autostart on KDE startup need to be placed into ~/.kde/Autostart.
• Open up a bash prompt and type:

cd ~/.kde/Autostart/
nano dtella

• In the file paste the following, typing Ctrl-O Enter Ctrl-X when finished:

#!/bin/bash
python ~/.dtella/dtella.py &

• Back at the prompt type:

chmod +x dtella