GetCache
Een Linux-tool om geocache informatie te verzamelen en te verwerken.
[ Doel ] [ Gebruik ]
[ Waarom? ]
[ Benodigdheden ]
[ Gebruik ]
[ Configuratie ]
[ Licentie ]
[ Contact ]
[ GetCache in het Nederlands ]
Doel
Om een dag geocachen voor te bereiden heb je een aantal zaken nodig, waaronder
de cache-beschrijvingen en de waypoints in je GPS. Om dit allemaal bij elkaar
te verzamelen heb ik GetCache geschreven.
GetCache is eigenlijk een schil om twee andere tools heen. Het verzamelt de
waypoints van een aantal geocaches (ook de 'Additional Waypoints') en maakt
daar één bestand van, dat geëxporteerd wordt naar GPX-
of KML-formaat. De beschrijvingen worden (inclusief ongecodeerde hints)
samengepakt tot één HTML-bestand.
Hoe ik GetCache gebruik
Ikzelf begin het voorbereiden van een cache-dag met de Google Maps-kaarten
op geocaching.nl. Na een gebied te
hebben gekozen maak ik een keuze uit de geocaches die in dat gebied
liggen. De GC-codes zet ik in GetCache. Als de lijst compleet is, laat ik
GetCache haar werk doen.
De KML gebruik ik in combinatie met Google Earth om een idee te krijgen van
de positie van eventuele Additional Waypoints - handig om te weten of je met
een kleine omweg tijdens een multi nog een traditional kan meepikken.
Het GPX-bestand upload ik naar mijn GPS ontvanger.
Het HTML-bestand open ik in mijn browser, en daarna kopieer ik alles naar een
tekstverwerker (in mijn geval OpenOffice.org Writer). Daar bewerk ik de tekst
om zo min mogelijk papier mee te hoeven nemen.
Wat heb je nodig?
Om GetCache te gebruiken heb je een aantal zaken nodig:
- Linux. GetCache is op Linux ontwikkeld, en wordt alleen op Linux
ondersteund. Zelf gebruik ik Ubuntu.
- Python. GetCache is geschreven in
Python. Alle moderne Linux-distributies hebben Python al
voor-geïnstalleerd.
- De Gnome desktop. GetCache maakt
gebruik van de Gnome/GTK widgets. Gnome is de default desktop voor Ubuntu.
- De geo-* tools. GetCache gebruikt
deze scripts om de information van geocaching.com op te halen.
Tip: Om de geo-* tools te installeren en gebruiker heb je nog drie
packages nodig. Ubuntu-gebruikers geven het command sudo apt-get install
sharutils curl tofrodos.
- GPSBabel. GetCache gebruikt
GPSBabel om de geocache-informatie samen te voegen, om te zetten en naar
de GPS-ontvanger te versturen.
- Een Premium Member account op geocaching.com (voor het downloaden van de
GPX-files).
- Optioneel: een Garmin GPS-ontvanger die via USB met de PC wordt
verbonden.
- En natuurlijk: GetCache zelf!
GetCache gebruiken
Je kan GetCache op twee manieren gebruiken: via de GUI, of via de commandline.
Via de GUI
Als je GetCache start met het command getcache, dan krijg je de
GetCache GUI voorgeschoteld. Je moet een naam voor de collectie geven (de
bestandsnaam voor de GPX, KML en HTML), en een omschrijving. Defaults zijn
de datums van vandaag.
Daaronder kan je kiezen welke uitvoer-formaten GetCache moet produceren. Daar
weer onder kan je kiezen of GetCache de informatie van de caches opnieuw moet
downloaden (GetCache cached de beschrijvingen).
Je kan er ook voor kiezen om de waypoints direct naar je GPS-ontvanger te
sturen (in Garmin-formaat, via USB). Die optie impliceert dat ook het
GPX-bestand gemaakt wordt.
Daaronder kan je de GC-namen van de geocaches opgeven. Als alles ingesteld is,
druk je op de knop 'Execute', en GetCache gaat voor je aan de slag!
Via de commandline
Je kan GetCache ook vanaf de commandline gebruiken. Met getcache -?
krijg je een overzicht van de mogelijke opties. Alles wat je via de GUI in
kan stellen, kan je ook via de commandline instellen.
Configuratie
Na de eerste keer GetCache te hebben gedraaid, wordt er in de
homedirectory van de gebruiker een configuratie-bestand weggeschreven, met
de naam .getcacherc. In dit bestand staat de laatste configuratie
die via de GUI is gebruikt, en die als default dient voor alle aanroepen van
GetCache daarna.
Als er een configuratie-bestand is, zal ook een run vanaf de command-line
die instellingen gebruiken. Alleen afwijkingen van de instellingen hoef je
als opties mee te geven.
Er zijn vier instellingen die niet via de GUI zijn in te stellen:
- gpxdir - het volledige pad naar de directory waar alle
informatie in terecht komt: de output van GetCache, maar ook de GPX-bestanden
van de afzonderlijke geocaches die worden gedownload.
- language - de gewenste taal van de GUI.
- gcuser - Optioneel: de usernaam op geocaching.com
- gcpwd - Optioneel: het bijbehorende password op geocaching.com
De laatste twee zijn optioneel: als je dezelfde informatie in de
.georc hebt staan, dan hoef je die niet in de configuratie van GetCache
te zetten.
Licentie
GetCache wordt verspreid onder de GPLv2-licentie. Het staat je vrij om
GetCache aan je eigen wensen aan te passen en verder te distribueren. Als je
een feature toevoegt die voor anderen nuttig zou kunnen zijn, houd ik me
aanbevolen voor een patch!
Contact
Als je vragen of opmerkingen hebt, aarzel dan niet om contact met mij op
te nemen via getcache [at] logrus.nl.
GetCache in het Nederlands
Om de interface van GetCache in het Nederlands te krijgen, moet je de
volgende stappen doorlopen:
- Downloadt de Nederlandse taal-file
en zet die in je home-directory;
- Edit .getcacherc en zet de 'language' op 'dutch'.