RRUpd8 v1.1.x

Installation
------------

Extract to your Road Runner\plugins\ folder, you should now have a folder called RRUpd8.

Run register.bat.

You will now need to add x,rrupd8 to the menu.skin of the skin(s) you use.
You will also need the following .skins plus the corresponding graphic files.

upd8.skin
upd8_paths.skin
upd8_settings.skin

You will also need to create a button in your menu.skin (or another .skin file) with the code rrupd8

For example skins see the beta thread.

http://www.mp3car.com/vbulletin/rr-plugins/125651-rrupd8-sync-plugin-road-runner-status-ready-beta-testing.html



Using
-----

Based on the Brushed Metal example skin.

On first run there are no sync paths set, so click on the blank list to add your syncs.

To add a new sync press an 'Add' and then fill out the details for each category (click change to bring up the OSK or toggle options).

Sync Name - This is a name to give some indication of what you are sync'ing.

Local Path - This the is the location path on the PC you are running RR on that will either receive or send data from.

Remote Path - This is the location path on the remote PC (USB key) that you will copying or sending data from/to.


Either Local Path or Remote Path can be replaced by <musicpath> this will look to RoadRunner to provide the current music path.

If this is set and RRMedia (by Blue ZX3) is running after a successful copy of a file to this path a command will be sent to get RRMedia to update it's database.


Sync Action - This is what type of action. 

	You can just Add data in which case anything that is not on the destination but on the source will be added to the destination.
	You can Mirror data which is the same as Add, but anything that is on the destination but not on the source will be deleted.
	
	Transferring Down means Remote is source and Local is Destination
	Transferring Up means Remote is destination and Local is source.

	so the sync actions are Add Up, Add Down, Mirror Up and Mirror Down.

	Also listed as an option is Mirror Sync (This is not available at the moment)

Sync Extensions - This is a list of extension types to sync, seperate with a semicolon ';' or just enter * for all types.


Press Apply when all info is entered and then the back arrow to take you back to the main screen. The Sync name you enetered should now appear in the list.

Next to it will be a white indicator this shows there is a sync path, but we don't know if there is access to the remote location yet.

When an automatic sync takes place it will either turn Red or Green (do I need to say which each colour means?)


If either of the locations you specified don't exist the program will create them for you.

A file (Access.OK) will also be put into the remote location, this is the file the program checks for to make sure the remote location is accessable.


Pressing the tools button brings up the settings menu, five settings are available here, there is the delay between checking for access to the remote location(s) in seconds,
the amount of time in minutes to wait after a successful sync before resuming automatic checking, whether RoadRunner should go to the upd8 screen automatically when a sync is
 taking place or should it run in the background, Whether the sync check is automatic and whether to update the music database if RRMedia is detected.

If you set a remote location on a USB key, upd8 will automatically check it's sync paths when a USB key is inserted.
 


setting up upd8.ini manually
----------------------------

Under the General settings there are the delay period between checks for locations, and whether RoadRunner should switch to the upd8 screen when sync'ing.

There is also a setting called Success, this is the period (in minutes) to wait before checking again after a successful sync.

Also the settings for automatic syncing and Updating the music database if RRMedia is detected.

[General]
Delay=60
Pop=True
Success=5
useRRMedia=False
Automatic=True


The locations in the ini file are laid out below, the are name Loc1, Loc2, . . . . Locx, there isn't 
really a limit however if you have more than can displayed on the screen at present the program may crash.

Each Location (locx) line consists of the following 

Locx=<Sync Name><Local path>,<remote path>,<Type of copy>,<File extensions>

Sync Name - This is a name given to the sync to give an idea of what is sync'ing
Local path - This is the path on the local machine
Remote Path - This is the path on the remote machine or memory stick
Type of Copy - This is the type of copy, these are the ones available

	mdn - Mirror Down, copies files from remote to local and deletes from local to match the remote 
	mup - Mirror Up, copies files from local to remote and deletes from remote to match the local
	adn - Add Down, copies from remote to local any not already on the local. No delete
	aup - Add Up, copies from local to remote any not already on the remote, No delete

File extensions - Files with which extensions to copy seperated by semicolons. '*' can be used to copy all

Here is a few examples	

[Locations]

Loc1=Home Music,c:\r&b\,M:\playlists\,adn,jpg;mp3;gif;bmp
loc2=Skins,c:\skins\,f:\PSD's\,mdn,*
Loc3=Misc Music,c:\testing\,f:\gpsgas\,mdn,*
loc4=Work Music,c:\r&b\,f:\silence\,mdn,*
loc5=Pictures,c:\pics\,f:\pics\,mdn,jpg;bmp;png








Enjoy.


Enforcer


Bug reports or Suggestions to

admin@en4cer.co.uk

or at these forums

www.en4cer.co.uk/forum
www.mp3car.com

