GSAK 8 – New Features Tutorial


GSAK 8 is the most recently released version of Geocaching Swiss Army Knife. For those not familiar with the software, it’s basically a Geocaching database that you can use to store, filter and manipulate cache data. It’s an absolutely massive product and since version 8 now connects to the Geocaching.com Live API for better integration with the website. Previous versons of the software relied on you manually loading in your own caches, for example via Pocket Queries. Version 8 is better integrated with the Geocaching.com website and is able to not only automatically retrieve cache data, but also download extra logs for caches, add caches to your favourites, quickly log caches, and log caches using the field notes from your GPS.

GSAK8 has been out a fair while now, but I thought I’d use a blog entry to go into some depth as to what the new GSAK 8 features provide and how cachers can benefit from this update as I’ve recently upgraded to it. The update isn’t a freebie for existing GSAK users, however it is really reasonably priced for the amount of features you get ranging from $10 to $20 depending on how recently you purchased version 7. Anyone who doesn’t yet own GSAK can purchase it for $30, however you can get a free 21 day trial here to have a play before deciding to part with your hard earned cache cash! ;)

Get the latest patch

Although you may have installed GSAK8, unless you’re running the latest patch for it you could be really missing out! Click here to view a list of patches and what each patch adds to GSAK. Scroll to the very last post in the forum to download the latest patch. By default, GSAK is configured to tell you if there is a new version available. This doesn’t alert you about any of the latest patches, so I’d strongly recommend spending a few seconds modifying your GSAK preferences to enable patch alerts. To do this, click the ‘Tools‘ menu –> Options –> ‘Advanced‘ tab and then on the top right click the box that says ‘Also check for “patches”‘. Now it will pop up and tell you whenever there is a new patch for download.

Tick the 'Also check for patches' box

Geocaching.com Access

Version 8 of GSAK comes with a new menu item added along the top bar labelled ‘Geocaching.com Access‘. Under this menu is where all the new exciting stuff lives!

The Geocaching.com Access menu

A quick run down of the items:
Get Geocaches – Pull Geocache data straight from Geocaching.com. You’ll need premium membership (i.e. the ability to use Pocket Queries) to get any real benefit from this.
Refresh Cache Data – Update the caches in your database with the latest cache data from the Geocaching.com website.
Download Pocket Queries – Pull up a list of Pocket Queries in your account that are downloadable and download them into your GSAK database.
Status Check – Update the status of the caches in your database (Archived, Disabled, or Available)
Favourite Points – Add/Remove the currently selected cache from your favourites or get your Favourites balance.
Update User Information – In GSAK you can set your Home coordinates and User ID to find caches close to home (for example) and filter those owned/found by you. Instead of doing this manually, this option will pull the data from the your Geocaching.com account.
Publish Logs – Log a cache, or queue up a big list of logs to publish to the Geocaching.com website.
Add to Bookmark List – Add the currently selected cache to one of your bookmark lists, or create a new list to add it to.
Get Available Download Balance (New in Build 37 Patch) – Check what your available balance is for cache downloads (Out of 6000)
Get another Access token – Access to your Geocaching.com account is granted via a token. The first time you access your account via GSAK you will have to click to ‘Allow Access’. If you have 2 Geocaching.com accounts and want to switch to another one in order to download more caches (Perhaps you have 2 premium accounts?) you can do that by selecting this option.

Now that we know briefly what everything does, let’s explore some of the options…

Get Geocaches

Exactly what it says on the tin! You could start with an empty database and just pull caches into the database from the Geocaching.com website. Beware that you have a 6000 cache per day limit! GSAK supposedly has a 2000 cache per hour limit so you may have to wait a while to pull the data in. I have tried pulling in 3000 caches though and this request completed in under an hour.

Basic Tab

Get Geocaches Basic Tab

To get started on the Basic tab you’ll need to add a center point. Under Tools –> Options –> Locations in GSAK you are able to define different locations. For example: Home, N52° 14.221 W0° 54.040. Work, N52° 14.456 E0° 54.123. From the ‘Center point‘ selection box you can select one of these existing locations, the current center point that you have set in GSAK, or the cache that you had selected before you clicked the ‘Get Geocaches‘ option.

If you’ve applied the latest patches you’ll have the ‘Google Maps‘ button on your ‘Get Geocaches’ screen. This is an awesome feature that you can use to get really specific about which area you want to pull caches from. You can select to draw a circle, or rectangle around the area and once you’ve covered the area, click Return coordinates to add that as your selection. As you can see this is much more flexible than using a PQ.

Select an area on the map to find Geocaches around

After you have selected a centre point you can then go into details of which caches around that point you wish to retrieve. The Max geocaches to get field means that you are no longer restricted to grabbing 1000 caches at a time and generating overlapping PQs. You can instead pull down several thousand Geocaches around an area. Instead of pulling down 5 logs per cache you can now grab up to 999 logs per cache! Do bear in mind that the more caches and logs you try to do simultaneously the longer it will take.

The ‘Basic’ tab then includes the rest of the settings that you would expect: Cache size, Difficulty/Terrain rating, Found caches, and disabled caches options. There’s also a nice feature where you can specify to download only caches with a certain number of favourite points. A great way to instantly find all of the best caches in an area that you are visiting.

Only download caches with 15 or more favourite points

Advanced Tab

Over on the ‘Advanced’ tab things really get exciting! You have the ability to select which cache types to display, like in a normal PQ, and a lot of other exclusive options. You are able to specify a ‘Owned By‘ field to download only caches hidden by a certain user. In this field you can select up to 5 users separated by a comma. If the cacher’s name includes a comma then you specify their name in double quotes (e.g. “awkward,cacher”). Perhaps the most exciting field on the Advanced tab is ‘Not Found by‘. If you are planning an outing with a group of cachers and want to download a selection of caches that none of you have found then you can enter up to 5 cacher names in this field too. ‘Exclude owned by‘ is similar to ‘Owned by’, but blocks caches hidden by certain users (Those cachers that are on your ‘blacklist’ ;))

Advanced Get - Specify caches by owners

Finally the ‘Data Format‘ on the Advanced tab allows you to specify whether to download Full data (Like the amount of data included in a GPX file) or Light data (Like the amount of data included in a LOC file). Once you’ve specified all of your settings hit ‘OK’ and watch your GSAK database grow!!!

Refresh Cache Data

So say you ran ‘Get caches’ on Monday. It’s Friday evening and you’re planning to go caching on Saturday. The data in your database is now quite stale so you will want to update it. This is where ‘Refresh Cache Data‘ comes in. This does count towards your 6000 a day limit and will only refresh existing caches rather than add any new ones so ‘Get Geocaches’ may be a better option here.

Refresh Cache Data

Download Pocket Queries

This option needs little explanation. Instead of having to load up the Geocaching.com website and download pocket queries and then import them into GSAK, you can simply click this menu and you can select which PQs to download straight into GSAK. Brilliant! On the Advanced tab you also have the option to ‘Download all Pocket Queries not yet downloaded‘.

Select from your Pocket Queries for download

Get Logs

The ‘Get Logs‘ feature allows you to update the logs for caches in your database. The great thing about this is that you can download up to 30 logs per cache instead of the usual 5 so that you can have a big selection of logs to read if stuck finding a cache out in the field! You may find that running this and some of the other options can generate an API wait message. GSAK can only make a certain number of requests to the API per minute so if downloading a large number of logs you may want to leave it and go and make a cup of coffee… or 6! ;)

API wait...

Publish Logs

For me the ‘Publish Logs‘ feature of GSAK8 is what makes it worth the upgrade. Using this you can quickly write and publish a batch of logs either by selecting a list of caches in the database, or from the Field Notes file that is automatically created when you log caches on your GPS.

Field Notes

geocache_visits.txt file

For those of you not familiar with field notes, when you select Log Attempt –> Found It on your Garmin GPS it adds an entry to a file on the GPS called ‘geocache_visits.txt‘. If you haven’t used your field notes file before and look at it on your GPS now you will see every single cache that you have logged previously. Luckily this is a simple comma separated .txt file and if you double-click it, it will open up in Notepad and if you wish to clear it out you can just remove the lines in the file that reference previously logged Geocaches. Now that you have your field notes ready click the ‘Publish Logs‘ option.

Fetching Field Notes

If you have a large field notes file full of old caches that you have previously logged you can leave these as they are, but tick the box along the top that says ‘Ignore logs before’ select the current date. This means that GSAK will only import logs created on and after that date.

The are also some other options for fetching field notes. You can choose to copy the field notes you made into the logs. Useful if you just want to publish field notes that say “TFTC” for every single cache. If you’re using your field notes as just a reference then you will be able to view them for each log you edit so it’s not important to copy the field notes in.

Specifying fetch options

To get your field note file into GSAK, simply right-click in the Publish Logs view, choose ‘Fetch‘ and then ‘From File‘. You could also choose ‘From GPSr‘ for it to automatically pull that file off of your GPSr.

Right-click to choose how to fetch logs

List of caches imported from field notes

Templates

You’ll notice that the caches you have imported are in an order. These are ordered by “time” found, timestamped with the time that you pressed Log Attempt –> Found on your GPS. GSAK automatically assigns a sequence number. This sets the order in which the logs are published to the Geocaching.com server. If you did a series and forgot to log cache #6 (for example) and then logged it later in the day when you realised it was still showing on the map you will need to change the sequence number for this cache if you want to upload logs in the order that you found the caches. This is particularly important when using templates. If you have the latest patches applied then you will have ‘Move up‘ and ‘Move down‘ buttons so that you can easily adjust the sequence number and therefore publish order.

Templates are an awesome feature which allow you to automatically add text to every single log that you submit via GSAK. GSAK can also automate tags which you can insert into your logs to add the cache count number, or the number of caches that you found on that trip.

To create a template, start by clicking the ‘Templates‘ button at the bottom of the ‘Publish Logs‘ dialog. From here you can select each log type (e.g. Found it, Didn’t find it, Needs Maintenance) and create your template depending on log type.

List of tags you can add to a log automatically

The tag options are pretty self explanitory, but here’s an extreme example:

An example of some of the fields you can add to GSAK

Now that you have your template created for Found caches you can double click on the first cache that you wish to log to enter your log.

Now when you select a ‘Found it’ log, your template will automatically be added into the log text and you type your custom log in the box.

A log showing the template and custom log

Click the ‘Preview‘ tab in the log to see how the log will look with the template applied to it. GSAK will check against your find count on the Geocaching website to update any numbers used in tags.

Previewing a log in GSAK

Notice that the Field Notes that you added on your GPS display in the grey box just above the logging area to help remind you of the cache. In here you can also tick the ‘Add favourite point‘ box. Also, when you open a log for a cache the cache page will pop up in the background in GSAK so you can check the description or hint to help jog your memory about the cache.

Once you have entered your log, click the ‘Next‘ button to start inputting details on the next cache in your list. Your template will automatically be applied to all of your logs.

Trackable Logging

In GSAK Build 59 (patch) the ability to log trackables was added. In each log there is a ‘Trackables’ button near the bottom which if pressed connects to your Geocaching.com account and checks what trackables are in your inventory. You can then right-click a trackable and choose to ‘drop’, ‘visit’ or ‘visit all’ (All trackables in your inventory visit the cache).

Dropping a trackable

When you select a trackable to drop or visit the cache that you are logging, you’ll be prompted to enter your log. Up until one of the most recent GSAK patches, you also had to input the trackable number to drop/visit it in a cache. This is obviously not quite right and not the way that trackable logging works on Geocaching.com. The recent patch changes this so that you don’t have to enter the TB number to drop/visit a cache.

The trackable logging screen

Once you have done all of your logging, all you need to do is click the ‘Publish‘ button and it will publish all logs in the queue to Geocaching.com.

A really nice part of the logging feature is that if you close GSAK or restart your computer, etc. the unpublished logs that you entered into GSAK are saved there ready for you to add to or publish.

Logging caches without field notes

If you don’t have a field notes file to use for logging via GSAK you can create a filter in GSAK to pull a list of caches, or even select a cache in the database then pull up ‘Publish Logs‘ –> Right-click –> Fetch and choose ‘From Current Cache‘ or ‘From Filter‘. If pulling in lots of cache from a filter be aware that the sequence numbering might not be quite right and you may have to re-number the caches to ensure that they are logged in the correct order (Note: It of course doesn’t matter what order you log caches in, but some people like to log them in the correct order so that milestones are correctly updated)

Settings

You may have noticed that a lot of the dialog boxes have a ‘Settings‘ button. The settings button allows you to configure some options concerning your database. You can, for example, select which database the operation is performed on (The current database is used by default). Here you can also select whether to ‘Always update database’ or only update ‘Newer’, ‘Existing’ or ‘Add only’. You can select to clear out existing data in the database before updating as well. You may wish to explore these options so that you are aware what can be done, however they should probably be considered as ‘Advanced’ options so if everything is working as you’d expect you’ll probably not want to make many changes.

The advanced settings dialog

Conclusion

I think I’ve pretty much covered all of the exciting features of GSAK8. I can honestly say the new version has converted me from someone who used to either do all logging on their iPhone or the Geocaching.com website. Now, I do all of my Geocache logging in GSAK via the Publish Logs feature. ‘Templates’ are the things that make this really attractive to me. I’m not a big fan of copy and paste logging, but it’s nice to have your cache count, and perhaps a very brief summary of your day at the top of your log and then type individual cache details below. It’s also a lot quicker to move through caches to add your logs via GSAK. It quite often takes me a few hours to write my logs for a day out caching so it’s great to be able to save a bit of time. I’ve not fully moved away from Pocket Queries just yet, but I think that will come with time. Remember you can download your usual number of pocket queries PLUS 6000 caches into GSAK. That’s a lot of caches! You’ll still need to use Geocaching.com to generate Caches on a route and if you use ‘Get Geocaches’ to pull caches into your GSAK database it won’t download any corrected coordinates you have added. You will have to do this manually in GSAK. If, however, you load caches with corrected coordinates from a PQ into GSAK then the coordinates in GSAK will be updated.

There is a great tutorial on GSAK here for anyone who is unsure of the basic features that I haven’t covered here. I also did a blog post a while ago on an older version of GSAK here which covers some of the basics.

As usual, drop any questions in a comment on this post and I’ll do my best to answer. I’m no GSAK expert though, but thought it wouldn’t do any harm to show off a few of its new features!

About these ads

25 Responses to “GSAK 8 – New Features Tutorial”

  1. Bill Derwent Says:

    Great post there, Cass. I’m already a hefty used of GSAK, but I still learned a couple of bits I didn’t know!

  2. omilosandjuktas Says:

    It’s a great post. Thank you for these helpful informations.

  3. Al whysall Says:

    Great review – have looked at this before and never really got on with it. Is there a Mac version do you know?

    • geocass Says:

      Hi Al, There’s not a Mac version. You could get it working via Virtual PC, Parallels or Boot Camp though. There’s a caching app for Mac called MacCaching that you may like to try as an alternative?

  4. ds8300 Says:

    Again, a great tutorial! I have bought GSAK8 but still use GSAK7 despite the better functionaility in later version. The reason is that my company’s firewall doesn’t support the geocaching API. Wonder why? ;-)

  5. david Says:

    Never come across this before but will definitely give it a try.

    Thanks!!

  6. Karon Smith Says:

    What a brilliant review – I will definitely try logging my next lot of caches direct from GSAK.
    Thanks.

  7. WeCacheAlot Says:

    I’m so glad I found this……exactly what I need. I will take my time and go through your
    entire post line by line. Can’t thank you enough…….WeCacheAlot in Florida

  8. The Frosties! Says:

    Thanks, I need to go to GSAK school :)
    (and probably pay for it soon, the nag screens are driving me crazy :D)

  9. Clubmud1 aka CM1 aka Bob Says:

    Very nicely done!

  10. Team panda Says:

    Thanks for posting this super helpful review. I give it a huge fav point!!!

  11. Andrew Halling Says:

    Hi Cass, like the look of drawing around an area instead of PQs with a centre or home point. From Southend I dont always want Kent caches ;-) Are the downloads actual GPX files when transferred to a GPSR? When I switch to a paperless unit, can the 10 or more logs be transferred or is there a max of 5 that I have seen quoted on GPX input?

    • geocass Says:

      I think it downloads them to a temp location as a GPX file. What you need is the File -> Export -> GPX/LOC file option in the menus. You can then export your GSAK DB (or just those in the current filter) to a GPX file which can then be copied onto your Garmin. To make your life easier you can install a macro to do the export for you: http://gsak.net/board/index.php?showtopic=7745&view=findpost&p=166953

      You shouldn’t have a problem with exporting lots of logs onto your GPS too, just be aware more logs = a bigger GPX file.

      I’m working on a GSAK guide at the mo to go with the event in Billericay. I’ll make the guide available on my blog too so that might help you out! :-)

      • Andrew Halling Says:

        Just printed off your earlier guide! Have GSAK for ages, but not made best use of it, so pleased to read your tips. Can you not just use GPX/SEND WAYPOINTS as I do now to my GPX60CSX?

      • geocass Says:

        Ah yeah you can do that too! :-) That’s the one I never use, the Garmin macro is much more advanced and lets you choose a few more options like exporting the attributes.

      • Andrew Halling Says:

        With a 60CSX, you have to add (%hint) into waypoint info just to get half of the hint, as long ones exceed the max output, LOL

  12. Crazyhedgehogs Says:

    Being able to download all geocaches within a rectangle/circle on a map is worth the price of admission alone! Nice article Cass and looking forward to the 19th!

  13. SaskAcadie Says:

    Great blog. Patching, a feature I was unaware of got GSAK working again where before it always returned an error when I attempted to download the Recent Logs.

  14. KGtrackgeo Says:

    Thank you so much for sharing this great tutorial. This is really good material, as is your “Basic” info :-) In fact, the best I have seen by far… detailed and with pictures! We just finished the E.T. HWY and this will be great for logging high volume logs with the intent of editing the “cardinals”. By the way… did we see your Geo-stamp out there on the E.T. HWY “power trail” ?

  15. moulesmariner Says:

    Having had GSAK for well over a year its been a bit of a slow burn in terms of usage, having had a eureka moment while playing with it I googled some stuff and found your blog…what can I say you set me on the right tracks and opened my eyes to some of the new features. Thanks!

  16. Curry Kev Says:

    After 8 years I’d thought I’d trial GSAK. Just to bulk log on my found caches.
    If it’s too much of a deal I’ll stick to copy n paste.
    But thanks for this tutorial. I’ll check it out over the next 3 weeks.

  17. Chris Flood Says:

    Wonderful tutorial, Cass. I’ve been using Get Geocaches for some time now and never use PQs as they are so much slower. Under your guidance I now use Publish Logs which is a great time saver I especially like the way you can view logs to check them before publishing. Just one question – if i am away on holiday caching and use publish logs without internet access can I publish them all ion one go when I get home?

    • geocass Says:

      Hi Chris, Glad it’s come in handy. You certainly can use publish logs without internet access, just add caches as you go along throughout your holiday. I do that all the time and write my logs each day/other day so that everything is ready when I get home. I’ve experienced a few crashes with GSAK while I’ve had logs waiting in ‘Publish logs’ but I’ve never lost the logs I’ve written or had any problems with them so everything you type should be safe until you get home and submit it. Cass


Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s

Follow

Get every new post delivered to your Inbox.

Join 532 other followers