How to get GSAK8 running on OS X

Skriv ut

I've been searching the web for a guide how to get GSAK to run on OS X, but since i didn't found anyone I decided to write one myself, so here you go. :)

As you know GSAK is not meant to run on OS X so you probably might experince some craches and some bugs. If you run into any bugs, please feel free to let me know in a comment below. :)


What you need is:

* A Mac running OS X (duuuh! :P)

* Wine and WineBottler
* GSAK8
* A computer running Windows (If you have Parallels and Windows installed on your Mac this works fine too)
* A USB memory
* And a cup of coffe or two

Step 1 (Download and install WineBottler):

Go to http://winebottler.kronenberg.org/ and download WineBottler 1.4.1.6 Stable.
Open the DMG-file and drag both Wine and WineBottler to your Application-folder.
wbc
Step 2 (Download GSAK):

Go to http://gsak.net/ and download GSAK Version 8.3.0.

Step 3 (Installing GSAK using WineBottler):

Start WineBottler (if you get asked to download the latest version click Skip this version or Remind me laiter).
Click on Advanced
Click on select File... and browse and choose the GSAK installer that you've downloaded.
Check the box 'Bundle' (Include Wine binaries, so the app can run without prior install of Wine.
Under 'Identifier' you can type "GSAK8"

It should look like this:
wba
Click on 'Install'.

Enter "GSAK8' as filename and choose where you want to save the file (for example on your Desktop) and click on 'Save'.
Follow the GSAK installtion instructions.
When you get near the end of the installation uncheck every check box so it looks like this:
gsakinstaller1
Click 'Next'

Uncheck the 'Launch GSAK'-box.
gsakinstaller2

Click 'Finish'


Now you will be asked to choose which file that is going to run when you dubbleclick the created application.
Choose 'gsak.exe' so it looks like this:
ssf

Click on 'OK'


Step 4 (Authenticate GSAK with geocaching.com):

Here it gets a little tricky cause GSAK running under Wine won't authenitcate with geocaching.com, it will just freeze if you try to sign in on geocaching.com.

So here is what you need to do:

Install GSAK on a computer running Windows (it works fine if you are running Windows under Parallels on your Mac).

When GSAK is installed and running:
Click on 'Geocaching.com access->Get another access token'
Enter your username and pasword, don't forget to check the 'Keep me signed in'-checkbox.

gcsi

Click 'Sign In' and then 'Allow access'

GSAK now has access to your geocaching.com-account. You can see this by clicking on the menu 'Geocaching.com access' and now your geocaching username should be listed on the bottom of then menu.

gca

Click on File->Backup
Click on 'Select all Databases' and check the box 'Save GSAK Settings'.
Choose your USB memory as the location to save the backup file and then click 'Backup'

winbackup
*Note: Here you might just have the Default database.

Insert your USB memory in your Mac and start GSAK.

Click on File -> Restore
Choose your backuped file on your USB memory (you probably need to browse to: Z:\Volumes\<your USB drive>).
Click on 'Select all Databases'
Check 'Restore all GSAK Settings'
Check 'Remove absolute paths for called macros (recommended)'

macrestore
*Note: Here you might just have the Default database.

Click on 'Restore' and then click 'Yes' and after a little while click 'OK'.

If every thing went right your GSAK on OS X now should be authenticated with geocaching.com. To verify this click on 'Geocaching.com access' and on the bottom of the meny you should see your geocaching username.

macgsak

Step 5 (Fix the icon)
(This step is very optional and if you don't care about how your icon look you can jump to step 6)


Now you got GSAK running on your Mac. But as you see it has a quite poor icon.

To fix this follow the instruction below:

Click here to download the GSAK icon.

Open the gsak.ico with Preview on your Mac.
iconpreview
Click on Edit->Copy (or just push CMD+C on your keyboard)

Right click on your GSAK8-app and choose Get info (or just click it once and push CMD+I on your keyboard).
info1
Click on the icon in the upper left corner and then click Edit->Paste (or just push CMD+V on your keyboard).
info2

Close the window by clicking on X in the upper left corner.

Now you should have a quite nice icon for your GSAK-app. :)

Step 6 (Moving GSAK to your Application-folder)

Just like the title says, it's time to move your GSAK-app to your Application-folder. In other words just drag and drop it to your Application folder and then you are good to go. :)


Feel free to give me feedback by commenting below.

 

Copyright 2011 GSAK8 on OS X.
Joomla Templates by Wordpress themes free