Skip to content

Technolog796/Internometr-cli

Repository files navigation

Internometr

npm license node

CLI speed test via Yandex Internetometer — measures download, upload, ping and jitter to Yandex CDN servers (useful for testing speed to Eastern servers from Western locations).

Source: github.com/Technolog796/Internometr-cli

Install

npm install -g internometr

Requires Node.js ≥ 24

Usage

internometr               # run speed test (live TUI or JSON in non-TTY)
internometr json          # print one clean JSON object
internometr history       # show last 7 results
internometr history json  # print last 7 results as JSON
internometr --help
internometr --version

Pipeline / CI

Explicit JSON mode:

internometr json | jq '.download'
# 98.4

internometr json > result.json

Root command still prints clean JSON when stdout is not a TTY:

internometr | jq '.download'

JSON format:

{
  "download": 98.4,
  "upload": 45.1,
  "ping": 12,
  "jitter": 2,
  "ip": "x.x.x.x",
  "isp": "XS4All",
  "timestamp": "2026-04-19T14:32:00.000Z"
}

History

Results are automatically saved to ~/.internometr/history.jsonl.

internometr history
internometr history json
Date                   ↓ Down       ↑ Up      Ping
────────────────────────────────────────────────────
2026-04-19 14:32   98.4 Mbps  45.1 Mbps     12ms
2026-04-19 09:11   87.2 Mbps  43.8 Mbps     14ms

Metrics

Metric Source
Download / Upload Yandex CDN via Internetometer API (4 parallel streams × 10s)
Ping + Jitter Latency probes (mean ± stddev of 10 pings)
Public IP Yandex API
ISP ipinfo.io (no key required)

About

A utility for measuring internet speed

Resources

License

Stars

Watchers

Forks

Contributors