Skip to main content
https://travis-ci.org/TheTorProject/ooni-probe.png?branch=master https://coveralls.io/repos/TheTorProject/ooni-probe/badge.png
https://ooni.torproject.org/images/ooni-header-mascot.png

OONI, the Open Observatory of Network Interference, is a global observation network which aims is to collect high quality data using open methodologies, using Free and Open Source Software (FL/OSS) to share observations and data about the various types, methods, and amounts of network tampering in the world.

Read this before running ooniprobe!

Running ooniprobe is a potentially risky activity. This greatly depends on the jurisdiction in which you are in and which test you are running. It is technically possible for a person observing your internet connection to be aware of the fact that you are running ooniprobe. This means that if running network measurement tests is something considered to be illegal in your country then you could be spotted.

Furthermore, ooniprobe takes no precautions to protect the install target machine from forensics analysis. If the fact that you have installed or used ooni probe is a liability for you, please be aware of this risk.

Setup ooniprobe

To install ooniprobe you will need the following dependencies:

  • python

  • python-dev

  • python-setuptools

  • build-essential

  • libdumbnet1

  • python-dumbnet

  • python-libpcap

  • tor

  • libgeoip-dev

  • libpcap0.8-dev

  • libssl-dev

  • libffi-dev

  • libdumbnet-dev

On debian based systems this can generally be done by running:

sudo apt-get install -y build-essential libdumbnet-dev libpcap-dev libgeoip-dev libffi-dev python-dev python-pip

When you got them run:

sudo pip install ooniprobe

Using ooniprobe

To generate a test deck for your country, cd to the directory where you want it and run:

oonideckgen

To setup a daily cronjob run this:

(crontab -l 2>/dev/null; echo "@daily ooniprobe `oonideckgen | grep -e '^ooniprobe'`") | crontab -

Have fun!

Metadata

Release files for ooniprobe 1.6.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ooniprobe 1.6.0
File Size Uploaded
ooniprobe-1.6.0.tar.gz 162.8 kB Details

Release files / ooniprobe-1.6.0.tar.gz

Download URL ooniprobe-1.6.0.tar.gz
Size 162.8 kB
Tags Source
SHA-256 checksum
How to use checksums
6ec8e5d3cf19b286b6863e2d19dac4244526db9757effde3b6cfda5f725da170
BLAKE2b-256 checksum
How to use checksums
b46f41d2e88cb59cfcbd501a00debf6fbc30d152f928d7e69da41ddfcf369870
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release history Release notifications | RSS feed

2.3.0

1 release file

2.2.0

1 release file

2.1.0

1 release file

2.0.2

1 release file

2.0.1

1 release file

2.0.0

1 release file

1.6.1

1 release file

This release

1.6.0 This release

1 release file

1.5.1

1 release file

1.4.2

1 release file

1.4.1

1 release file

1.3.2

1 release file

1.3.1

1 release file

1.3.0

1 release file

1.2.2

1 release file

1.2.0

1 release file

1.1.1

1 release file

1.1.0

1 release file

1.0.2

1 release file

1.0.1

1 release file

1.0.0

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page