wiki:usbkey

Take Mulberry everywhere with you

This is a brief document explaining how to install the Windows and Linux versions of Mulberry on a USB flash disk. Once you do this you will be able to use your favorite e-mail client on any PC running either Windows or Linux and not have to suffer with slow and frustrating web interface access.

Since all the information is stored either in your mailbox on the server or on the flash disk, there is no information left on the host PC.

Windows

(this whole process seems completely unnecessary - just copy your Mulberry installation directory and your preference file to your USB-stick. Then launch Mulberry by double clicking the prefs file. If I misunderstand some advantage with the solution below, feel free to delete this comment)

1) Install it

Copy the Windows version of Mulberry from your PC

Create a folder on the flash device. I created the folder Email\Win

  • copy the whole Mulberry folder. If you want you can delete the pdf files to save a little bit of space.
  • copy your preferences file (under Windows make sure to export them first to guarantee the file has the most recent settings)
  • create a batch file to start it with the following content. I named mine Mulberry.cmd
    set STARTUP_FOLDER=%~d0%~p0
    start "title" /B "%STARTUP_FOLDER%Mulberry\Mulberry.exe" "%STARTUP_FOLDER%Mulberry.mbp"
    

Now your folder should look like this

E:\email\Win>dir Mulb*
 Volume in drive E has no label.
 Volume Serial Number is 80AE-DABB

 Directory of E:\email\Win

29-Aug-2006  12:43            83,077 Mulberry.mbp
29-Aug-2006  12:17    <DIR>          Mulberry
29-Aug-2006  12:41               165 Mulberry.cmd
               2 File(s)         83,242 bytes
               1 Dir(s)     320,593,920 bytes free

Note: Using start /b you don't have a cmd window left open after you launch it. Using "start" without the "Title" param for some reason does not work. See > start /?

2) Use it

To launch it on a PC running Windows pop the flash drive and double-click "Mulberry.cmd"

After the first launch tell Mulberry to not check if it's the default e-mail handler and will not ask anymore.

Note 1: Keep in mind that if you try to launch while another instance of Mulberry is already running gives you the impression that nothing happens. You can add a "pause" line at the end of the batch file for diagnostics.

Note 2: The use of a .cmd file instead of a shortcut makes it independent on what drive letter is Windows going to assign to your flash drive.

Caveats: The only caveat I can see is that on launch Mulberry creates the registry key

[HKEY_CURRENT_USER\Software\Cyrusoft International, Inc.\Mulberry\Logging]


Linux

1) Install it

Copy the Linux version of Mulberry from your PC

Create a folder on the flash device. I created the folder Email\Linux

  • copy the Mulberry binary
  • copy your preferences folder .mulberry under the name MBPREF
  • create a startup script with the following content. I named mine startmulberry.sh
    #!/bin/sh
    # determine startup folder
    STARTUP_FOLDER=`dirname $0`
    
    # keep track if we linked the prefs folder from the flash disk or was already there
    PREF_FOLDER_WAS_LINKED=0
    
    # link pref folder to home directory (do not do so if already exists)
    if [ -d $HOME/.mulberry ]; then
            echo "$HOME/.mulberry folder already exists"
    else
            ln -s $STARTUP_FOLDER/MBPREF $HOME/.mulberry
            PREF_FOLDER_WAS_LINKED=1
            echo "Linked prefs folder from $STARTUP_FOLDER/MBPREF"
    fi
    
    # launch mulberry
    $STARTUP_FOLDER/mulberry
    
    # remove link
    if [ 1 == $PREF_FOLDER_WAS_LINKED ]; then
            rm $HOME/.mulberry
    fi
    

Now your folder should look like this

vmware@xubuntu:/media/usbdisk/email/lx$ ls -la
total 15096
drwx------  3 vmware vmware     8192 2006-10-04 14:27 .
drwx------  5 vmware vmware     8192 2006-09-16 13:25 ..
drwx------ 12 vmware vmware     8192 2006-09-16 13:26 MBPREF
-rwx------  1 vmware vmware 15425436 2006-09-16 13:26 mulberry
-rwx------  1 vmware vmware      584 2006-10-04 14:27 startmulberry.sh

2) Use it

To launch it on a PC running Linux pop the flash drive, mount it and start it

$ mount -t vfat /dev/sdb1 /media/usbdisk
$ sh /media/usbdisk/email/lx/startmulberry.sh

Note 1: You MUST provide the full path to the startup script, since it uses dirname to determine the full path to the startup folder. Please, let me know if there is a different way to detemine the absolute startup path

(yes, you can use readlink -snf relative-file-or-folder and you will get an absolute path out of that. You should test for the existence of the readlink program with which. Note that older or BSD versions of readlink don't have the required functionality to find absolute paths.)

Note 2: Obviously you will need the appropriate permissions to mount the flash disk

Note 3: In some environments Mulberry seems to hang up on closing, so you might have to kill it

Last modified 6 years ago Last modified on 02/03/11 04:23:04