fast-cli

README

fast-cli

fast-cli estimates your current internet download and upload speed using Netflix's fast.com service, similar to the fast.com website.

Originally created by Gus Esquivel (gesquive/fast-cli). This fork modernizes the toolchain (go modules, GitHub Actions) and adds feature parity with the fast.com website: upload speed, unloaded/loaded latency, client/server info, a configurable test duration, a live sparkline, and --count/--bytes/--json flags.

Installing

Compile

This project requires go 1.22+ to compile.

git clone https://github.com/Mr-MyDooM/fast-cli.git
cd fast-cli
make build

Or install directly with go:

go install github.com/Mr-MyDooM/fast-cli@latest

Optionally you can run make install to build and copy the executable to /usr/local/bin/ with correct permissions.

Download

Alternately, you can download the latest release for your platform from github.

Once you have an executable, make sure to copy it somewhere on your path like /usr/local/bin or C:/Program Files/. If on a *nix/mac system, make sure to run chmod +x /path/to/fast-cli.

Usage

fast-cli estimates your current internet download and upload speed by performing a series of transfers to/from Netflix's fast.com servers.

Usage:
  fast-cli [flags]

Flags:
  -b, --bytes          Display speed in bytes per second instead of bits per second
  -c, --count uint     Number of parallel connections to use (1-8) (default 3)
  -d, --duration int   Test duration in seconds, per direction (5-30) (default 10)
  -h, --help           help for fast-cli
      --json           Output the result as JSON
  -n, --no-https       Do not use HTTPS when connecting
      --no-upload      Skip the upload speed test
  -s, --simple         Only display the result, no dynamic progress bar
      --version        Display the version number and exit

Each run reports:

• Client/server info — your IP, ISP, city/country, and the CDN edge server(s) assigned for the test
• Download speed — with a live sparkline and percent-of-duration progress
• Latency — both unloaded (before any transfer starts) and loaded (measured while the download is saturating the link)
• Upload speed — same live sparkline, skip with --no-upload Optionally, a hidden debug flag is available in case you need additional output.

Hidden Flags:
  -D, --debug                  Include debug statements in log output

Documentation

This documentation can be found at github.com/Mr-MyDooM/fast-cli

License

This package is made available under an MIT-style license. See LICENSE.

Contributing

PRs are always welcome!