Geocaching Friends Logs

A browser extension that displays your friends' geocaching logs at the top of every cache listing page. Never scroll through hundreds of logs again — instantly see which friends have visited a cache and what they thought about it.

Features

• Friends logs first — Your friends' logs appear at the top of cache pages
• Your own logs — Optionally display your own logs separately
• Configurable limits — Choose to show 5, 10, 20, 50, or 100 friend logs
• Clean design — Matches the native Geocaching.com interface
• Privacy-focused — No data collection, all preferences stored locally

Installation

Browser Extension Stores (Recommended)

• Chrome: Chrome Web Store
• Firefox: Firefox Add-ons
• Edge: Edge Add-ons
• Opera: Opera Add-ons
• Brave: Install from the Chrome Web Store (Brave supports Chrome extensions natively)

Manual Installation

Chrome (incl. Brave) / Edge / Opera

1. Download the latest release for your browser from the Releases page
   • For Brave, download the Chrome/Chromium release zip.
2. Unzip the file
3. Open your browser's extension page:
   • Chrome: chrome://extensions
   • Edge: edge://extensions
   • Opera: opera://extensions
   • Brave: brave://extensions
4. Enable "Developer mode" (toggle in top right)
5. Click "Load unpacked" and select the unzipped folder

Firefox

1. Download the Firefox .xpi file from the Releases page
2. Open Firefox and navigate to about:addons
3. Click the gear icon and select "Install Add-on From File..."
4. Select the downloaded .xpi file

Usage

1. Visit any geocache page on Geocaching.com
2. Your friends' logs will automatically appear at the top of the logs section
3. Click the extension icon to customize settings:
   • Toggle your own logs visibility
   • Toggle friends logs visibility
   • Set the maximum number of friend logs to display

Development

Prerequisites

• Node.js 18+
• npm

Setup

# Clone the repository
git clone https://github.com/rfsbraz/Geocaching.com-Friends-Logs.git
cd Geocaching.com-Friends-Logs

# Install dependencies
npm install

Commands

# Run linting
npm run lint

# Fix linting issues
npm run lint:fix

# Check formatting
npm run format:check

# Fix formatting
npm run format

# Validate build
npm run build

# Create extension zip
npm run build:zip

Loading for Development

1. Run npm run build to validate the extension
2. Open your browser's extension page:
   • Chrome: chrome://extensions
   • Edge: edge://extensions
   • Firefox: about:debugging#/runtime/this-firefox
   • Opera: opera://extensions
   • Brave: brave://extensions
3. Enable "Developer mode" (not required for Firefox)
4. Click "Load unpacked" (or "Load Temporary Add-on" in Firefox) and select the project folder
5. Make changes and reload the extension to see updates

Contributing

Contributions are welcome! Please read our Contributing Guide for details on how to submit pull requests.

Security

For security concerns, please see our Security Policy.

License

This project is licensed under the MIT License — see the LICENSE file for details.

Acknowledgments

• iCheck for the checkbox styling
• All the geocachers who provided feedback and feature requests

Support

If you find this useful and want to support development, you can buy me a coffee - no pressure at all, just a nice way to say thanks.