Updates

Updated last 8 August 2012 to the latest version of FolderSync Lite - 2.1.9. The screen shots were updated (please refresh your browser if you had recently visited the page prior to the date mentioned to clear the cache). Also, because of the change in Foldersync's User Interface, some text content below was updated as well.

Introduction

MySword 3.0 sports a newly organized modules path where modules and databases are properly segregated into type. Before, all modules are placed in just one folder, with version 3.0, the modules are placed in one of the following folders (still inside the selected modules path, default to /sdcard/mysword or /mnt/sdcard/mysword):

  1. bibles
  2. books
  3. commentaries
  4. dictionaries
  5. journals
Besides these, there are also three other folders:
  1. journalsbig
    • Very useful for big size journals (10MB and up) which take a long time to backup. This folder can be set to be synchronized weekly or so.
  2. mydata
    • The files that are previously stored in the application's private area located in the internal memory of the device is now moved here so that it will easy to backup. These files are:
      1. bookmarks.mybible
      2. highlight.mybible
      3. settings.mybible
  3. notes
    • The personal notes (by verse) database named versenotes.mybible is also stored in the private area in the old version of MySword. It is moved to this folder so that it will be easy to backup.
Because of this folder reorganization, it is now easy to backup MySword data, your notes and journals. You can manually copy the folders to your Personal Computer or upload them to your favorite Cloud storage provider. But with the help of 3rd party tools, it will be a lot easier to not only backup the data but also synchronize the updates between two or more devices (say, you have a Tablet and a phone). Let's see below.

Setting up Dropbox and Foldersync to backup and synchronize MySword data, notes and journals

This tutorial will demonstrate the use of the popular Dropbox storage service and Foldersync Lite to do the automatic synchronization. Note that Foldersync Lite can also be used with other popular services like SkyDrive, SugarSync, Ubuntu One, Box.net, LiveDrive, HiDrive, Google Docs, Google Drive, NetDocuments, Amazon S3, FTP, FTPS, SFTP, WebDAV or windows share (Samba/CIFS) accounts.
 
It is assumed that you already have a Dropbox account. If you do not yet have, you can signup to get a free 2GB cloud storage. Now here are steps for the setup:
  1. Install Dropbox for Android from the Google Play Store (formerly Android Market) if it is not yet installed.
    • If you do not have access to the Google Play Store, you can still download Dropbox directly from their website using your Desktop or Notebook PC (because the Android version of the webpage redirects to Google Play Store), copy the file to your Android device, then install.
  2. Run Dropbox and signin your account.
  3. Install Foldersync Lite from the Google Play Store.
  4. Run Foldersync Lite and register Dropbox under Accounts.
    • Please note that the Lite version of Foldersync only allows two accounts.
    • Tap Accounts from the menu on the Action Bar on the top (the default selected item is File Manager).
      Foldersync Lite main menu 
    • Tap Create New (the cloud with a plus button icon) the select Dropbox in Select account type; under Account details, tap Name and enter any name (e.g. MySword).
      Foldersync Lite create account
    • Then under Login, tap Validate access to open Dropbox access screen. You may need to enter login information for the first time then log. Tap Allow when asked FolderSync wants access to your Dropbox.
      Dropbox validate access
    • Tap Save (the diskette button icon) to go back to the Accounts screen.
      Foldersync Lite create account save
  5. Setup Folder pairs in FolderSync.
    • Tap Folderpairs in the Action Bar on the top (currently the selected is Accounts) then tap Create New (the plus button icon).
    • Tap Name and fill it with mydata (or mysword-mydata) and select MySword under Account (already selected by default).
    • Tap Remote folder and create mysword top folder. Tap this folder to go inside then create these folders under mysword: mydata, journals, notes and journalsbig (this last one is optional). The latter folders will be associated with separate Folder pairs in Foldersync Lite. The screen shot below shows the four folders under mysword:
      Dropbox folders for MySword
    • Tap mydata because that is the first folder we will create a Folder pair for. Then tap Select folder (the check button icon).
    • Tap Local folder and navigate to /sdcard/mysword/mydata and select that folder.
    • If this device will be a source of updates and not just a plain subscriber of updates, change the Sync type to Two-way. The screen shot below shows the 5 settings we had so far:
      Foldersync Lite create Folderpair
    • Scrolling down will show the Scheduling setting which is set to Sync automatically by default. If you only want to sync every hour, you can check Use scheduled sync then select Every hour under Sync interval.
      Foldersync Lite Folderpair schedule
    • Then tap Save (the diskette button icon).
    • Repeat the steps above to create three more Folderpairs (notes, journals and folders) for the other three folders. If you are not planning to use the foldersbig folder, then skip that one. For foldersbig, the best setting for the Folderpair schedule is weekly. For journals and notes, you can select hourly or daily schedule setting.
    • The screen shot below shows three folder pairs created (journalsbig is not included).
      Foldersync Lite Folderpairs list
  6. Perform synchronization for the first time to upload the files to Dropbox.
    • Tap Sync status from the Action Bar menu on the top (currently set to Folderpairs). Then tap Sync now (the refresh or two arc arrows in cycle button icon) if it is not yet syncing. Below is a screen shot of a successful sync.
      Foldersync Lite Sync Status
      Note that this is done using Android Emulator that is why the Connection type is Mobile 3G but the default is actually Wifi. You can select the type of Connection to allow for a Folder pair in the Folder pair setting (just scroll down).
    • You can tap the log entry to see the details of the sync: number of files, size of data transferred and the files uploaded (or downloaded in case of subscriber of updates).
    • You can also monitor previous syncs using this screen.
  7. Now the next step is to setup another device as a subscriber (or publisher also) of updates.
    • Follow the same steps above except some parts in step 5:
      • Enter the appropriate Name.
      • You do not need to create remote folders (at Dropbox) as they are already created (and populated as well with initial content).
      • Select the appropriate Remote folder and Local folder.
      • If this device will be a sole subscriber of updates, you can setup the Folder pairs such that the Sync type to To local folder; then in Sync options below, change the If conflicting modifications from Skip file to Use remote file. The last setting will ensure that the local file will be overwritten in case it was updated (like the case of settings.mybible which is periodically updated) locally and the remote copy is also newer so there is a conflict.
      • If this device will be used as a publisher also of updates, you can maintain Sync type of the Folder pairs to Two way; then in Sync options below, change the If conflicting modifications from Skip file to Use remote file if this is a secondary publisher of updates, Use local file in case this is the primary publisher (overriding others). In case both of your devices are both primary publishers, use Overwrite oldest. If you want not to use the automatic overwrite, maintain the Skip file option. This default setting will show an Exclamation point icon on the Sync status which means there is a conflict and you will have to manually synchronize the files or change the option recently mentioned.
    • Then perform the sync in Step 6 in case it has not started automatically yet after saving the Folder pairs.

Tips

Here are some important tips:
  1. Use journalsbig in case you have very large journals like mine (18+MB of 2,700+ topics since 2002) as they take some time to upload/download. My journal takes around 4 minutes to upload. Also set the sync schedule to longer time intervals like Weekly.
  2. settings.mybible holds every setting in MySword like you current Bible verse, other module positions (navigation positions), button arrangement and so on. This is updated often though it is only read once when MySword is started. Note that some settings especially the navigation positions are cached and are only saved on Exit or when other settings (like those in the Preferences) are changed. So if you want to make sure the whole settings are backed up, exit MySword before synchronization.
  3. Turn on the Wifi only after closing MySword to make sure the settings.mybible is fully updated. After turning on the Wifi, Foldersync will automatically sync folders that are delayed due to the absence of Wifi. After the sync is finished, you can turn off Wifi.
  4. For a subscriber of update, turn on the Wifi and let the synchronization to finish first before starting MySword to ensure new version of the files are downloaded first. After the sync is finished, you can turn off Wifi.
  5. If you have a Tablet with a different preferential setting compared to your phone, syncing settings.mybible in mydata folder will make the two settings the same so do not be surprised. It is possible to sync mydata folder with settings.mybible as an exception (Filter) but that is only available in the Full version of Foldersync.
  6. If you encounter an Exclamation point icon on the Sync Status of Foldersync, that means there are some update conflict and the If conflicting modifications option is set to Skip file. This can happen in some instances like:
    • You had modified a file (like settings.mybible for example) before syncing a more recent version from Dropbox.
    • Both devices are in sync, then both are updated. One device is able to successfully sync upload the file to Dropbox. When the other device performs a sync, there is a conflict. 
    This scenario should be avoided as simple file syncing using overwrite will overwrite one update (lost update) to resolve the issue and there is no merging of updates (as that is very complex and not possible with simple file sync). To make Foldersync Lite internal records to be in sync again for the said file (or files in the folder), one update will have to be overwritten, either the version in Dropbox or the local file.

    If you are sure that both updates are very important, you can manually copy first the update to a temporary journal (by creating the entry) before overwriting the file. Then restore manually the lost update.
  7. Use one device as publisher of main updates (Folderpair setting Sync type is To remote folder and If conflicting modifications set to Use local file) while the others as subscribers of updates (Folderpair setting Sync type is To local folder and If conflicting modifications set to Use remote file). This prevents conflicts but automatically overwrites updates done in subscribers.
Happy syncing MySword!

Make A Donation




Your donation is not a payment but a SEED sown to the support of this software project. Please note that we are not selling this app but we are giving these Premium Version and Deluxe Complete Editions as complimentary gifts to our generous donors. There is a minimum donation amount required to have the Premium Version and Deluxe Complete Edition. For more information please contact us.

After giving your donation, please wait for MySword Technical Support to prepare your activation code within 24 hours (our time zone is GMT+800). You will be receiving an email using the email you used in PayPal with instructions on how to activate.

If you were not able to receive your activation code, please email us using your alternative and reliable email address (Gmail or Yahoo).