Personal tools

Dtella:Installation Guide for Linux

From Dtella Wiki

Jump to: navigation, search

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

Contents

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:

tar xvf [name of archive]

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.

Start dtella.py by running

python ~/.dtella/dtella.py

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.

Configuring dtella and clients

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. (This client is also available for most distributions as "linuxdcpp". Install the same way you installed the libraries in the first step.)

There are many other dc clients available besides linuxdcpp

Configuring the DC client

The dtella package you downloaded earlier acts as an intermediary between you and the dtella network. This is what the client will connect to.

Server Name: Dtella
Server Address: 127.0.0.1:7314
Server Password: <none>

This is how a connection is configured in linuxdcpp:

  1. File -> Preferences -> Personal. Put your desired username here.
  2. Click the "Connections" tab. Select "Manual port forwarding."
  3. Enter "localhost" under the "Public IP Address" field.
  4. Enter 1555 for the TCP port, and 1666 for the UDP port. (These can technically be anything, but we will use this ports for consistency with other tutorials.)
  5. Click the "Sharing" tab. Add any folders you wish to share on dtella to this section. IMPORTANT You must share at least 5GB to be able to download files from other users (and 500GB if downloading from magikarp).
  6. Click on "Advanced" tab. Uncheck "Enable segmenting downloads."
  7. Click ok to save your settings.
  8. Click Favorite Hubs -> Add
  9. Enter "dtella" for Name and "localhost:7314" for Hub Address. Fill out the Nick you used earlier. Check "Auto Connect" and click OK

Restart your client. It may take some time before you can download files from others. This is because your client is hashing (i.e. counting up the size of the directories you shared). Allow a few minutes for this, and then restart once more. You should now be connected to the dtella network.

At this point, you will have to manually run dtella.py as well as linuxdcpp. See the next section for making these two steps run automatically as a script.

Running Dtella on Startup

Now we will create a script that launches both dtella.py and linuxdcpp.

sudo gedit dtella_start

After opening the file paste the following two lines of code into the file:

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

After pasting, save the file. You will then need to make the file executable using the command (you may need administrative privileges to do this):

chmod +x dtella_start

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_start
  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:
cp /home/<username>/dtella_start ~/.kde/Autostart/

External Links