Dtella:Installation 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 3 External Links

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 [www.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.

Note that you cannot run Dtella from fat, ntfs partitions, nor from samba or shared folders in a Virtual Machine. Windows file systems do not discriminate between cases, and due to some files being named the same as modules - save for capitals - python becomes confused and attempts to load the wrong files.

Notes

Linux DC Clients

If you don't already have a DC client you will need to install one. One tutorial for installing LinuxDC++ can be found here.

• 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

External Links

• HOWTO: Install LinuxDC++ on Ubuntu