How to Install Plugins in Deluge 0.5.1 BitTorrent Client

Getting tired of the simplicity of the original BitTorrent UI and the memory-hogging of Java-based Azureus, I recently turned to Deluge. According to Wiktionary, deluge is (paraphrased):

  1. A great flood or rain.
  2. An overwhelming amount of something
  3. The Deluge: The Biblical flood during the time of Noah.
  4. (transitive) To flood with water.
  5. (transitive) To overwhelm.

It also happens to be a handy, well-featured and good-looking BitTorrent client for Linux. However, since it is still in beta, there is naturally faulty documentation and some other problems. It worked great from scratch, but then I decided that I wanted to divide my torrents into two categorieschecked out and not checked out. The announced Categorize plugin seemed optimal for this purpose, and thus, I proceeded to download it from the Plugins page of the Deluge wiki:

$ cd ~
$ wget

I opened the tarball and found three files:

$ tar xzf categorize.tar.gz
$ ls

Unable to find instructions on how to install the plugin, I did an slocate to find the other plugins. That file seemed pretty generic, so I searched for others.

$ sudo slocate -u
$ slocate

Evidently, the files should be placed in /usr/share/deluge/plugins. So I did:

$ cd /usr/share/deluge/plugins
$ sudo tar xzf ~/Desktop/categorize.tar.gz

However, starting Deluge failed. I tried starting it from the command line in order to find the problem, and the verbose output helped a lot.

$ delugeno existing Deluge session
Starting new Deluge session...
deluge_core; using libtorrent Compiled with NDEBUG value: 1
Applying preferences
Pickling state...
Scanning plugin dir /usr/share/deluge/plugins
Loading module HelloWorld
Initialising plugin HelloWorld
Loading module TorrentCreator
Initialising plugin TorrentCreator
Loading module NetworkGraph
Initialising plugin NetworkGraph
Loading module ExamplePlugin
Initialising plugin ExamplePlugin
Loading module NetworkHealth
Initialising plugin NetworkHealth
Loading module TorrentSearch
Initialising plugin TorrentSearch
Traceback (most recent call last):
  File "/usr/bin/deluge", line 83, in <module>
  File "/usr/bin/deluge", line 57, in start_deluge
    interface = deluge.interface.DelugeGTK()
  File "/usr/lib/python2.5/site-packages/deluge/", line 54, in __init__
  File "/usr/lib/python2.5/site-packages/deluge/", line 44, in scan_for_plugins
    if '' in os.listdir(path):
OSError: [Errno 20] Not a directory: '/usr/share/deluge/plugins/categorize.jpg'

Deluge sees the image file categorize.jpg as a plugin folder. Remove it:

$ sudo rm /usr/share/deluge/plugins/categorize.jpg

and it should work. This was done on Ubuntu 7.04 Feisty Fawn with Deluge 0.5.1, installed through apt-get.