Spoiler Downloader

Einleitung

Das Tool verarbeitet alle in einer lokal vorhandenen GPX-Datei (Pocket Query) enthaltenen Caches und sucht auf www.geocaching.com nach eventuell vorhandenen Spoilerbildern. Anschliessend versieht das Tool die empfangenen Bilder mit den Koordinaten des jeweiligen Caches! Wenn Ihr die Bilder dann auf dem GPS-Gerät speichert (idealweise auf der SD-Karte), werden sie in der Map am korrekten Ort eingeblendet, wo sie angeklickt und angezeigt werden können (siehe Snapshots Beispiele der Kartenanzeige).

NEU: Über die neue Taste In Garmin Bildverzeichnis übertragen können die Bilder speziell organisiert in das '\Garmin\GeocachePhotos\' Verzeichnis des Geräts übertragen werden. Auf Garmin Geräten mit einer aktuellen Firmware werden die Bilder damit automatisch dem richtigen Cache zugeordnet und können anschliessend im Listing des Caches auf Tastendruck angezeigt werden (siehe Snapshots Cachelisting in Garmin Geräten).

Wer ohne Smartphone unterwegs ist oder im Ausland die Roaming-Gebüren nicht bezahlen will, hat dann alles "offline" dabei. Durch die GPS-Tags entfällt auch das Blättern durch Hunderte von lokal gespeicherten Spoilerbildern.

Voraussetzung ist allerdings ein Navi, welches damit umgehen kann (siehe Geräte). Das Tool läuft ab Windows XP (XP, Vista, 7).

Das Tool kann frei verwendet und weitergegeben werden. Ich bitte Euch jedoch, die Installationsdatei nicht auf andere Server hochzuladen!

Schritt für Schritt...

Schritt 1
GPX von www.geocaching.com herunterladen (oder aus GSAK exportieren)

Schritt 2
Unter Optionen->Ausgabepfad festlegen einmalig ein Ausgabeverzeichnis auswählen (zB den Desktop). Das Tool erstellt dort ein neues Verzeichnis mit dem Namen der GPX-Datei, welches anschliessend die Spoilerbilder für dieses GPX enthalten wird.

Schritt 3
Unter Datei->GPX Datei laden die gewünschte GPX-Datei auswählen.

Schritt 4
Ausführen

Schritt 5
Nach erfolgtem Download sind die Bilder auf dem lokalen PC gespeichert. Falls eine maximale Bildgrösse angegeben wurde, sind die Bilder nun bereits verkleinert vorhanden.

Schritt 6
Nun kann mit diesen Bildern zweierlei gemacht werden:

Die Bilder können manuell in ein beliebiges Verzeichnis des GPS-Geräts übertragen werden, womit sie anschliessend am korrekten Ort als Symbole auf der Landkarte erscheinen... (siehe Beispiele der Kartenanzeige)
...oder die Bilder werden über die Taste In Garmin Bildverzeichnis übertragen speziell strukturiert an das Gerät übermittelt, womit sie mit dem Cache "verbunden" werden und direkt im Listing angezeigt werden können (siehe Cachelisting in Garmin Geräten)

Der Download kann übrigens durch einen Klick in das Statusfeld rechts unten ("Läuft...") unterbrochen beziehungsweise abgebrochen werden.

Optionen

Verwaiste Bilder löschen
Ist diese Option aktiviert, so löscht das Programm Spoilerbilder aus dem Verzeichnis, deren Cache nicht mehr im GPX enthalten ist (also beispielsweise geloggte Caches).

Bildauswahl
Mit Alle Bilder werden jeweils alle im Cache-Listing aufgeführten Bilder heruntergeladen (jedoch keine Bilder aus Logs). Auswahl Nur Spoilerbilder wählt nur Bilder aus, in deren Beschreibung eines der definierten Schlüsselworte vorkommen; diese können selbst festgelegt werden (siehe Snapshot rechts). Hinweis: Bis Version 1.10 waren diese Schlüsselworte fix im Programm definiert: Spoiler, Hinweis, Hint, Hilfe, Help

Bildoffset
Mit Kein Offset werden in den Bildern die exakten Cachekoordinaten gespeichert. Dies ist grundsätzlich die bevorzugte Option - kann jedoch auf gewissen GPS-Geräten zu Missverständnissen führen, wenn sich das Cache-Icon und die Icons der Spoilerbilder optisch überlagern. Die verschiedenen Offset-Stufen verschieben die Spoilerbilder jeweils wählbar um ca 11 Meter bis ca 55 Meter nach Süden, sodass sie auf der GPS-Karte etwas weiter südlich angezeigt werden. Dies ist natürlich nur der Fall, wenn genügend tief in die Karte gezoomt wird - in der Kartenübersicht reichen auch 55 Meter nicht aus, um das Icon nennenswert zu verschieben. Wenn ein Cache mehrere Spoilerbilder enthält, überlagern sich diese Icons nach wie vor - sollten aber auf jedem Navi problemlos ausgewählt werden können.

Cacheauswahl
Auswahl Alle Caches prüfen überprüft jeweils alle im GPX enthaltenen Caches auf Spoilerbilder. Mit Auswahl Nur Caches ohne lokales Bild prüfen überprüft das Tool nur Caches, für die noch keine Spoilerbilder im Ausgabeverzeichnis vorliegen, was die Laufzeit bei einem erneuten Programmstart verkürzen kann. Mit Auswahl Nur neue Caches prüfen werden nur Caches verarbeitet, die noch nie überprüft worden sind. Bei wiederholten Programmstarts über das gleiche GPX reduziert dies die Laufzeit dramatisch; birgt jedoch das Risiko, dass neu hinzugefügte Spoilerbilder nicht entdeckt werden.

Verzögerung (zwischen Caches)
Über diese Option kann eine künstliche Verzögerung zwischen der Prüfung der einzelnen Caches aktiviert werden, um die "Spider-Detection" des Webservers zu umgehen. Bei exzessiver Benützung des Webservers kann der Betreiber gegebenenfalls einzelne Accounts ausschliessen. Dies ist in diesem Fall zwar ziemlich unwahrscheinlich (da keine Logindaten übermittelt werden) - aber wer auf Nummer sicher gehen will, kann diese Option aktivieren.

Fehlermeldungen anzeigen
Standardmässig werden während des Downloads aufgetretene Fehler angezeigt. Falls das Programm aber unbeaufsichtigt arbeiten soll, kann die Anzeige auch ausgeschaltet werden.

Download / History

Version 1.20 (Beta) (10.05.12)

Diese Version des Tools wird die kommende GPX Version 1.0.2 unterstützen, in welcher die Links zu den Bildern eines Caches bereits enthalten sind. Der ganze Download wird sich damit massiv verschnellern, da nun nicht mehr jedes einzelne Cachelisting heruntergeladen werden muss. Damit entfällt übrigens auch die Einschränkung, dass "Premium Members Only" Caches nicht verarbeitet werden können. Das Tool erkennt eine GPX Version 1.0.2 selbständig und wechselt dann in den neuen Verarbeitungsmodus. Die Optionen im Menu Cacheauswahl werden dabei automatisch deaktiviert, da nun jeweils jeder Cache ohne Zeitverlust geprüft werden kann. Details für technisch Interessierte sind im Groundspeak Forum zu finden.
Die Bilder können wahlweise in das "normale" Bildverzeichnis (wie bisher) oder in das Spoiler-Bildverzeichnis übertragen werden (Spoilerbilder sind auf dem Navi erst nach einem weiteren Klick sichtbar). Über die zusätzliche Auswahl Abhängig vom Bildtyp werden Spoilerbilder in das Spoiler-Bildverzeichnis und alle anderen Bilder in das "normale" Bildverzeichnis kopiert (diese Auswahl ist natürlich nur zusammen mit Bildauswahl Alle Bilder sinnvoll).
Mechanismus zur (manuellen) Prüfung auf Updates.
Fix: Bilder mit gleichlautenden Namen (bzw Bildbeschreibungen) werden automatisch mit (1), (2) etc ergänzt, sodass keine doppelten Dateinamen auftreten.
Fix: Dateinamen mit eingebetteten HTML-Codes werden nun korrekt dargestellt
Über eine neue Auswahl im Menu Extras kann auch gleich die GPX Datei auf das Navigationsgerät übertragen werden.
The GUI language will automatically switch to english on all non-german systems. In addition, you may use the /en commandline option to manually switch to the english GUI.

Version 1.11 (Download) (11.02.12)

Um den internen Speicher des GPS-Geräts zu schonen, können die Bilder beim Download wahlweise auf eine maximale Breite/Höhe verkleinert werden.
Die Suchtexte für die Erkennung von Spoilerbildern (Spoiler, Hint, Hilfe etc) können selbst festgelegt werden.
Neue Funktionen zur Anzeige des Garmin Bildverzeichnisses via Windows Explorer (Kontrolle, Reorganisaion der Bilder etc) und zur Anzeige des aktuellen Ausgabeverzeichnisses
Der Prefix GCxxxxx_ wird beim Übertragen der Bilder in das Bildverzeichnis entfernt, sodass auf dem Gerät mehr Platz für die Anzeige der Beschreibung zur Verfügung steht.
Über die Popup-Auswahl "Öffnen mit..." der Windows Oberfläche kann neu der Spoiler Downloader ausgewählt werden. Anschliessend startet er automatisch mit der ausgewählten GPX-Datei.
Fix: Beim Schliessen des Fenster während des Downloads wurde eine Fehlermeldung angezeigt.
Fix: Die Auswahl "Fehlermeldung anzeigen" wurde nicht immer korrekt berücksichtigt

Version 1.10 (Download) (02.02.12)

Die neue Funktion In Garmin Bildverzeichnis übertragen überträgt die Bilder des aktuellen Ausgabeverzeichnisses speziell strukturiert in das \Garmin\GeocachePhotos\ Verzeichnis des Geräts. Auf Garmin-Geräten mit einer aktuellen Firmware (zB Oregon x50 ab V5.30) werden die Bilder automatisch dem richtigen Cache zugeordnet und können im Listing des Caches auf Tastendruck angezeigt werden (siehe Snapshots Cachelisting in Garmin Geräten).
Deutsche Oberfläche

Version 1.09 (08.01.12)

Fix: Bei Bildern mit korrupten EXIF-Tags (in der Regel durch die verwendete Kamera erzeugt) wurden die Geo-Tags unter Umständen nicht hinzugefügt, sodass die Spoilerbilder keine Koordinaten enthielten. Die Schnittstelle zum Schreiben der Geodaten ignoriert nun solche Fehler, sodass auch diese Bilder korrekte Geodaten erhalten.
Fix: Es werden nur noch Caches mit einer ID im üblichen Format GCxxxxxx verarbeitet, sodass bei GPX-Dateien, welche auch noch Wegpunkte enthalten, keine Fehlermeldungen bei der Verarbeitung dieser Wegpunkte mehr angezeigt werden.

Version 1.08 (28.12.11)

Diese Version umgeht das Problem, dass auf www.geocaching.com seit geraumer Zeit auf stark verkleinerte Bilder referenziert wird. Das Programm korrigiert die fehlerhafte URL, sodass das Bild in der Originalgrösse heruntergeladen wird.
Neue Option Bildoffset damit die Bildkoordinaten leicht von den Cachekoordinaten abweichen, sodass sich auf dem GPS-Gerät Cache-Icon und Spoiler-Icon nicht überlagern (Beschreibung siehe unten).

Version 1.07 (08.12.11)

Bei der Auswahl Nur Spoilerbilder werden neu auch Bilder mit den Wortfragmenten Hinweis, Hint, Hilfe, Help berücksichtigt.
Fix: Bei Auswahl Alle Bilder konnte bei Caches ohne ein einziges Bild eine Fehlermeldung angezeigt werden.

Version 1.06 (17.09.11)

Fix für Groundspeak Website Update vom 15. September 2011

Version 1.05

Neuer Installer
Zusätzliche Optionen
Multithreaded

Version 1.04

Fix: Fehlemeldung dass Datei cachelist.dat fehlt

Geräte

Diese Geräte können Bilder mit GPS-Metadaten in einer Kartenübersicht anzeigen:

Garmin Oregon x50
Garmin Montana x50
Garmin nüvi 3790t
Garmin GPSMap 62
Garmin eTrex 20
Garmin Dakota 20
Apple iPhone/iPod (Fotos -> Orte)
Android Smartphones (Picture Map App)
...weitere...?

Die Anzeige von Spoilerbildern direkt im Listing des Caches wird momentan nur von Garmin Geräten mit einer Firmware ab Januar 2012 unterstützt.

Bekannte Probleme

Das Tool kann keine Spoilerbilder von "Premium Members only" Caches herunterladen, da dies ein Login voraussetzen würde. Diese Einschränkung wird mit der Unterstützung von GPX 1.0.2 wegfallen.
Wenn verschiedene Spoilerbilder (eines Caches) denselben Text aufweisen, wird nur das erste Bild heruntergeladen, da ausschliesslich GC-Code und Text den Dateinamen auf dem Zielsystem bestimmen.