Spoiler Downloader

Einleitung

Das Tool verarbeitet alle in einer lokal vorhandenen GPX-Datei (Pocket Query) enthaltenen Caches, sucht auf www.geocaching.com nach eventuell vorhandenen Spoilerbildern und speichert sie lokal in einem eigenen Verzeichnis. Parallel versieht das Tool die empfangenen Bilder mit den Koordinaten des jeweiligen Caches.
Jetzt kann damit dreierlei gemacht werden:

Falls Du über ein aktuelles Garmin GPS (mit Firmware ab 2012) verfügst, können die Bilder so übertragen werden, dass sie direkt im Cachelisting angeklickt werden können (siehe Snapshots Cachelisting in Garmin Geräten).
Bei Garmin Geräten mit einer Kamera oder allen anderen Geräten (iPhone, Android Mobile), welche Bilder auf einer Landkarte einblenden können, kannst Du die Bilder mit den (automatisch) eingebetteten GPS-Koordinaten an das Gerät übertragen lassen, wo sie anschliessend auf der Karte angeklickt werden können (siehe Snapshots Beispiele der Kartenanzeige).
In allen anderen Fällen können die Bilder ebenfalls an das Gerät geschickt werden; sie müssen dann über einen (beliebigen) Bildbetrachter durchsucht werden. Zur Identifikation der Bilder fügt das Programm in diesem Fall der Bildbezeichnung noch den entsprechenden GC-Code hinzu.

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. 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. Wenn als Ausgabeverzeichnis beispielsweise C:\test angegeben wird, landen die Bilder der GPX-Datei mycaches.gpx in Verzeichnis C:\test\mycaches\

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

Schritt 4
Taste "Download starten" drücken. Da GPS-Koordinaten nur in JPG-Bildern möglich sind, werden eventuell gefundende PNG-Bilder automatisch umgewandelt. Falls eine maximale Bildgrösse angegeben wurde, werden eventuell zu grosse Bilder in diesem Moment auch automatisch verkleinert.

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 damit dreierlei gemacht werden:

Falls Du über ein aktuelles Garmin GPS (mit Firmware ab 2012) verfügst, können die Bilder mit der Taste "In Garmin Bildverzeichnis übertragen" so an das Gerät übermittelt werden, dass sie direkt im Cachelisting angeklickt werden können (siehe Snapshots Cachelisting in Garmin Geräten).
Bei Garmin Geräten mit einer Kamera oder allen anderen Geräten (iPhone, Android Mobile), welche Bilder auf einer Landkarte einblenden können, kannst Du die Bilder mit den (automatisch) eingebetteten GPS-Koordinaten über die Taste "In beliebiges Zielverzeichnis übertragen" an das Gerät übermitteln lassen, wo sie anschliessend auf der Karte angeklickt werden können (siehe Snapshots Beispiele der Kartenanzeige).
In allen anderen Fällen können die Bilder ebenfalls mit der Taste "In beliebiges Zielverzeichnis übertragen" an das Gerät geschickt werden; sie müssen dann über einen (beliebigen) Bildbetrachter durchsucht werden. Zur Identifikation der Bilder fügt das Programm in diesem Fall der Bildbezeichnung noch den entsprechenden GC-Code hinzu.

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 (nur auf dem PC), deren Cache nicht mehr im GPX enthalten ist - also beispielsweise geloggte Caches. Um die verwaisten Bilder auch auf dem GPS zu entfernen, muss das Zielverzeichnis (/garmin/geocachephotos/) dort komplett gelöscht und die Bilder neu übertragen werden.

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).
ACHTUNG: Es werden nur via Listing hochgeladene Bilder verarbeitet (siehe Snapshot). Via HTML eingebettete Bilder (zB von externen Servern) werden nicht berücksichtigt, da sonst alle im Listing enhaltenen Bilder (Icons, Werbung, Banner etc) heruntergeladen würden.

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.

Häufige Fragen (FAQ)

Die Bilder werden auf meinem Navi nicht angezeigt
Das kann - erwartungsgemäss - viele Ursachen haben:

Mit der Taste "Download starten" werden die Bilder nur auf den PC heruntergeladen. Erst mit der zweiten Taste "In Garmin Bildverzeichnis übertragen" findet der Transfer auf das Navi statt.
Die Zuweisung eines Spoilerbildes zu einem bestimmten Cache ist nur auf Garmin Geräten mit einer Firmware ab Januar 2012 möglich.
Die Bilder müssen zwingend im internen Speicher (und nicht auf der SD-Karte) abgelegt werden - dies ist eine Einschränkung der Garmin Firmware.
Beim Übertragen muss das \garmin\ Verzeichnis des Geräts ausgewählt werden; die entsprechenden Unterverzeichnisse werden vom Programm automatisch angelegt!

Mein Navi ist offenbar zu alt (oder von einem anderen Hersteller). Was kann ich tun?
Das Programm versieht die Bilder zusätzlich mit den Koordinaten des Caches. Mit der dritten Taste "In beliebiges Zielverzeichnis übertragen" können die Bilder so trotzdem ans Navi geschickt werden. Viele halbwegs aktuelle Navis zeigen dann die Bilder an der entsprechenden Lokation in der Map (dh auf der Landkarte) an. Bei Garmin Geräten gilt das allerdings nur für Geräte mit eingebauter Kamera.

Die Option "Verwaiste Bilder löschen" funktioniert nicht
Diese Option löscht nur verwaiste Bilder aus dem Zielverzeichnis des PCs! Auf dem PC existiert für jede GPX Datei ein eigenes Verzeichnis, weshalb das Programm verwaiste Bilder entfernen kann. Auf dem Navi ist dies nicht mögllich, da dort die Bilder nicht nach GPX getrennt gespeichert werden können und damit auch Bilder eines anderen GPX gelöscht würden. Um alte Bilder auf dem Navi loszuwerden, kann einfach das ganze Zielverzeichnis (\garmin\GeocachingPhotos\) gelöscht werden - das Programm überträgt anschliessend (mit der zweiten oder dritten Taste) wieder alle aktuellen Bilder auf das Gerät.

Bilder von "Premium Members Only" Caches erscheinen nicht
Die Daten eines "Premium Members Only" Caches können nur nach erfolgtem Login abgerufen werden. In den Optionen muss daher "Auf geocaching.com einloggen" aktiviert werden.

Das Programm ist manchmal sehr langsam
Da Groundspeak die GPX-Version 1.0.2 immer noch nicht freigegeben hat (diese Version würde auch die Links zu den Spoilerbildern enthalten) muss das Programm jedes einzelne Listing herunterladen und nach Spoilerbildern durchsuchen. Die Geschwindigkeit des Programms ist ausschliesslich von der Internet-Verbindung und der Auslastung von www.geochaching.com abhängig.

Download / History

Version 1.24 (Download) (23.03.13)

Fix: Bei Listings mit eingebetteten Bildern ab img.geocaching.com und einem nachfolgenden Link (zB zum Geochecker) wurde - je nach Design des Listings - das erste aufgeführte Bild unter Umständen nicht heruntergeladen.

Version 1.23 (Download) (08.01.13)

Mit der Umstellung des HTML-Parsers in Version 1.22 werden nun auch im Listing eingebettete Bilder heruntergeladen, sofern diese vom Owner auf dem Server von Groundspeak gespeichert worden sind. Fix: Je nach Art und Weise der Einbettung wurde eventuell eine Nonsense-Bildbeschreibung eingesetzt. Diese Bilder erhalten nun die Beschreibung "Kein Text".

Version 1.22 (Download) (31.12.12)

Erweiterung der Befehlszeilenparameter, sodass auch ZIP-Dateien direkt via "Öffnen mit..." ausgeführt werden können - sowie zwei neue Parameter /start1 und /start2, um die heruntergeladenen Bilder direkt ans GPS-Gerät senden zu können. /start1 führt anschliessend automatisch den Transfer in das Garmin-Bilderverzeichnis durch und /start2 den Transfer in das letzte "beliebige" Verzeichnis. Die vollständige Syntax der Befehlszeile sieht nun so aus:
RCH65SpoilerDownloader.exe [GPX-Datei|ZIP-Datei] [/de|/en] [/start1|/start2]
Fix: Der HTML-Parser wurde grundsätzlich überarbeitet, da es immer noch Konstellationen geben konnte, wo nicht alle Bilder erkannt werden konnten.

Version 1.21 (Download) (21.11.12)

Fix (WICHTIG!): Seit einem kürzlichen Redesign der Geocaching WebSite wurde das erste Bild gegebenenfalls nicht heruntergeladen

Version 1.20 (Download) (08.11.12)

Es ist nun möglich, heruntergeladene ZIP-Dateien direkt zu öffnen - die GPX-Datei muss vorgängig nicht mehr manuell entpackt werden. Hinweis: Die darin enthaltene GPX-Datei muss jedoch den gleichen Namen wie die ZIP-Datei aufweisen. In der Definition des Pocket Queries muss hierzu die Option 'Include Pocket Query name in download file name' aktiviert werden.
Gewisse häufig verwendete Auswahlen des Menus haben nun einen CTRL-Shortcut erhalten.
Fix: Durch gewisse Programm erzeugte XML-Dateien können nicht erlaubte Steuerzeichen enthalten, womit die XML Datei ungültig wird. Der XML-Parser zeigt nun solche Fehler (inklusive Zeilennummer) an, sodass das Problem gegebenenfalls manuell beseitigt werden kann.

Version 1.19 (27.08.12)

Fix: Das Programm stürzte bei der Verarbeitung von - durch andere Tools erzeugten - GPX-Dateien ab wenn dieses denselben Waypoint mehrfach in die GPX Datei geschrieben hatte
Fix: Mit gewissen IE Versionen funktionierte das neue Login (1.0.18) nicht korrekt

Version 1.18 (16.08.12)

Fix (WICHTIG!): Seit einem kürzlichen Redesign der Geocaching WebSite wurde das erste Bild gegebenenfalls nicht heruntergeladen
Offenbar geht es mit der Freigabe der GPX Version 1.0.2 nicht so zügig voran, weshalb man sich im Spoiler Downloader (wahlweise) auch mit seinem Profil einloggen kann, sodass das Programm nun auch Premium Members Only Caches vearbeiten kann - natürlich nur, sofern Ihr auch Premium Members seid

Version 1.17 (01.07.12)

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).
Das Tool lädt nun auch Spoilerbilder im PNG-Format herunter und wandelt diese vor dem Speichern automatisch ins JPG Format um
Der Kopiervorgang berücksichtigt neben Bildern mit Prefix GC* nun auch Bilder mit Prefix OC* und OX*, welche über alternative Wege von opencaching.com heruntergeladen wurden

Version 1.16 (06.06.12)

Eine weitere (dritte) Taste ermöglicht das Übertragen der Bilder in ein eigenes Verzeichnis des Geräts. Dies ist bei Geräten sinnvoll, welche die Funktion zur Anzeige der Bilder im Cachelisting nicht unterstützen. Die Bilder können dann entweder auf der Landkarte angeklickt (nur Geräte mit eingebauter Kamera) oder aber über den Bildbetrachter angezeigt werden
Beim Kopieren der Bilder wird der freie Speicherplatz auf dem Gerät laufend überprüft. Sobald weniger als 20MB verfügbar sind, wird der Kopiervorgang beendet

Version 1.15 (31.05.12)

Fix: Aus GSAK exportierte GPX-Dateien in der Version 1.1 konnten nicht verarbeitet werden

Version 1.14 (01.05.12)

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. Ungültige Sondernzeichen (Stern, Fragezeichen etc) werden aus dem Dateinamen entfernt.
Ü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.

Ab Version 1.12 des Tools wird die kommende GPX Version 1.0.2 unterstützt, 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 nur nach erfolgtem Login verarbeitet werden können. Das Tool erkennt eine GPX Version 1.0.2 selbständig und wechselt dann automatisch 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.

Version 1.11 (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 (siehe Snapshot rechts).
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 (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)