geotoad - geocaching query tool

geotoad geotoad [options] <search>

Geotoad is software to help speed up the boring part of geocaching: choosing the cache and collecting the data. GeoToad lets you perform queries against the Geocaching website, and export the matching geocaches to numerous devices and over 20 file formats.

If run without any parameters, geotoad will launch the interactive mode. It can also be used in command-line mode for specific queries.

-o filename

output file name (automatic otherwise)

-f format

output format type

-f -q [zip|state|coord]

query type (zip by default)

-d 0.0-5.0

set minimum difficulty

-D 0.0-5.0

set maximum difficulty

-t 0.0-5.0

set minimum terrain

-T 0.0-5.0

set maximum terrain

-y 1-500

distance maximum in miles (10)

-k keyword

title keyword search. Use | to delimit multiple

-K keyword

description keyword search. Use | to delimit multiple

-c username

include caches owned by this person (use : to delimit multiple users)

-C username

exclude caches owned by this person (use : to delimit multiple users)

-p X

include caches placed in the last X days

-P X

exclude caches placed in the last X days

-r X

include caches found in the last X days

-R X

exclude caches found in the last X days

-n

only include not found caches

-b

only include caches with travelbugs

-e

enable EasyName waypoint ids

-l

set EasyName waypoint id length. (16)

GEO_DIR

If set, geotoad will put its cache in this directory. If not the cache is placed in ~/.geotoad/ . Note that it is not secure to set GEO_DIR to point to a world-writable directory such as /tmp.

Thomas Stromberg