Change the Azureus2.jar file

From VuzeWiki
Jump to: navigation, search

This is a guide to change the Azureus2.jar file - this file essentially contains all of the main code for running Vuze (including the core engine and interfaces).

You can change this file to change to newer, and even older versions of Vuze. You may want to backup your configuration directory before you make changes.

  • Note: Changing Vuze versions can be easily done with the AZCVSUpdater plugin, which automates the download and installation of new CVS build versions, and the configuration backups can be easily handled with Vuze Configuration Backup plugin.


For Windows users[edit]

  • Download the JAR file you want to use.
  • Close Vuze if you have it running - once the program closes, give it a minute or so to make sure it properly closes.
  • Go to the directory you installed Vuze to, likely to be in c:\Program Files\Azureus or c:\Program Files\Vuze.

Az change jar 1.png

  • Rename the existing azureus2.jar file to something else - it might be a good idea to rename it to something which indicates what version it is.
    • Try to avoid calling it something with a jar file extension (as Vuze might get confused in finding two azureusXXX.jar files in the same directory).
    • Please note that many archiver programs can also handle jar files, so don't be surprised if the icon for the file is that of WinRAR, WinZip or whichever-favourite-archiver you are using. And as Windows hides the file extensions by default, make the extensions visible or otherwise make sure that you handle the correct jar file.

Az change jar 2.png

  • Move or copy the downloaded jar file into the program directory.

Az change jar 3.png

  • Rename the file to Azureus2.jar.

Az change jar 4.png

  • Once that's done, start Vuze and it should be running with the code in the new jar file you've just placed in the program directory. You can confirm that by looking at the status bar in the bottom left corner.

Az change jar 5.png

For Mac OS X users[edit]

If you are a Mac OS X user and wish to ugrade to the latest CVS snapshot:

There is a "ctrl" key located in between the "fn" key and the "alt" key.

  1. First, it is a very good idea to make backup copies of your Azureus folder in Applications, and most importantly also the Azureus file in Users/<username>/Library/Application Support/Azureus Save them under a name that is NOT Azureus, such as "az backup" or similar. This way you can go back to the previous working version if there are problems with the new one.
  2. Make sure Azureus is not running! Just "Quit" if it is.
  3. Download the Azureus2xxx-Bxx.jar file by going to http://dev.vuze.com/ and ctrl clicking on it, and select "Download Linked File As". (Or, download via .torrent file for better speed and reliability.)
  4. Save it in easy reach on the desktop, or in the Applications/Azureus folder, or wherever.
  5. Open the finder, go to Applications/Azureus/ (or wherever you installed Azureus to)
  6. ctrl-click (or right-mouse-button click) on the frog and select "Show Package Contents".
    • If you are using an Azureus.app prior to 2.3.0.0 or 2.3.0.6 and up: Go to Contents/Resources/Java/ folder and drag the previous Azureus2.jar file out to the trash.
    • If you are using an Azureus.app 2.3.0.0 to 2.3.0.4: Open the folder "Contents", ctrl-click on "Azureus" (yes, another frog in the new structure) and select "Show Package Contents" again and then go finally to Contents/Resources/Java/ folder and drag the previous Azureus2.jar file out to the trash.
  7. Drag the new Azureus2-Bxx.jar file into the same location location you removed the old one from.
  8. Rename it to Azureus2.jar
  9. Close the finder, and run Azureus.
  10. That's it.


This can also be done from Terminal, by going to

  • (if you are using an Azureus.app prior to 2.3.0.0 or 2.3.0.6 and up) /Applications/Azureus.app/Resources/Java/ and deleting Azureus2.jar and moving the new one on the desktop to that location. And renaming the new one, of course. :)
  • (if you are using an Azureus.app 2.3.0.0 to 2.3.0.4) /Applications/Azureus.app/Contents/Azureus.app/Contents/Resources/Java/ and deleting Azureus2.jar and moving the new one on the desktop to that location. And renaming the new one, of course. :)


Ubuntu and other Linux variants[edit]

The location and exact name of the Azureus2.jar in various Linux distribution versions. You need to find where the Azureus2.jar file is located and then to replace it.

For example, in Ubuntu 11.04 the file is called Azureus2.jar and is located at /usr/share/java