v0.1.0-beta.5: support options in the app, a redacted sample trace, and fuller docs

Install

• Windows 10/11: download routemap-<version>-windows-x86_64.zip, extract it, and run routemap.exe in the Route Map folder (keep the folder together; routemap-cli.exe beside it is the command line). The Windows build is not code-signed yet (signing through SignPath Foundation is pending): SmartScreen says "Windows protected your PC"; choose More info, then Run anyway.
• macOS 12+: open the .dmg for your Mac (macos-arm64 for Apple silicon,
  macos-x86_64 for Intel) and drag Route Map to Applications. The app is not
  notarised yet, so Gatekeeper blocks the first start: right-click it,
  choose Open, then Open again (on macOS 15, System Settings > Privacy &
  Security > Open Anyway). Or: xattr -d com.apple.quarantine "/Applications/Route Map.app".
• Linux x86_64: chmod +x the .AppImage and run it, or unpack the
  .tar.gz and run ./routemap. Tracing needs traceroute installed.

Verify a download: import the release key (RELEASE-KEY.asc) with gpg --import, then gpg --verify SHA256SUMS.asc SHA256SUMS (key D57C 7E26 C19F 9436 E2D6 6F37 4080 97D1 91DD F981), then sha256sum -c SHA256SUMS --ignore-missing (Linux), shasum -a 256 -c SHA256SUMS --ignore-missing (macOS), or Get-FileHash <file> in PowerShell.

Problems or ideas: open an issue.

---

Changed

• Help > Support Route Map lists the ways to support the project, in
  order: Ko-fi, PayPal, Bitcoin and Monero, with the addresses selectable and
  copyable. It opens only when you choose it. GitHub Sponsors is gone.
• Contact: support@getroutemap.app, in Help > About and Help > Privacy.
• The bundled sample trace no longer shows the maintainer's home network: the
  router, LAN, carrier-NAT and first ISP hops carry documentation addresses
  (192.0.2.0/24, 198.51.100.0/24, 203.0.113.0/24).
• Settings: the cache line now covers both caches, Hoiho and the IP
  database, and counts both.
• The engine comes from PyPI (routemap-engine 0.2.1, the same code as
  before).
• Documentation: a fuller user guide (exports, paste mode, settings, RIPE
  Atlas), troubleshooting, known limitations and a FAQ. Corrected: mtr --json
  output was never supported; mtr --report is.

v0.1.0-beta.4: open source, Windows as a scanned zip, and the project site

Install

• Windows 10/11: download routemap-<version>-windows-x86_64.zip, extract it, and run routemap.exe in the Route Map folder (keep the folder together; routemap-cli.exe beside it is the command line). The Windows build is not code-signed yet (signing through SignPath Foundation is pending): SmartScreen says "Windows protected your PC"; choose More info, then Run anyway.
• macOS 12+: open the .dmg for your Mac (macos-arm64 for Apple silicon,
  macos-x86_64 for Intel) and drag Route Map to Applications. The app is not
  notarised yet, so Gatekeeper blocks the first start: right-click it,
  choose Open, then Open again (on macOS 15, System Settings > Privacy &
  Security > Open Anyway). Or: xattr -d com.apple.quarantine "/Applications/Route Map.app".
• Linux x86_64: chmod +x the .AppImage and run it, or unpack the
  .tar.gz and run ./routemap. Tracing needs traceroute installed.

Verify a download: import the release key (RELEASE-KEY.asc) with gpg --import, then gpg --verify SHA256SUMS.asc SHA256SUMS (key D57C 7E26 C19F 9436 E2D6 6F37 4080 97D1 91DD F981), then sha256sum -c SHA256SUMS --ignore-missing (Linux), shasum -a 256 -c SHA256SUMS --ignore-missing (macOS), or Get-FileHash <file> in PowerShell.

Problems or ideas: open an issue.

---

Changed

• Route Map is free and open source under the GNU AGPL-3.0, and its
  repository is public. Contributions are welcome under a Contributor Licence
  Agreement (CLA.md, CONTRIBUTING.md). No licence key is needed.
• Releases are on GitHub Releases, with a GPG-signed SHA256SUMS.
• Windows: a zip instead of a single exe. Extract it and run routemap.exe
  in the Route Map folder; routemap-cli.exe is beside it. beta.3's
  one-file exe, which unpacked itself at start, was deleted by Microsoft
  Defender on download as a false positive. Both exes now carry full version
  information and an application manifest, no packer is used, and every
  Windows build is scanned with Defender before release. The Windows build is
  still unsigned; signing through SignPath Foundation is applied for.
• Help > Support Route Map opens the project's sponsor page (nothing else, and
  never on its own). Help > About links the project site.
• Help > Privacy and PRIVACY.md now spell out everything an Atlas trace sends.

v0.1.0-beta.1: the desktop app, first beta for macOS, Windows and Linux

The first desktop build, for trying on real machines. Not code-signed yet.

Added

• The desktop app on macOS (Apple silicon and Intel), Windows and Linux: trace
  from this machine with the system's own tracert, traceroute or mtr, with the
  tool's output streaming into the window, then the route on an offline world
  map and in a sortable, copyable hop table, with unplaced hops and their reasons.
• Paste or open a trace run elsewhere; open a JSON export again.
• Exports: a 1600 x 900 PNG of the whole route with legend and provenance; a PDF
  report with the facts of the trace, the map, the hop table, unplaced hops, how
  locations were decided and the raw trace as an appendix; the JSON route model
  with the trace text, tool and flags.
• Origin from the public IP (city level, labelled approximate), or set in
  Settings by city search (offline), coordinates or a click on the map.
• Settings for the trace tool and flags (probe types that need administrator
  rights are flagged, never escalated), each network source, the Hoiho cache
  lifetime, RIPE Atlas and history. Everything is kept in one config folder.
• Optional RIPE Atlas traces with your own key, after a one-time
  acknowledgement that Atlas measurements are public.
• History of the last 50 traces, off by a setting.
• The command line: routemap TARGET with --json, --png, --pdf and
  --origin; routemap parse, routemap sites update, routemap cache clear,
  routemap --check-update.
• Builds: a .dmg per Mac architecture (ad-hoc signed so it runs on Apple
  silicon), a Windows .exe, a Linux AppImage and .tar.gz, each smoke-tested in
  CI by opening the window offscreen, loading a trace and exporting all three
  formats.

Earlier, toward this beta

• The Route Map engine, extracted from FalconEye v3.35.3 into
  routemap.engine: the tracert, traceroute and mtr parsers, PTR resolution,
  the CAIDA Hoiho client, the carrier site-code table and its generator, the
  bundled GeoNames city list, the RIPEstat IP geolocation fallback, the RTT
  physics bound, the hop annotations and ECMP handling. Behaviour is unchanged;
  FalconEye v3.36.0 runs its Route Map tab on this package.
• analyse(trace_text | hops, origin) -> Route, with every network source
  passed in as a Sources value rather than read from configuration, a
  per-source progress callback, and geo.OFFLINE for a run that contacts
  nothing.
• Route.to_dict() and its JSON Schema, routemap/engine/route.schema.json.
• run_trace(target, options): runs the system tracert, traceroute or mtr
  with an argument list (never a shell), streams output line by line, and
  supports cancel and a timeout.
• Pluggable Hoiho answer caches: none, in memory, or one SQLite file.
• routemap parse FILE on the command line.
• The desktop window, as a static mockup for review: the offline Natural Earth
  1:50m world map (public domain, about 114 KB bundled), route markers that
  collapse same-city hops, unwrap across the antimeridian and move aside with
  a leader line when they would overlap, the sortable hop table, unplaced hops
  with reasons, live trace output, history, settings, export, paste and RIPE
  Atlas dialogs, light and dark. python -m routemap.gui.mockup renders every
  state from real recorded traces.

Tagged

• v0.1.0.dev1 (2026-10-03): the engine extraction FalconEye v3.36.0 pins.

---

This build is not signed yet

Code signing arrives before 0.1.0. Until then your system will warn you:

• macOS (.dmg): drag Route Map to Applications. The first time, right-click
  it and choose Open, then Open again; or run
  xattr -d com.apple.quarantine "/Applications/Route Map.app". This is expected
  for an app that is not yet notarised by Apple.
• Windows (.exe): SmartScreen says "Windows protected your PC". Choose
  More info, then Run anyway.
• Linux (.AppImage or .tar.gz): chmod +x the file and run it. Check
  it against SHA256SUMS with sha256sum -c SHA256SUMS --ignore-missing.

Each binary is 60 to 110 MB because it carries its own copy of Qt.