Skip to content

Latest commit

 

History

17 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

WinMTR 2.0

WinMTR 2.0 is a lightweight Windows network diagnostic tool that combines traceroute-style path discovery with continuous ping statistics.

This version adds a practical command-line experience similar to Linux mtr, per-hop ASN lookup, IPv4/IPv6 selection, and a native Windows GUI with system-following dark mode.

Features

  • Live CLI mode by default when a target host is passed on the command line
  • In-place terminal refresh with Ctrl+C stop support
  • Optional bounded runs with cycle or duration limits
  • Per-hop ASN lookup in CLI, copied text reports, and exported reports
  • IPv4 and IPv6 selection with -4 and -6
  • GUI mode for classic WinMTR usage
  • Native Windows light/dark appearance for the GUI
  • Text and HTML export support

Requirements

  • Windows 7 or newer
  • Visual Studio with C++ and MFC support for local builds
  • A modern Windows SDK and C++ toolset

CLI Usage

WinMTR runs in CLI mode whenever you launch it from a terminal with a target host. Use --gui only when you explicitly want the desktop GUI.

WinMTR.exe google.com
WinMTR.exe bgp.tools -4
WinMTR.exe bgp.tools -6
WinMTR.exe --numeric example.com
WinMTR.exe --report-cycles 10 1.1.1.1
WinMTR.exe --report-seconds 30 --numeric example.com
WinMTR.exe --gui example.com

Supported options:

  • -h, --help: show help
  • -g, --gui: force GUI mode
  • -r, --report: run in CLI live-report mode
  • -c, --report-cycles <count>: stop after a fixed number of cycles
  • -w, --report-seconds <seconds>: stop after a fixed duration
  • -i, --interval <seconds>: set probe interval
  • -s, --size <bytes>: set ICMP payload size
  • -n, --numeric: disable reverse DNS lookups
  • -4, --ipv4: force IPv4
  • -6, --ipv6: force IPv6

GUI Usage

Launching WinMTR.exe without command-line arguments opens the GUI directly without showing a console window.

The GUI follows the Windows app light/dark setting where supported, including the main controls, status bar, and results table header.

Use this form if you want to open the GUI with a pre-filled target from a terminal:

WinMTR.exe --gui example.com

Build

Open src\WinMTR.sln in Visual Studio, or build from a Developer PowerShell:

MSBuild.exe src\WinMTR.sln /t:Build /p:Configuration=Release /p:Platform=x64

The release binary is written to:

src\Release_x64\WinMTR.exe

Automated Builds and Releases

  • Pull requests targeting main build x64 and x86 ZIPs, available as workflow artifacts.
  • Every push to main, including a merged pull request, builds both architectures and creates a separate GitHub release tagged main-build-<run number> at the exact commit built. Publishing runs only after both builds succeed. Re-running the same workflow run updates that run's release.
  • Pushing a v* tag or publishing a release builds and attaches ZIPs to that versioned release.
  • Running the workflow manually on a branch builds artifacts only; running it on a tag also publishes release assets.

CI uses the Windows Server 2022 runner with Visual Studio 2022 and the v143 toolset so the compiler and installed MFC libraries match.

Credits

License

WinMTR 2.0 is distributed under the GNU General Public License version 2. See LICENSE.

About

Fork of WinMTR Redux by adding cli and ASN lookup support

Resources

Stars

7 stars

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages