Skip to main content

Simple CLI for running internet speed tests

Project description

Your image description

SpeedCheck: A Simple combined Internet Speedtest

Build Python Package Index License

Run a quick speed check across multiple speed test providers Simple CLI to combine these and provide a JSON response for all

SpeedCheck is a simple command-line interface (CLI) tool designed to help users measure their internet speed using various popular speed test providers. Read about the motivation and additional details about this project here. Whether you want to check the performance of your connection through Cloudflare, Fast.com, Ookla, or M-Lab, SpeedCheck provides a unified and straightforward way to run these tests from the command line. This tool consolidates multiple speed test services into one easy-to-use package, allowing users to quickly and efficiently assess their internet connection's download and upload speeds, latency, and overall performance.

Features

  • Run speed tests from multiple providers:
    • Cloudflare
    • Fast.com
    • Ookla
    • M-Lab
    • Speed Smart
    • Open Speed Test
  • Check and compare the installed version of SpeedCheck with the latest version available on PyPI.
  • Get information about the speed tests supported by SpeedCheck.
  • SpeedCheck also notifies you if a newer version of the package is available on PyPI.

Installation

To install SpeedCheck, use pip:

pip install speedcheck

Setup

We recommend using a virtual environment to manage dependencies. Once your virtual environment is set up, make sure to run the following command to ensure that the necessary browsers are downloaded

playwright install #For playwright to get setup properly
playwright install-deps  # May be necessary on some systems

The rest of the setup is handled through setup.py. This project is in its early stages, so your feedback and contributions are highly appreciated.

Usage

Getting Information: To get information about the supported speed tests, use the info command:

speedcheck info

Running Speed Tests: To run a speed test, use the run command followed by the --type argument to specify the speed test provider.

speedcheck run --type [provider]

Replace provider with one of the following options:

  • cloudflare
  • fast
  • ookla
  • mlab
  • speedsmart
  • openspeedtest

Example:

speedcheck run --type cloudflare

Contributing

Contributions are welcome! Please open an issue or submit a pull request on GitHub. We encourage pull requests to add additional testers to the SpeedCheck tool.

Contact

For any questions or suggestions, feel free to open an issue on the GitHub repository.

Changelog

v0.0.4

  • updated cloudflare runner to handle IP address with no region metadata
  • added IP to region lookup service

v0.0.3

  • avoid printing extraneous information for cloudflare tests
  • added additional dependency information & blog link
  • updated readme with logo and badges
  • enabled version check

v0.0.2

  • added speedsmart and openspeedtest
  • increased project maturity to beta
  • added readme docs

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

speedcheck-0.0.4.tar.gz (17.1 kB view hashes)

Uploaded Source

Built Distribution

speedcheck-0.0.4-py3-none-any.whl (18.6 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page