Bwscanner Save Abandoned

Bandwidth authority scanner. This project is deprecated in favour of

Project README


.. image:: :target:

.. image:: :target:

.. important:: This software is deprecated in favor of sbws <>_

BWScanner is a tool for measuring the bandwidth of Tor relays. Its aim is to replace the existing Torflow system.

This project is still under active development and is not ready for active use or production deployment yet.


BWScanner is not yet compatible with Python 3 due to the txsocksx dependency.

In Debian/Ubuntu systems, you can install Python 2 and other systems requirements running:

.. code:: bash

sudo apt install python2.7 python2.7-dev

The bandwidth scanner and its dependencies can be installed as follows:

.. code:: bash

git clone
cd bwscanner
python install

In case your system is using Python 3 by default, you need to run Python 2 explicitely, changing last line by:

.. code:: bash

python2.7 install


After installation the bwscan tool should be available in your path. This tool has a number of subcommands for running scans and for aggregating the collected data for use by the bandwidth authorities.

Collecting bandwidth measurements

The ``--partitions`` option can be used to split the consensus into subsets of relays which can be scanned on different machines. The results can later be combined during the measurement aggregation step.

.. code:: bash

    bwscan scan

Aggregating scan results

This command will aggregate the data for the latest five completed scans.

.. code:: bash

    bwscan aggregate -n 5

The final aggregation script is not yet integrated with the CLI. It should be called with the path to the directory containing the most recent aggregated data:

.. code:: bash

    python scripts/ ~/.config/bwscanner/measurements/1474278776


#bwscanner at


Copyright 2016 Aaron Gibson, Donncha Ó Cearbhaill, David Stainton,
Copyright 2018 Aaron Gibson, juga, Donncha Ó Cearbhaill
under the terms of the `GPLv2 <>`__ license.
Open Source Agenda is not affiliated with "Bwscanner" Project. README Source: TheTorProject/bwscanner
Open Issues
Last Commit
1 year ago

Open Source Agenda Badge

Open Source Agenda Rating