Create your own offline maps for any location on Earth! This tool allows you to download map tiles from various sources and use them in your offline applications, with a special focus on the needs of the Off-Grid, Meshtastic and MeshCore communities.

Download	Offline Mode

Whether you're a hiker, prepper, sailor, or just someone who wants to be prepared, having access to maps when you're disconnected from the internet is crucial. This tool makes it easy to create your own custom map sets for your specific needs.

In a world that's increasingly reliant on internet connectivity, being able to access information offline is a superpower. This is especially true for:

• The Off-Grid Community: When you're living off the grid, you can't rely on a stable internet connection. This tool allows you to have detailed maps of your surroundings, which is essential for navigation, resource management, and safety.
• The Meshtastic and MeshCore Community: This tool allows you to create custom map tiles that can be used with the Meshtastic UI or MeshCore Ripple Firmware, giving you a visual representation of your mesh network on a map, even when you're completely offline.

• Web Interface: A user-friendly web UI for selecting download areas and monitoring progress.
• Polygon & Bounding Box Selection: Define download areas using polygons or bounding boxes.
• Concurrent Downloads: Downloads multiple tiles concurrently for faster performance.
• Rate Limiting: Limits the number of tile downloads per second to avoid overloading the tile server.
• Cancellable Downloads: Cancel ongoing downloads at any time.
• 8-bit PNG Conversion: Option to convert downloaded tiles to 8-bit PNGs, ideal for devices with limited color palettes like the Meshtastic UI and Ripple Firmware.
• Offline Tile Server: Serve downloaded tiles directly from the application, allowing you to use them in offline map applications.
• Cross-platform: Works on Windows, macOS, and Linux.

You can either download a pre-built binary for your operating system or build the application from source.

This project require you to use a command-line interface. Don't worry, it's easier than it looks!

1. Download the offline-map-tile-downloader.exe application for Windows and your CPU architecture. If you are unsure, usually x86_64 will work.
   • x86_64 Intel or AMD 64-Bit CPU
   • arm64 Arm-based 64-Bit CPU
2. Rename it to: offline-map-tile-downloader.exe
3. Press the Windows key + X.
4. Choose "Windows PowerShell".
5. Type cd followed by the path to your your folder where you saved the application (e.g., cd C:\Users\YourName\Documents\OfflineMaps) and press Enter.
6. Type offline-map-tile-downloader.exe and press Enter.
7. Open your web browser and go to http://localhost:8080.

1. Download the offline-map-tile-downloader application for macOS and your CPU architecture.
   • x86_64 Intel 64-bit CPU
   • arm64 Apple silicon 64-bit CPU (M1, M2...)
2. Rename it to: offline-map-tile-downloader
3. Press Command + Space.
4. Type "Terminal" and press Enter.
5. Type cd followed by the path to your folder where you saved the application (e.g., cd /Users/YourName/Documents/OfflineMaps) and press Enter.
6. Type chmod +x offline-map-tile-downloader and press Enter. (This makes the tool work).
7. Type ./offline-map-tile-downloader and press Enter.
8. (Optional) Allow unsigned app on macOS
   1. Go to System Settings
   2. Click on Privacy & Security
   3. Scroll down to Security section
   4. Look for a message about the blocked offline-map-tile-downloader app and click "Open Anyway"
9. Open your web browser and go to http://localhost:8080.

1. Download the offline-map-tile-downloader application for Linux and your CPU architecture.
   • x86_64 Intel or AMD 64-Bit CPU
   • arm64 Arm-based 64-Bit CPU (i.e. Raspberry Pi)
2. Rename it to: offline-map-tile-downloader
3. Open a Terminal.
4. Type cd followed by the path to your your folder where you saved the application (e.g., cd /home/YourName/OfflineMaps) and press Enter.
5. Type chmod +x offline-map-tile-downloader and press Enter. (This makes the tool work).
6. Type ./offline-map-tile-downloader and press Enter.
7. Open your web browser and go to http://localhost:8080.

If you're a developer or want to modify the code, you can build the application from source.

1. Clone the repository:

   git clone https://github.com/Cyclenerd/offline-map-tile-downloader.git
   cd offline-map-tile-downloader

2. Build the application:

   go build .

3. Run the application:

   ./offline-map-tile-downloader

4. Open your web browser and go to http://localhost:8080.

The downloaded map tiles are stored in the local filesystem. The default directory is maps, but you can change this using the -maps-directory command-line option. The tiles are organized by map style, zoom level, and tile coordinates.

You can also use command-line options to configure the application:

• -port: The port number for the server (default: 8080).
• -maps-directory: The directory for cached map tiles (default: maps).
• -max-workers: The number of concurrent download workers (default: 10).
• -rate-limit: The maximum number of tiles to download per second (default: 50).
• -max-retries: The maximum number of retries for downloading a tile (default: 3).
• -help: Show the help message.

Example:

./offline-map-tile-downloader -port 8081 -maps-directory my-tile-cache -max-workers 5 -rate-limit 25

This tool is perfect for creating offline maps for the Meshtastic UI. Here's how to do it:

1. Download the tiles:

   • Select the area you want to download.
   • Crucially, check the "Convert to 8-bit" checkbox. This is required for Meshtastic.
   • Click "Download Tiles".

2. Use with Meshtastic:

   • The downloaded tiles are stored in the maps directory. You can now use these tiles with the Meshtastic UI. For more information on how to do this, please refer to the Meshtastic documentation.

This tool is perfect for creating offline maps for the Ripple Firmware. Here's how to do it:

1. Download the tiles:

   • Select the area you want to download.
   • Check the "Convert to 8-bit" checkbox. This is recommended for the Ripple firmware to save storage space.
   • Click "Download Tiles".

2. Use with Ripple Firmware:

   • The downloaded tiles are stored in the maps directory. You can now use these tiles with the Ripple firmware. Copy the subfolder named after the selected map style to an SD card and rename it tiles. For more information on how to do this, please refer to the MeshRipple Firmware documentation.

You can add your own map sources by editing the config/map_sources.json file. The format is simple:

{
  "Map Source Name": "https://tile.server.url/{z}/{x}/{y}.png",
  "Another Map Source": "https://another.tile.server/{z}/{x}/{y}.png"
}

To activate the change, you must recompile the application.

If you have an idea for a new feature or have found a bug, please open an issue or submit a pull request.

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

The emoji graphics are from the open source project Twemoji. The graphics are copyright 2020 Twitter, Inc and other contributors. The graphics are licensed under CC-BY 4.0. You should review the license before usage in your project.

Leaflet is licensed under the BSD 2-Clause "Simplified" License. See the https://github.com/Leaflet/Leaflet/blob/main/LICENSE file for details.

• Leaflet: For the interactive map interface.
• Gorilla WebSocket: For real-time communication.
• mattdrum: For the original idea and a Python implementation.
• Google Gemini CLI: For providing invaluable assistance with code generation, debugging, and project documentation.