| geo-*: |
Rick Richardson's Linux tools for geocaching |
Tarball last modified: Sun Jun 28 08:30:51 2009 EDT - ChangeLog
- geo-nearest -omap
- geo-firefox 45.04.337 w93.45.414 #A
Here are various tools for geocaching. Some are designed to turn the clickly-clicky-scroll-clicky-clicky messes that are geocaching.com and navicache.com into a set of tools which you can use in a batch or cron mode to establish your normal caching routine, backup your caches and cache logs, etc. Others are used to enter new waypoints, a free geocoder, create custom maps of waypoints, etc.
These tools work on Linux and CygWin on Win/XP and also work on Mac OS X. I have no plans to port them to native Windows, and to protect your karma I urge others to refrain from doing so.
All of the tools that were written by me are released into the public domain, with no copyright or license restrictions whatsoever. Other tools, like gpx2html and geodetics.html, are copyright by their original author and may have license restrictions as indicated in the source code.
Any of the tools will print a usage summary with "-?", e.g.
$ geo-nearest -?
Click the link, or cut and paste the whole command line below to download the tools:$ wget http://geo.rkkda.com/geo-09-06-28-07-30-14.tar.gzNow unpack it:
$ tar zxf geo-*.tar.gz $ cd geoNow compile and install it:
Compile: $ make Install: $ make install # to install in $HOME/bin OR $ su OR $ sudo sh # PREFIX=/usr make install # to install in /usr/bin... # make install-man # ... and the manual pages Create a $HOME/.georc file with at least these lines in it: PASSWORD="your-gc.com-password" USERNAME="your-gc.com-username" LAT=n44.56.850 # Your home latitude in decimal or MinDec degrees LON=w93.29.465 # Your home longitude in decimal or MinDec degrees
Click here for the forum where you can ask a question, submit a bug report, etc.
You can read the manual pages for more information.
Tools for accessing gc.com... (SO) : this program works only for gc.com subscribers geo-found List caches found (by you or someone else) geo-nearest List the nearest caches to a location geo-newest List the newest caches in a state geo-placed List caches placed (by you or someone else) geo-keyword List caches by keywords. All of the above can enter the waypoints into the GpsDrive MySQL database. geo-html2gpx Convert a gc.com printable web page (such as the above commands can produce with the -H option) to a GPX file. geo-count Count caches found geo-usernum Determine gc.com user number (used by geo-count) geo-gid Retrieve cache info by GCxxxx waypoint name (SO) geo-gpx Retrieve GPX file by GCxxxx waypoint name (SO) geo-demand Request an immediate pocket query email (SO) geo-gpxmail Process GPX email from GC.com (SO) geo-myfinds Schedule a Pocket Query containing your finds. (SO) geo-rehides From your found.gpx file, produce a GPX file of rehides geo-density Compute cache density of an area gpx2html Lightly hacked converter from GPX to HTML Originally by fizzymagic (v1.90). My version fixes issues with HTML in the cache descriptions and adds sort by latest log date for easy perusing of recent cache activity. gpx-loghistory Print all logs in reverse cron order. geo-pqs Figure out what PQs to run to get an entire state. geo-state Convenience script; geo-state -? gives usage. geo-suffix Replace name with name/TypeSizeDiffTerr/gcid/LatLon Tools for accessing nc.com... nc-newest List the newest caches in a state EXPERIMENTAL, subject to drastic changes Tools for general use geo-2gpsdrive Enter a waypoint file into the GpsDrive MySQL database geo-2tangogps Enter a waypoint file into the tangoGPS sqlite database geo-circles Compute the intersection of two circles on the earth geo-intersect Compute the intersection of two line segments geo-project Project a waypoint geo-code Geocode an address geo-dist Compute distance along a list of waypoints. geo-waypoint Enter a waypoint into the GpsDrive MySQL database geo-map Create a map with waypoints plotted on it These CANNOT be used for publication unless the selected map source is the tiger, topographic, or aerial map server! geo-firefox Display a map of a point using MapQuest aerial photos gpx-photos Fetch hi-res aerial photos of all caches in a GPX file gpx-stats Compute stats from a GPX file. gpx-finders Output the finders from a GPX file. geodetics.html A modified version of Gary Nicholson's javascript Geodetics Calculator. ll2utm/utm2ll To/From lat/lon to UTM ll2osg Lat/lon to British National Grid Tools for manipulating Mapopolis place guide data geo-poi Search place guide (*.pdb or *.csv) for places pgpdb2txt Convert a place guide to plain text Tools for use by the MN Geocaching Association mngca Count caches found/placed by MnGCA members mngca-logs Create web pages of recent area logs from GPX files mngca-newmap Create newest cache maps for Minnesota Miscellaneous addletters Add all letters: a=1, b=2, c=3, ... z=26 lethist Compute letter histogram. geo-bot Experimental IRC bot
Do this FIRST:
Download and install MacPorts: http://www.macports.org/ $ PATH=$PATH:/opt/local/bin $ sudo port selfupdate $ sudo port install gsed $ sudo port install coreutils $ sudo port install lynx $ sudo port install ImageMagick $ sudo port install gawk $ sudo port install ghostscript $ sudo port install p5-xml-twig $ sudo port install p5-datetime $ sudo port install p5-html-parser Download and install gpsbabel: http://www.gpsbabel.org/ $ cd gpsbabel $ ./configure --with-libexpat=/opt/local/lib --with-expathdr=/opt/local/include $ make $ sudo make install
Install CygWin as per www.cygwin.com. For the easiest (but longer) install experience, just install everything. If you choose to install a subset, you will need to install the base package plus these other packages (this list might be incomplete):
ImageMagick bash bc binutils cpio curl curl-devel gawk gcc ghostscript grep lynx make sh-utils sharutils wget
<-- Click here to support the development of geo-* tools.
Any amount is appreciated.
