Sunday, December 14, 2008

Integrating Vuze (formerly Azureus) with Gnome desktop

Here are a few techniques for integrating Vuze (formerly Azureus) with the Gnome desktop. It worked for Vuze 4.0.0.2 and 4.0.0.4 on Gnome on ubuntu 8.04.1.

To populate Applications->Internet with a Vuze entry
System, Preferences, Main Menu, Internet (in left pane), New Item
Name: Vuze
Command: /opt/vuze/vuze (or wherever you put it)
Comment: (whatever you like)

To give this entry the Vuze icon
Edit ~/.local/share/applications/alacarte-made.desktop, changing the Icon= line:

[Desktop Entry]
Encoding=UTF-8
Version=1.0
Type=Application
Terminal=false
Icon[en_IN]=gnome-panel-launcher
Name[en_IN]=Vuze
Exec=/opt/vuze/vuze
Name=Vuze
Icon=/opt/vuze/vuze.png


The first line is empty, that's how the file is created by Gnome; it may or may not be important.

The icon change is not effective immediately. It is effective after ubuntu restart, probably after log off and on. To test the change: Preferences->Main Menu->Internet.

To create a launcher on the desktop (with the Vuze icon)
Applications->Internet and right click on Vuze then choose "Add this launcher to desktop".

To create a MIME type association (so clicking on a .torrent file opens Vuze)
Create ~/.mailcap:

###############################################################################
#
# MIME types and programs that process those types
#
# Users can add their own rules if they wish by creating a ".mailcap"
# file in their home directory. Entries included there will take
# precedence over /etc/mailcap
#
# The man page for update-mime(8) describes the fields
#
###############################################################################

application/x-bittorrent; /opt/vuze/vuze '%s'; description="BitTorrent client"; test=test -n "$DISPLAY"

I'm only guessing that Vuze is X-aware; if not the test= section is useless but doesn't do any harm. If you want to make this MIME type association for all users, modify /etc/mailcap instead.

To configure Firefox (3.0.3) to feed .torrent files to Vuze
Edit, Preferences, Applications
Content type: Bit torrent seed file
Use other
Browse to /opt/vuze/vuze (wherever you put it)

To start Vuze when starting a desktop session
This requires System->Control Centre which is not available by default. It can be configured by System->Preferences->Main Menu->System and selecting Control Centre.

System->Control Centre->(Personal) Sessions->Startup Programs->Add
Name: Vuze
Command: /opt/vuze/vuze (wherever you put it)
Comment: Starts Vuze BitTorrent client

No comments: