Measuring shutdowns,
even during blackouts.

Early prototype. An open-source (MIT) project to measure internet shutdowns, throttling and blocking in Bangladesh. A working local logger, ethics documentation and tests exist; no probes are deployed yet.

View on GitHub ↗

Problem

During the July–August 2024 shutdown in Bangladesh, measurement stopped entirely during full blackouts. Quieter controls such as regional throttling, single-platform blocks or DNS tampering are easy to deny without continuous measurement from inside the networks.

Approach

  • Planned: a network of small Raspberry Pi probes across operators, running OONI Probe for blocking tests so results flow into OONI’s open dataset.
  • Probes log connectivity locally and keep recording which layer failed during a blackout, uploading when service returns.
  • Today: a v0 logger checks DNS, TCP and HTTP at fixed intervals, records which layer fails to local files only, and produces summaries and an offline HTML dashboard.

Stack

  • Python 3.11+, Windows and Linux.
  • Planned hardware: Raspberry Pi Zero 2 W, with a USB LTE modem for mobile probes.
  • MIT licence.

Security

  • Ethics, consent and safety-plan documents: informed consent from every probe host, no probe on a network without its owner’s permission, no collection of personal data.
  • A private vulnerability-reporting policy (SECURITY.md), because probes may run on volunteers’ connections.
  • Automated tests for checks, classification, CLI, storage, summaries and the dashboard.

Status

Early prototype: the local logger works on a single machine. It does not run OONI Probe or upload anything yet, and no probes are deployed.