Command line interface for testing internet bandwidth using speedtest.net
Go to file
Matt Martz 14e5040c99 Only test using python 2.7 for right now 2014-02-08 09:52:01 -06:00
.gitignore Initial commit 2012-09-10 12:17:53 -07:00
.travis.yml Only test using python 2.7 for right now 2014-02-08 09:52:01 -06:00
LICENSE LICENSE 2013-04-26 22:37:03 -05:00
MANIFEST.in Add MANIFEST.in 2013-10-08 07:15:42 -05:00
README.rst Bumping version for release 2013-12-03 12:59:48 -06:00
setup.py Bumping version for release 2013-12-03 12:59:48 -06:00
speedtest_cli.py Also catch URLError when trying to fetch latency.txt. Fixes #41 2013-12-05 13:37:56 -06:00

README.rst

speedtest-cli
=============

Command line interface for testing internet bandwidth using
speedtest.net

.. image:: https://pypip.in/v/speedtest-cli/badge.png
        :target: https://crate.io/packages/speedtest-cli
.. image:: https://pypip.in/d/speedtest-cli/badge.png
        :target: https://crate.io/packages/speedtest-cli

Versions
--------

speedtest-cli works with Python 2.4-3.4

Installation
------------

pip / easy\_install
~~~~~~~~~~~~~~~~~~~

::

    pip install speedtest-cli

or

::

    easy_install speedtest-cli

Github
~~~~~~

::

    pip install git+https://github.com/sivel/speedtest-cli.git

or

::

    git clone https://github.com/sivel/speedtest-cli.git
    python speedtest-cli/setup.py install

Just download (Like the way it used to be)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

::

    wget -O speedtest-cli https://raw.github.com/sivel/speedtest-cli/master/speedtest_cli.py
    chmod +x speedtest-cli

or

::

    curl -o speedtest-cli https://raw.github.com/sivel/speedtest-cli/master/speedtest_cli.py
    chmod +x speedtest-cli

Usage
-----

::

    $ speedtest-cli -h
    usage: speedtest-cli [-h] [--share] [--simple] [--list] [--server SERVER]
                         [--mini MINI] [--source SOURCE] [--version]

    Command line interface for testing internet bandwidth using speedtest.net.
    --------------------------------------------------------------------------
    https://github.com/sivel/speedtest-cli

    optional arguments:
      -h, --help       show this help message and exit
      --share          Generate and provide a URL to the speedtest.net share
                       results image
      --simple         Suppress verbose output, only show basic information
      --list           Display a list of speedtest.net servers sorted by distance
      --server SERVER  Specify a server ID to test against
      --mini MINI      URL of the Speedtest Mini server
      --source SOURCE  Source IP address to bind to
      --version        Show the version number and exit