Activity Workshop

GpsPrune user guide

The following is a description of the separate, and non-free, user guide for GpsPrune. The book is now available for purchase (see below for payment details). This is a more detailed manual for the program, going into more depth and with more details than the information provided on this website.

You've seen GpsPrune, you've used it, and hopefully you find it useful. Perhaps you wonder what else it can do, maybe you'd like more detailed examples of how to use it, or hints and tips for using it more effectively. Maybe you would appreciate having a quickly-searchable reference guide which is easy to take with you and use offline. The question is, would you pay for such a thing?

This guide is available in three formats: PDF (for viewing in a pdf reader application, perhaps also for printing), online HTML (for viewing in a browser), and now also EPUB (for viewing on a reader device or with a reader application such as Calibre). Buy once, and you'll receive all three versions (all without any kind of DRM shenanigins). Plus when the next version comes out, you'll get that free. Plus when the version after that comes out, you can choose to buy that at a reduced rate if you want to.

The user guide has been fully revised and updated to reflect the changes in GpsPrune version 18. That includes the colour screenshots and the useful URLs as well of course.


The following pdf (14 pages, 470 kB) shows a preview of the book, including the contents pages and the entire "Viewing maps" chapter.

click to download pdf

The full pdf contains 162 pages of A4, and weighs in at 5.0 Megabytes. It's around 60 thousand words if that means anything to you. There are 17 chapters, as shown in the contents section above, and it includes over 100 colour screenshots and over 80 helpful URLs. The HTML and EPUB versions contain the same content, but obviously with different formatting.

How to buy

To purchase your copy, there are two payment mechanisms - either a gift certificate and email, or direct purchase paying with bitcoins.

Amazon gift certificate

If you already have an Amazon account at .de, .uk or .com, you can send a gift certificate making it payable to tim (at) On receipt of the certificate, you will receive by email a web link from which you can download the pdf. I will endeavour to process these as quickly as possible, but even in the best case you should allow a day or two. Depending on where you live, there are currently these options:

Very Important: You need to include your email address in the note so that I can send you the link to the user guide. Amazon doesn't pass on your email address automatically, so if you don't tell me, I have no way to contact you. Needless to say, this email address will not be passed on to anyone else, and will only be used for providing the links to the user guide.

If you've sent your payment but haven't received your user guide, please get in contact, and give the id of the code you sent, or your full name.

Alternatively, if there are other gift vouchers you'd prefer to use instead of Amazon ones, then please get in touch to discuss your preference -- if the voucher is emailable and I'm able to make use of it then let's investigate!


Paying with bitcoin is an alternative way of purchasing, and appears to have advantages and disadvantages. You don't need an Amazon account, but you do need a bitcoin wallet. You don't need to have access to US dollars, British pounds or Euros, but you do need some way to convert your local currency to bitcoin. There are no currency exchange rates to pay, but there is the substantial volatility of bitcoin values.

Perhaps most importantly, this purchase is automatic, which means you don't need to wait for me to check my email and send you the link. You can just download the link as soon as the bitcoin payment clears, so it's hopefully more convenient for you. But on the downside, I never get to see your email address, so I can't offer you a cheaper upgrade to a future version of the guide. Still, the option is there and it appears to work just fine.

Paying this way gives you a zipped text file, giving you a link where you can download version 5 of the guide, and a link to where version 6 will be when it's done.

Questions and answers

These aren't particularly "Frequently asked questions", but instead more "Preemptive questions", for clarification.

Why isn't it free? - because writing (and maintaining) a book like this takes a lot of time, and my time isn't free. Just because GpsPrune is free, doesn't mean that everything I do is.

Does that mean GpsPrune isn't free any more? - GpsPrune remains free. Free to use, free to modify and distribute, Free as in beer and Free as in Freedom. And GpsPrune remains completely opposed to any sneaky tricks like demo versions, premium versions, trial versions, unlock keys, or bait-and-switch trickery. GpsPrune is free and will remain so.

Does that mean there's no free support any more? - this website remains free to use, as are the youtube videos, and both will continue to be updated. Free support will continue to be given on the sourceforge forums and by email. Nothing changes there.

Does that mean that development of GpsPrune has stopped? - on the contrary. Writing the book has helped find and iron out quite a few niggles that probably wouldn't otherwise have been found. Development of GpsPrune is ongoing and version 18 has recently been released.

Do I have to buy the book? - of course not. You should only buy the book if you have looked at the contents and consider that it's worth the money to you.

Is the book only in English? - Yes, the book has only been written in English. I'm not comfortable enough in other languages to do a decent job of this size.

Do I have to buy again for each new version? - Whichever way you choose to pay, the purchase price covers the current version of the user guide and the next version too. If you've paid by gift certificate, and I have some way to contact you, then the version after that can then be bought at a specially reduced price, if you wish.

When is the next version of the user guide going to be released? - As soon as it's ready, and as soon after the release of GpsPrune version 19 as possible. It's possible that the next version of the user guide will lose the HTML format, and just keep pdf and epub. It's also possible that bitcoin will be removed as a payment method, although suggestions for alternatives are welcome.