- Install Azureus/Vuze. Please follow product installation instructions published by the mentioner.
- Download current version of the plugin from http://www.mantlik.cz/tracker/torrents/osm4garmin.jar
- From Vuze menu select Plugin -> Installation Wizard… and check Installation method “by file”. Select downloaded osm4garmin.jar and proceed through all Wizard pages. When finished, Vuze will be restarted.
2. Setting up plugin options
After successful installation, new menu item in Plugins menu “OSM for Garmin updater” will appear. Selecting this menu item opens plugin configuration page:
First of all, select directory for saving maps and plugin work files. It is recommended to create a new folder using popup file dialog (click on the icon to the right of the directory field). If you already have some maps downloaded, copy them to this folder BEFORE starting download. The structure must exactly follow maps torrent structure, i.e. [download dir]/maps/[region]/gmapsupp.img .
As a next step, select region(s) you would like to download. You can select as many regions as you need. They will be downloaded sequentionaly from top to bottom.
If older version of the map file is present in the download folder and suitable diff torrent exists, plugin downloads much smaller diff file only and patches your old map to obtain newer version.
Finally, press the “Proceed!” button and maps download/update will start!
At any moment you can stop running download and change regions selection, but do not change content of your download directory if you do not know what are you doing.
Please do not forget to seed downloaded files in order to speed up overall cloud distribution performance for other users.
3. Advanced topics
Continuous instant update
If you check “Automatically repeat download every 24 hours” checkbox, plugin will contact the server every 24 hours and download new version of the maps torrent. If new maps are available, new download is started, i.e. your data are kept as fresh as possible instantly.
You can stop automatic update at any time by pressing the “Proceed!” button. If you press “Proceed!” again, new download starts immediatelly.
OSM for Garmin update plugin has it’s Log View window containing progress and error messages. Log View window can be opened from the Plugins -> Log views menu. You can use log messages to check progress of the download process and to troubleshoot problems.
Azureus/Vuze restart persistence
Downloading process is persistent between Vuze sessions. In case Vuze is restarted, plugin state is restored to the state immediately before restart, i.e. running download is restarted and continuous update state is persisted between Vuze runs. It is particularly useful in case Vuze is configured to start automatically when system starts up.
Plugin was tested on Vuze version 22.214.171.124, nevertheless it uses basic API only and should work on most versions of Azureus/Vuze. Plugin should be platform independent.
If you need help with plugin, you can use this Contact form to ask questions to the author. General comments, suggestions etc. are welcome as well. Source code of the plugin is included in the jar archive for your reference.
Feel free tu submit comments and suggestions which can be generaly useful to other plugin users as a comment below this article.
Plugin is licensed under GPL v.2 license. Plugin uses following third party code:
Licenses of foreign packages can be found by following provided links.