You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
- Document GSAK database import, GGZ export/send-to-GPS, double-click
to open in browser, Trackables column/tab, custom icon packs,
Support OpenSAK, and the hint-decode-by-default setting
- Remove stale note claiming GGZ export wasn't available yet
- Fix stale 'Last updated June 2026' footer date
<p>Switching from GSAK? You don't have to re-download everything as GPX first. <strong>File → Import from GSAK Database…</strong> reads a GSAK backup ZIP or a raw <code>sqlite.db3</code> file directly, bringing in caches, waypoints, attributes, corrected coordinates, personal notes, trackables, and your <strong>full log history</strong> — not capped the way a GPX/PQ export is.</p>
677
+
<divclass="callout note"><divclass="callout-icon">ℹ️</div><div>Re-importing the same GSAK database is safe — it works the same way as a GPX re-import. Notes containing GSAK's embedded local images are replaced with <code>[image: filename.ext]</code> placeholders, since those files live on your old machine and can't travel with the database.</div></div>
<divclass="callout note"><divclass="callout-icon">ℹ️</div><div>Cache names appear in <strong>bold</strong> when the cache has child waypoints — see the Waypoints tab in the <ahref="#detail-panel">Cache Detail Panel</a>.</div></div>
703
708
704
709
<h3>Clicking a Cache</h3>
705
-
<p>Clicking a row selects the cache: the detail panel updates to show its full information, and the map pans to its pin.</p>
710
+
<p>Clicking a row selects the cache: the detail panel updates to show its full information, and the map pans to its pin.<strong>Double-clicking</strong> a row opens the cache on geocaching.com in your browser — the same as GSAK.</p>
<tr><td>Trackables 🐞</td><td>Number of trackables (travel bugs/geocoins) logged in the cache</td></tr>
734
740
<tr><td>📍</td><td>Corrected coordinates set indicator</td></tr>
735
741
<tr><td>FTF 🥇</td><td>First to Find indicator</td></tr>
736
742
<tr><td>Flag 🚩</td><td>User flag for batch operations</td></tr>
@@ -751,6 +757,7 @@ <h3>Tabs</h3>
751
757
<li><strong>Logs</strong> — recent logs from all finders; includes a search box to find specific entries. Links in log text are clickable.</li>
752
758
<li><strong>Attributes</strong> — all Groundspeak attributes set on the cache (dogs, parking, etc.)</li>
753
759
<li><strong>Notes</strong> — your own free-text notes for this cache, separate from the published description and logs. Round-trips with GSAK: a note survives export → GSAK → re-import.</li>
760
+
<li><strong>Trackables</strong> — travel bugs and geocoins logged in the cache, each with a clickable <code>coord.info</code> link.</li>
754
761
<li><strong>Waypoints</strong> — child waypoints belonging to this cache (e.g. parking, stages), with prefix, type, name, coordinates, description and comment for each. Caches with waypoints show their name in <strong>bold</strong> in the cache list, and the waypoints appear as separate markers on the map when the cache is selected.</li>
755
762
</ul>
756
763
@@ -761,7 +768,7 @@ <h3>Tabs</h3>
761
768
<figcaption>The Hint tab after clicking decode — geocaching.com hints are ROT13-encoded by default.</figcaption>
762
769
</figure>
763
770
764
-
<divclass="callout note"><divclass="callout-icon">ℹ️</div><div>Some hints are stored as plain text rather than ROT13 — OpenSAK detects this automatically and shows the hint directly, without a decode step.</div></div>
771
+
<divclass="callout note"><divclass="callout-icon">ℹ️</div><div>Some hints are stored as plain text rather than ROT13 — OpenSAK detects this automatically and shows the hint directly, without a decode step. Prefer to always see hints decoded? Turn on <strong>Show hints decoded by default</strong> under <ahref="#settings">Settings → Display</a>.</div></div>
765
772
766
773
<h3>Locking a Cache</h3>
767
774
<p>Right-click a cache → <strong>Lock cache</strong>, or check the box in <strong>Edit cache…</strong>. Locking freezes the cache's own fields — name, type, container, coordinates, D/T, owner, status, descriptions, hint, country/state/county — so a later GPX/PQ re-import can't overwrite them. Logs, attributes and waypoints still refresh normally on re-import. A 🔒 column in the cache list shows locked status at a glance, and you can filter on it (see <ahref="#filter-types">All Filter Types</a>).</p>
@@ -1100,9 +1107,12 @@ <h3>Sending to a Garmin Device</h3>
1100
1107
<li>Select <em>Send directly to GPS device</em>.</li>
1101
1108
<li>Click <strong>🔍 Scan</strong> to detect mounted Garmin devices.</li>
1102
1109
<li>Select your device from the list.</li>
1110
+
<li>Choose a format — <strong>GPX</strong> or <strong>GGZ</strong> (see below).</li>
1103
1111
<li>Click <strong>Send</strong>.</li>
1104
1112
</ol>
1105
-
<p>Caches are written to the <code>Garmin/GPX/</code> folder on the device as a standard GPX file.</p>
1113
+
<p>GPX caches are written to the <code>Garmin/GPX/</code> folder on the device; GGZ caches go to <code>Garmin/GGZ/</code>.</p>
1114
+
1115
+
<divclass="callout tip"><divclass="callout-icon">💡</div><div><strong>GPX vs. GGZ:</strong> GGZ is Garmin's compressed format and supports an <strong>unlimited</strong> number of caches in one export — GPX-based transfers are capped by the device. If you have a large database, GGZ is the better choice.</div></div>
1106
1116
1107
1117
<h3>Saving as a GPX File</h3>
1108
1118
<p>Select <em>Save as GPX file</em>, choose a location, and click <strong>Send</strong>. This is useful for devices that are not automatically detected, or for copying to another location.</p>
@@ -1111,27 +1121,27 @@ <h3>Saving as a GPX File</h3>
1111
1121
1112
1122
<h3>Export Options</h3>
1113
1123
<ul>
1124
+
<li>Choose GPX or GGZ format</li>
1114
1125
<li>Choose how many logs per cache to include</li>
1115
1126
<li>Corrected coordinates are exported as the primary coordinate (original stored separately)</li>
<tr><td>GPX</td><td>Full export with descriptions, logs, and waypoints — compatible with most GPS apps</td></tr>
1128
1139
<tr><td>LOC</td><td>Lightweight coordinate-only format for basic GPS devices</td></tr>
1140
+
<tr><td>GGZ</td><td>Garmin's compressed format — unlimited caches per export, matches GSAK's GGZ layout byte-for-byte</td></tr>
1129
1141
</tbody>
1130
1142
</table>
1131
1143
1132
-
<p>All exports use the caches currently visible in the list (respecting the active filter).</p>
1133
-
1134
-
<divclass="callout note"><divclass="callout-icon">ℹ️</div><div><strong>GGZ export (Garmin's native compressed format) is planned but not yet available</strong> — it isn't in this build. Follow <ahref="https://github.com/OpenSAK-Org/opensak/issues/348">issue #348</a> on GitHub for progress.</div></div>
1144
+
<p>All exports use the caches currently visible in the list (respecting the active filter). If a file with the chosen name already exists, you'll be prompted for a new one instead of silently overwriting it.</p>
<tr><td>Coordinate format</td><td>DMM, DMS, or Decimal Degrees — used throughout the interface</td></tr>
1259
1269
<tr><td>Date format</td><td>OS locale, dd.mm.yyyy, mm/dd/yyyy, or yyyy-mm-dd</td></tr>
1260
1270
<tr><td>Text and icon size</td><td>Small, Medium, or Large — affects the cache list grid (font and row height), the detail panel, and the tab labels</td></tr>
1271
+
<tr><td>Show hints decoded by default</td><td>Skip the decode-click and show hints already readable when you open a cache. Off by default (hints start hidden, as before).</td></tr>
1261
1272
<tr><td>Theme</td><td>Automatic (follow OS), Light, or Dark</td></tr>
1262
1273
<tr><td>Language</td><td>Choose UI language (restart required)</td></tr>
1263
1274
</tbody>
@@ -1293,6 +1304,11 @@ <h4>Folders</h4>
1293
1304
<tr><td>Distance calculation method</td><td>Haversine (default) or Vincenty (WGS84) — Vincenty is up to ~0.3% more accurate over long ranges, at a small performance cost</td></tr>
1294
1305
</tbody>
1295
1306
</table>
1307
+
1308
+
<h4>Custom Icon Packs</h4>
1309
+
<p>Want cache-type or found-smiley icons that look different from the bundled set? Click <strong>Open icons folder</strong> to reveal a folder alongside your settings file where you can drop replacement SVG files — no code changes or rebuilding required. File names must match the bundled assets exactly; click <strong>View icon naming guide</strong> for the full list of file names, recommended canvas sizes, and export tips. A missing or invalid custom file automatically falls back to the bundled default — it's never a crash. This folder lives alongside your settings, so it survives future OpenSAK updates.</p>
1310
+
1311
+
<divclass="callout tip"><divclass="callout-icon">💡</div><div>Enjoying OpenSAK? Look for the <strong>♥ Support OpenSAK…</strong> entry in the <ahref="#help">Help menu</a> — it takes you straight to the project's Open Collective page, which covers costs like code signing so releases keep arriving safely.</div></div>
<p>OpenSAK checks for new versions automatically 5 seconds after startup (can be disabled in Settings). When a new version is found, a notification dialog offers three options:</p>
1361
+
<p>OpenSAK checks for new versions automatically 5 seconds after startup (can be disabled in Settings). When a new version is found, a notification dialog offers:</p>
1346
1362
<ul>
1347
1363
<li><strong>Open releases page</strong> — go to GitHub to download</li>
1364
+
<li><strong>♥ Support OpenSAK…</strong> — opens the project's Open Collective page; doesn't affect your update decision, you can still choose one of the other options afterwards</li>
1348
1365
<li><strong>Skip this version</strong> — suppress notifications for this specific version</li>
1349
1366
<li><strong>Later</strong> — dismiss until next launch</li>
1350
1367
</ul>
1351
1368
<p>You can also check manually via <strong>Help → Check for updates…</strong></p>
1369
+
<divclass="callout note"><divclass="callout-icon">ℹ️</div><div>Running a beta version? You're checked against both the latest beta <em>and</em> the latest stable release, and offered whichever is newer — so you'll always hear about a stable release too, not just newer betas.</div></div>
<tr><td>Releases & downloads</td><td><ahref="https://github.com/OpenSAK-Org/opensak/releases">github.com/OpenSAK-Org/opensak/releases</a></td></tr>
1428
1446
<tr><td>Changelog</td><td><ahref="https://github.com/OpenSAK-Org/opensak/blob/v1.15.0/CHANGELOG.md">CHANGELOG.md on GitHub</a></td></tr>
1429
1447
<tr><td>Contributing</td><td><ahref="https://github.com/OpenSAK-Org/opensak/blob/main/CONTRIBUTING.md">CONTRIBUTING.md on GitHub</a></td></tr>
1448
+
<tr><td>Support the project</td><td><ahref="https://opencollective.com/opensak">opencollective.com/opensak</a></td></tr>
<divclass="callout tip"><divclass="callout-icon">💡</div><div>OpenSAK is free and open-source software released under the MIT licence. Contributions of any kind — code, translations, documentation, or testing — are very welcome.</div></div>
0 commit comments