subcablemap-dl

README

Submarine Cable Map Downloader

Downloads and combines all tiles for the Telegeography Submarine Cable Map to create a full-resolution image. All maps since 2012 are supported.

Installation

APT (Ubuntu, Debian)

Click to expand

1. If you don't have it already, install the ca-certificates package

   sudo apt install ca-certificates
   

2. Add gabe565 apt repository

   echo 'deb [trusted=yes] https://apt.gabe565.com /' | sudo tee /etc/apt/sources.list.d/gabe565.list
   

3. Update apt repositories

   sudo apt update
   

4. Install subcablemap-dl

   sudo apt install subcablemap-dl
   

RPM (CentOS, RHEL)

Click to expand

1. If you don't have it already, install the ca-certificates package

   sudo dnf install ca-certificates
   

2. Add gabe565 rpm repository to /etc/yum.repos.d/gabe565.repo

   [gabe565]
   name=gabe565
   baseurl=https://rpm.gabe565.com
   enabled=1
   gpgcheck=0
   

3. Install subcablemap-dl

   sudo dnf install subcablemap-dl
   

AUR (Arch Linux)

Click to expand

Install subcablemap-dl-bin with your AUR helper of choice.

Homebrew (macOS, Linux)

Click to expand

Install subcablemap-dl from gabe565/homebrew-tap:

brew install gabe565/tap/subcablemap-dl

Docker

Click to expand

A Docker image is available at ghcr.io/gabe565/subcablemap-dl

Usage

docker run --rm -it -v "$PWD:/data" ghcr.io/gabe565/subcablemap-dl --year=2025

Manual Installation (Windows)

Click to expand

A binary is built for each release. You can either download one of these pre-built release assets, or you can perform a local Go build.

Released Binary

1. Download the latest release for your system and architecture.
2. Extract the binary and place it in the desired directory.

Local Go Build

go install gabe565.com/subcablemap-dl@latest

Usage

To download the 2025 map, run

subcablemap-dl --year=2025

When done, the map will be available at submarine-cable-map-2025.png.

For full command-line reference, see docs.