Page 1 of 2 12 LastLast
Results 1 to 10 of 14

Thread: how to: Azureus/AzSMRC bittorrent for the home network

  1. #1
    Join Date
    Dec 2007

    how to: Azureus/AzSMRC bittorrent for the home network

    How To
    Ubuntu for the Live Music Downloader/collector

    Part 3: Set up Azureus/AzSMRC on a Home Network

    This tutorial is Part 3 of a series on setting up Ubuntu for live music downloading, in Part 1 we set up the music player to play flac, shn, mp3 etc, Part 2 covered setting up Azureus as the bittorrent client. The next step is to share bittorrent over the network so we don't have to install Azureus on all our network computers and end up with music files scattered over multiple computers. In Part 3 I am going to show you how to do this the super easy way first then the slightly more complicated (but very powerful) method using a great Azureus plug in called AzSMRC.

    One nice feature of Azureus is that it is written in Java so we can use Azureus on Windows, Linux and even Macs. For example I have 4 computers on my home network: a Linux server running Ubuntu, a Ubuntu box in my media room, a laptop for work running Windows XP and my wife's Mac. I set up Azureus on my Ubuntu server and all the other computers are set up as clients. If you think Azureus is a resource hog, think about the resources required to run Azureus over a network – it's pretty low when you spread it across multiple computers.

    There is a very simple method for sharing bittorrent over a network using Azureus and the best part is, if you have Azureus installed you are done – all you have to do is tweak a few settings in Azureus – can't get much easier than that! For the purpose of this HowTo let's assume we have Samba set up to share our home directory. In order to share bittorrents we are going to set up a folder in our home directory for torrent files and tell Azureus to monitor this directory at specific time intervals and download any show when a new torrent file (the torrent file is not the music file but the file the tracker uses) is added to the directory. Then all we have to do from any computer on our network is access the shared folder through Samba (could be ssh, ftp or any share), download the torrent file to our folder and sit back and let Azureus do the rest. Azureus will see the torrent and automatically download the show from the tracker. You can even set up Azureus to notify you when the show is completed, move the files to another folder once completed, categorize and lots more. Pretty slick! Doing it this way you don't even need bittorrent clients on each computer. So let’s try it!

    Setting up Azureus share folders:
    1. Open Azureus – if in Vuze go to view>advanced.
    2. In the advanced window go to tools>options>files>torrents. The screen below shows the dialog box.
    3. Click on “import new torrents automatically” and browse to your folder you set up for your shares.
    4. Set an interval for Azureus to check the folder.
    5. Save and you are done.

    Go here to see a screenshot
    HTML Code:
    To use this feature: download the torrent (not the music files) from a tracker web site and place it in the share folder you just set up – Azureus will do the rest. How simple is that!

    AzSMRC Plug-in For Azureus

    We could stop here (and you may want to) but it's nice to have more control over the downloads and to do that, Azureus has this great server/client plug in called AzSMRC. AzSMRC allows you to do more with Azureus and the developers are actively creating new plug-ins for AzSMRC. With AzSMRC you have:

    • Complete ability to manage torrents remotely
    • Manage hosting of torrents remotely
    • AzSMRC allows multiple users to use one running Azureus
    • WebUI: if you don't have the client installed you can simply use the WebUI to manage Azureus
    • View salient statistics about the Azureus server and also be able to restart the server at the touch of a button
    • Remotely administer Azureus updates
    • AzSMRC can update itself as well as report to the developers any crashes it detects
    • Plugins: you can extend the AzSMRC client like Azureus with plugins and much more

    For example, you can set up AzSMRC to have complete control over the download parameters such as the folder to download to, moving the files once the download is completed, uploading a torrent for sharing and many more features. This is the advantage of using AzSMRC – you have complete control and access to all the features of Azureus.
    [*]There are other ways to share Azureus over the network (Swing UI, HTML, XML over HTTP) and I have tried them all and I like AzSMRC. You may want to check out the others and see which fits your needs though.

    Installing AzSMRC in Ubuntu


    If you have been following this HowTo series, you should have Sun Java6-jre installed already. If not, install the Ubunut Restricted Extras and Sun JAva6-jre will be installed. The Sun-java-6jdk also needs to be installed if you plan to use ssl security but it is not necessary to preinstall at this time. You can install it later when you set up AzSMRC for ssl. Instructions for installing are included below.

    Installing the AzSMRC server plugin from Azureus:
    1. Open Azureus.
    2. Go to “Advanced” view
    3. On the menu go to plugins>installation wizard>by list from
    4. Follow the prompts to install the AzSMRC plugin
    5. If you are going to use ssl security then you must set that up in Azureus also.
    6. Restart Azureus after the plugin finishes installing to set up the AzSMRC plug-in (see below).

      AzSMRC uses different ports than Azurues (the default port is 49009) so make sure you have the port forwarded. If not go to
      HTML Code:
      and follow the instructions for your router. Also, set any firewalls to allow AzSMRC.

    That’s it

    If you are feeling adventurous you can install the Azsmrc plugin from the source files.
    1. Go to the AzSMRC web site
      HTML Code:
    2. Download the installation notes so you can refer to them when needed.
    3. On the AzSMRC home page go to “downloads (it takes you here (
    4. Download the following from the AzSMRC (platform independent zip) (platform independent zip)
      (Download both files to to the desktop)
    5. Locate the Azureus plug-in folder /opt/azureus/plugins (note: this is not the plug in folder in /home/.azureus) and create a folder called AzSMRC (now you have /opt/azureus/plugin/AzSMRC/)
    6. Extract the entire contents of the into the /opt/azureus/plugin/AzSMRC folder
    7. Also, extract the entire contents of the folder into /opt/azureus/plugin/AzSMRC folder.
    8. Follow the instructions below for setting up AzSMRC in Azureus and ssl security.

    That’s it – you’re done with the installation of the AzSMRC server plug-in. Now we need to set up the AzSMRC server settings in Azureus and the AzSMRC clients on our other network computers.

    Setting up AzSMRC plug in in Azureus:
    Now that we have AzSMRC plugin installed in Azureus we need to format it for users.
    1. Start Azuerus, go to plugin menu>AzSMRC
    2. The first time you start AzSMRC a wizard will appear and walk you through the set up.
    3. Once done you can log into AzSMRC.
    4. The default port is 49009 so make sure your router is set up for port forwarding (see above). You can also change the port but if you do, remember to change it in the client also and to forward the new port in your router.
    5. Go to >Tools->Options->Plugins->AzSMRC
    6. You have the option to install the SSL encryption for added security (this is highly recommended). Remember you need Sun-java6-jdk installed to do this (see above).
    7. To create an SSL certificate go to the security tab (Tools->Options->Security) and create a certificate.
    8. You will need the tools.jar file distributed in the Java SDK. Azuerus normally finds it for you if you have Sun-java6-jdk installed but if for some reason it does not then you must point Azuerus to the file. In most Ubuntu installs it is located in usr/lib/jvm/java-6-sun-
    9. Enable SSL in AzSMRC settings and restart Azureus. Don't forget to enable SSL in the client too.

    To start AzSMRC the first time:
    1. On the Azureus menu go to plugins>AzSMRC.
    2. The default username: admin and password: AzSMRC.. It is highly recommended to change this password. You can change this from the preferences in the AzSMRC screen.
    3. Once in the AzSMRC screen you can set up new users and other options for connecting.
    4. You will also want to set up the folders AzSMRC uses for saving files in.

    Once you have a user set up you can change the properties for the user by right clicking on the user name in the AzSMRC screen. As the administrator you control client access and how each client can view all the active bittorrents in Azureus. If you will only be using 1 client at a time then all you need is 1 user. If you have more than 1 client open or if you want to restrict certain features for one client then set up multiple users. For example, you may want to do this if say you are a college student and your roommates have AzSMRC tapping into your computer (Azureus is set up on your computer as a server) but you don't want your roommate to be able to control Azureus. Set them up as a user and set the functions accordingly. This is why AzSMRC has advantages over just setting up a share folder (as above) – you have a lot more control.

    Now that we have the server set up we need to set up the client on all our network computers.

    Set up AzSMRC client on Windows (I know this tutorial is for Linux but most people have at least 1 Windows computer on there network so I decided to go ahead and throw this in).
    1. Download the Windows.exe files and install as you do any program in Windows.

    Installing the Client in Ubuntu Gutsy from source
    1. Go to Sourceforge
      HTML Code:
    2. Download AzSMRC remote control - (i386)
    3. You will also need the latest swt.jar file from Eclipse to replace the older swt.jar file in the downloaded folder. Download from Eclipse:
      HTML Code:
    4. Again, make sure you have sun SunJava6-jre installed and working.
    5. Create a new folder in the Home directory called azsmrc (/Home/azsmrc).
      $ mkdir aszmrc
    6. Extract all the files from the folder to the /Home/azsmrc folder
    7. Extract swt.jar from the to the /Home/azsmrc folder.
    8. Close the folder

    This screeenshot shows the files you should now have in (/Home/azsmrc) folder:

    HTML Code:
    This is the list of files that should now be in ?Home/azsmrc folder
    AzSMRC.exe (note this is a windows .exe file not a Linux file - you can delete this or leave it in it's up to you - either way
    is OK)

    Starting AzSMRC:

    1. Open a terminal and change directories to azsmrc
      cozmicharlie@hpubuntu2:~$ cd /Home/azsmrc
    2. Type the following at the prompt
      java -classpath launcher.jar  -Djava.library.path=.
    3. The set up Wizard will launch and walk you through the install – for most of the parameters I just accept the defaults.
    4. Before you connect, make sure the port is the same port used for the AzSMRC server (49009 is the default) and make sure your ports are forwarded. If not go to
    5. If you enabled ssl encrypted communication (highly recommended) in the Azureus plug in make sure and enable it in the client also.

    Set up the launcher in the menu
    To do this we have to write a script, make it executable and add it to the menu.
    ** Note - see change in script added 1-3-10. Change the script to the one at the bottom of the post if torrent files have spaces (most do) - see post #11 from kapcom01.
    1. Open a terminal and create a new directory in the Home folder:
      mkdir ~/bin
      cd ~/bin
    2. Leave the terminal open.
    3. Open a text editor (any text editor - I use the text editor from the applications menu). In the text editor type (or cut and paste) these 3 lines:
      cd $HOME/AzSMRC
      if [ "$1" != "" ]; then




      java -classpath launcher.jar:/usr/local/lib -Djava.library.path=. $parm
    4. Name the script something like "azsmirk" and save it to the bin folder you created above.
    5. Now we need to change the mode: Go back to the terminal that you left open and at ~/bin prompt type or cut and paste:
      chmod +x azsmirk
      Now the script should be executable (you can check by right clicking>properties>permissions).
    6. To add it to the menu, right click Applications on the panel>edit menus> under menus click internet (or wherever you want it added)> click anywhere in the “show” “item” box > click new item and the create launcher dialog box should open.
    7. Type the following:

    Type: Applications
    Name: AzSMRC
    command: browse to the script you created aboveand add it
    comment: peer to peer distribution tool
    This is optional: go to the /opt/azureus folder and drag the frog to icon or double click the “icon” in the box and browse to the frog.

    To set up Azsmrc as the default bittorrent in Firefox:
    1. Open FF
    2. Find a torrent file and click on it to download. The download dialog box will open.
    3. At the "Open with" go to "Other"
    4. Point it to the script you wrote above and mark "do this automatically for files like this from now on".
    5. Click OK

    Now any time you download a torrent Azsmrc will automatically start up.
    ** Thanks to SoonerCentral for providing the start up script and this tip.

    Setting up the Azurues/AzSMRC server and client
    1. Start Azureus.
    2. Go to tools>plugins>AzSMRC and open AzSMRC.
    3. Log on to azmrc using the default username and password:
      username: admin password: AzSMRC
    4. Go to Preferences and set up AzSMRC how ever you prefer. This is where you set up users, passwords and other preferences in AzSMRC.

    Set up the client:
    1. Start the client on a different computer (no need to have Azureus and AzSMRC client on the same computer).
    2. A dialog box should come up if not go to the “connect” icon and click on it to bring up the dialog box.
      Server or IP: type in you server IP
    3. Make sure the port is set to the port you have forwarded in you router (49009
    is default)
  2. Type in the username and password you set up in the AzSMRC server
  3. If you set up for secure connection then click the box
  4. Hit connect and you should see a dialog in the lower left that will inform you that you are “connected” or not.

What to do if you cannot connect:
Make sure the AzSMRC port is forwarded in your router
Make sure you have the correct IP (remember this is the IP for the server not the client computer)
Check any firewalls.
An incorrect ssl setting.
Most all problems with connecting are due to one of the above.

Download a music file using AzSMRC:

Now that we are set up lets down load a music file and test it out. What should we listen too? – how about a little New Orleans funk with Dr John opening for the Grateful Dead 2-16-88 at the Kaiser Convention Center in Oakland.

In AzSMRC you need the torrent file so AzSMRC client can send the data to AzSMRC server. You can download using AzSMRC by:
  1. Setting up your browser to default to AzSMRC for torrent files.
  2. Download the torrent to a local folder on the computer.
  3. AddByURL

Let’s walk through this – it is not as difficult as it sounds.

Downloading music files from AzSMRC:

Setting AzSMRC up as default bittorrent in the browser:
  1. Start AzSMRC
  2. Sign into AzSMRC and connect to the server.
  3. Go to the web tracker where the show is listed. In my example it is Lossless Legs
    HTML Code:
  4. Go to the torrent file (see the screen shot- the torrent is not the music file it is a file the tracker uses).
    HTML Code:
  5. Click the torrent file and the download dialog pops up.

The first time you do this it will default to bittorrent**.

** How to set up to use AzSMRC as the default is different for each browser. Firefox has a dialog box that asks you if you want to do this for these types of file. Just mark yes and each time you click on a torrent file it will default to AzSMRC. You can also set it up in preferences. Most browsers allow you to set it up in Preferences.

Download the torrent file to a local folder and point AzSMRC to the torrent file
  1. Double click the torrent file (the torrent file is not the music files but the file the tracker uses).
  2. In the dialog box select “save to disk” and select the folder you want to use to store the saved torrent files (I use home/cozmicharlie>AzSMRC-shares).
  3. Download the torrent file into your selected folder.
  4. In AzSMRC click on the icon for “add a torrent from a local file”. Or;
  5. in the menu go to the Remote>Send torrent to server
  6. Browse to the downloaded torrent file, select it and “OK”.
  7. You should see the torrent in the download queue.
  8. Now it will download to the server in the folder you specified when you set up AzSMRC.

Downloading using the AddByURL:
  1. Add the url for the torrent into the server.
  2. You must have clipboard monitoring enabled in the preferences.
  3. Click the icon to “AddByurl and write the url address in the dialog box. Or;
  4. Go to the menu Remote>Send torrent url to server.

Thats it – in a few minutes we should be listening to this great Dr John show. AzSMRC and Azureus have a large number of plug ins and options - check out the Azureus Wiki and fool around with different configurations to your hearts content. Most of all - have fun.

Cozmic Charlie

In part 4 we will show how to set up for decoding/encoding and tagging music files in Ubuntu, the programs covered will be SoundKonverter, PACPL, Nautilus Audio scripts and Xfalso.

Edit 8-9-08 - changed AzSMRC client install folder to /Home/azsmrc. Corrects permission problems.

Edit 1-3-10 - If the torrent file contains spaces you must modify the start up script to this thanks to Kapcom01 for pointing this out and contributing the script
** change script to this one if torrent files have spaces.

cd /usr/share/azsmrc

if [ "$1" != "" ]; then


java -classpath launcher.jar -Djava.library.path=. "$parm"


java -classpath launcher.jar -Djava.library.path=.

Last edited by cozmicharlie; January 6th, 2010 at 11:45 PM. Reason: Change script to account for spaces in torrent files
Advanced reply Adv Reply  

  • #2
    Join Date
    Jan 2008

    Re: how to: Azureus/AzSMRC bittorrent for the home network

    Great guide but I got up to making the AzSMRC launcher and I noticed you have a error there.

    Upon making the launcher nothing happens.

    Looking at the terminal output saids 'command not found'

    Could you update this guide with the correct info on making the launcher.

    Everything up to the launcher works I was able to load the app and set it up.

  • #3
    Join Date
    Dec 2007

    Re: how to: Azureus/AzSMRC bittorrent for the home network

    I will check it out and correct the guide - thank you for pointing this out.

    Quote Originally Posted by Revenger View Post
    Great guide but I got up to making the AzSMRC launcher and I noticed you have a error there.

    Upon making the launcher nothing happens.

    Looking at the terminal output saids 'command not found'

    Could you update this guide with the correct info on making the launcher.

    Everything up to the launcher works I was able to load the app and set it up.

  • #4
    Join Date
    Dec 2007

    Re: how to: Azureus/AzSMRC bittorrent for the home network

    The guide has been corrected and a script added so you can create a launcher. Thanks to Revenger for pointing this out and helping to test the script.

  • #5
    Join Date
    Nov 2005
    Ubuntu Breezy 5.10

    Re: how to: Azureus/AzSMRC bittorrent for the home network

    This looks like a great tutorial. I'd love to read parts 1 and 2 but can't find them anywhere. Could you repost please?


  • #6
    Join Date
    Dec 2007

    Re: how to: Azureus/AzSMRC bittorrent for the home network

    Quote Originally Posted by Carnwaj View Post
    This looks like a great tutorial. I'd love to read parts 1 and 2 but can't find them anywhere. Could you repost please?

    Glad it helped. I should change the post because I have part 1 posted here ( which is now an abandoned site but it is still there and part 2 was rejected by the Ubuntu forum mods because they said there was already tutorials on Azureus. I will attach though to the post in a few days - I have to check it to make sure it is still accurate.

  • #7
    Join Date
    Apr 2006

    Re: how to: Azureus/AzSMRC bittorrent for the home network

    Thanks great howto. Wow AzSMRC creates real new ways for using Azureus! It works perfect when i connect without ssl. But when i try with ssl i run into trouble. I also posted on the AzSMRC site (here: ) , but maybe this is ubuntu related, so that is why i also reply here.

    When i try to make a connection over ssl, the clients says: Server doesn't support SSL. But when i type https://###########:49009 in firefox, i can take a look at the certificate that is issued by the server, Also I'm already using the webui plugin with ssl. So i guess there is nothing wrong on the server side. (######## edited out for security reasons)

    This is with the latest Azureus in xubuntu Hardy 8.04. Azureus was installed with a simple apt-get install azureus from he repos. On the client side i am using Ubuntu Hardy.

    Does anyone have a idea what is going wrong here and how to fix it?

    This is the terminal output from the client, when i try to connect with a server:

    DEBUG [Thread-6] ( - Connection State: 1
    DEBUG [Thread-6] ( - Trusting Certificate: https://###########:49009/process.cgi /opt/AzSMRC/.certs (Permission denied)
    at Method)
    at<init>(FileOutputStream.j ava:179)
    at<init>(FileOutputStream.j ava:70)
    at lbms.azsmrc.remote.client.SESecurityManager.addCer tToTrustStore(
    at lbms.azsmrc.remote.client.SESecurityManager.instal lServerCertificates(
    at lbms.azsmrc.remote.client.Client.sendHttpRequest(C
    at lbms.azsmrc.remote.client.Client.access$7(Client.j ava:272)
    at lbms.azsmrc.remote.client.Client$ :256)
    DEBUG [Thread-6] ( - Connection State: -1
    WARN [Thread-6] ( - Connection failed 1 times, delay: 30sec
    DEBUG [Thread-6] ( - Changing Timer: GUI mode
    DEBUG [Thread-6] ( - Disconnect!
    DEBUG [Thread-6] ( - Connection State: 0

    (SWT:7692): Gtk-WARNING **: gtk_widget_size_allocate(): attempt to allocate widget with width 250 and height -1
    ERROR [Thread-6] ( - Connection Error: Server doesn't support SSL. PKIX path building failed: xception: unable to find valid certification path to requested target
    at n(
    at erCertificate(
    at essMessage(
    at p(
    at cord(
    at ord(
    at InitialHandshake(
    at ndshake(
    at ndshake(
    at lbms.azsmrc.remote.client.Client.sendHttpRequest(C
    at lbms.azsmrc.remote.client.Client.access$7(Client.j ava:272)
    at lbms.azsmrc.remote.client.Client$ :256)
    Caused by: PKIX path building failed: xception: unable to find valid certification path to requested target
    at e(
    at validate(
    at checkServerTrusted(
    at checkServerTrusted(
    at erCertificate(
    ... 15 more
    Caused by: xception: unable to find valid certification path to requested target
    at engineBuild(
    ... 21 more

  • #8
    Join Date
    Dec 2007

    Re: how to: Azureus/AzSMRC bittorrent for the home network

    Glad you are enjoying Azsmrc. Let's see if we can get the ssl working for you. Did you set up the ssl in both the plug in and the client? The instructions are in the tutorial in the section entitled "Setting up AzSMRC plug in Azureus:". You have to be sure and turn on ssl in both Azuereus and in the Azsmrc client. The tricky part is making sure you point Azureus to the "tools.jar" file. Based on your output it appears the problem is with Azureus so make sure you have ssl in Azureus set up properly. I'm using Azsmrc in Hardy with ssl so it should work for you.

  • #9
    Join Date
    Apr 2006

    Re: how to: Azureus/AzSMRC bittorrent for the home network

    Thanks for your fast reply cozmicharlie. From the log you can see that there seems to be a permission problem: /opt/AzSMRC/.certs (Permission denied)

    That's why I reinstalled the client in my /home folder and ran it from there. This fixed it!

    I noticed that on the server side AzSMRC is also installed in my /home folder (.azureus/plugins/) So i guess in my setup running AzSMRC from a root directory was not a smart thing to do.

    Correct me if i'm wrong, but i guess you installed azureus from source and that is why the plugin was working for you from /opt/AzSMRC. I installed azureus with a simple apt-get install in Hardy and installed the plugin from Azureus.

    Maybe this is something to add to the howto, because i guess other people will have the same problem as i had.

  • #10
    Join Date
    Dec 2007

    Re: how to: Azureus/AzSMRC bittorrent for the home network

    Generally you don't want Bittorrent running from the root. Yes, you are correct I installed from source into /opt/. Permissions are always a bit tricky especially if you come from Windows like I did (and most people). I will add something to the tutorial to try and clarify that for people. Thanks for the input and I am glad it worked out for you.

  • Page 1 of 2 12 LastLast


    Posting Permissions

    • You may not post new threads
    • You may not post replies
    • You may not post attachments
    • You may not edit your posts