Vuze

Vuze (formerly Azureus) is a free Java-based BitTorrent client.

Preparation
First you need to check which version of Java you are currently using. Even though you may have installed a newer version of Java, your computer may still be using an old, pre-1.6 environment. Check to see which version you are using using java-config:

The entry with the * next to it indicates which environment you are using. Make sure (as of 10 July 2009) that you are using at least version 1.6.0.13 of the Sun JDK [sun-jdk-1.6]

If there is an older entry that is selected, select the new environment you will need to use:

(Replace N with the number next to the option you want.)

Installation
Now you are ready to emerge Vuze:

Now you should be able to run Vuze without problems. If you are running Xorg, the following command will start the GUI interface.

CLI Usage
Fortunately, it's not necessary to run the GUI version of Vuze.

When running Vuze the first time, it creates the directory under your home directory. Inside this directory are several files needed for normal usage, plus directories that might be of interest later. Inside the directory, there is a file named. If you will be running Vuze from the command line, there is an option you will need to change inside :

Now you will be able to run vuze from a console or terminal window.

Environment Setup

 * 1) Create a user and group for vuze to run as:
 * 2) Create the home directory:
 * 3) Clean things up a little bit by making a symbolic link:
 * 4) Configure vuze to run without a GUI (see above)
 * 5) Set appropriate permissions
 * 6) Create pidfile (optional)
 * 1) Configure vuze to run without a GUI (see above)
 * 2) Set appropriate permissions
 * 3) Create pidfile (optional)
 * 1) Create pidfile (optional)
 * 1) Create pidfile (optional)

Configuration
It may be necessary to gain interactive access to the Vuze console. This can be done by substituting the user for the Vuze user and running the Vuze start script. Console configuration commands can be entered here. When finished use the quit command to exit Vuze cleanly and ensure that the configuration was saved.

Init Script

 * Make it executable


 * Start the daemon

Vuze Daemon (Screen)
Vuze will run into a virtual console (named vuze_screen). You can attach to this console while the "service" is running with this command:

When you tell the init script to stop, the command "quit" will be sent into the virtual console.


 * Make sure you have screen installed (emerge screen)
 * Add a new user named vuze and create default home directory


 * Edit to make it start in console mode
 * Try to start vuze from here and fix any errors that come up
 * Create init script


 * Start the daemon

AzHTMLWebUI
AzHTMLWebUI is a remote interface for Vuze with the ability to upload and control your torrents over an HTML interface.

Installation
Installing AzHTMLWebUI is fairly easy. First you need to download the .jar file from here: AzHTMLWebUI Download

Make a new directory within the /var/lib/vuze/.azureus/plugins directory named [ azhtmlwebui ]

Move the azhtmlwebui_###.jar file you downloaded to the .azureus/plugins/azhtmlwebui directory.

Vuze should now load and automatically use the plugin. To test whether AzHTMLWebUI is working, go to http://your-ip-address:6886 in your internet browser. You should now have a web interface where you can see your downloads, uploads, and completed torrents.

Configuration
There are a few things you might want to look at when you first start up your server. When you start it up from the command line, you won't have a prompt telling you that you can log in - first it will print out several lines of information, and then a brief list of available commands, followed by a blank prompt. This is where you can type in commands.

? - This will give you a list of every command you can use with Vuze.

set - Allows you to set parameters to a list of numerous options. We will be using this for the next few commands.

All the following commands will be run under the Vuze interface on the server.

Upload
First of all, to enable uploading from AzHTMLWebUI's interface, you will need to set this option:

set "Use default data dir" 1 > Parameter 'Use default data dir' set to '1'. [int]

This will allow you to upload torrents to the server from the AzHTMLWebUI interface.

To change where Vuze saves your currently downloading and finished downloads, type:

set "General_sDefaultSave_Directory" "path/where/you/want/to/save/your/downloaded/files" > Parameter 'General_sDefaultSave_Directory' set to'' 'path/where/you/want/to/save/your/downloaded/files'. ''[string]

Permissions
Setting the Username

set Plugin.azhtmlwebui.User admin_username_that_you_want > Parameter 'Plugin.azhtmlwebui.User' set to 'admin_username_that_you_want'. [string]

Setting the Password

set Plugin.azhtmlwebui.Password mypassword password > Parameter 'Plugin.azhtmlwebui.Password' set to 'mypassword'. [password]

Getting it all to work

set "Plugin.azhtmlwebui.Password Enable" 1 > Parameter 'Plugin.azhtmlwebui.Password Enable' set to '1'. [int]

Connectivity
To change the port

set Plugin.azhtmlwebui.Port 6886 > Parameter 'Plugin.azhtmlwebui.Port' set to '6886'. [int]

If you are using a firewall such as iptables, you may need to make the corresponding changes to open that port.

SSL
To use SSL you need to create a certificate. This can be done with keytool:

You also need to set the protocol option:

set Plugin.azhtmlwebui.Protocol HTTPS > Parameter 'Plugin.azhtmlwebui.Protocol' set to 'HTTPS'. [string]

Of course, after this change the web interface will no longer be accessible as you first did; it will now be accessible from https://your-ip-address:6886/.

You must restart Vuze for the changes to take effect.