Version 7 (modified by hellais, 3 years ago) (diff)

Add details about goals

Designing OONI UI

OONI detects censorship, surveillance, and traffic manipulation on the internet.

Mac OS and Linux users can run ooniprobe via the command line or via OONI's web UI. Alternatively, users can run ooniprobe through its distribution for Raspberry Pis.

Installation instructions can be found here.

This project improves on web and mobile UI designs to ready them for launch.


  • Arturo, OONI Team
  • Linda, UX Team
  • Ardash, contracted
  • Maria, OONI Team


  • Nov 2016: scoping the project, hiring Ardash, identifying deliverables
  • Dec 2016: usability audit, identifying user personas, designing features, interviewing users
  • Jan 2016: deliver a web and mobile UI with appropriate changes

A more detailed timeline is kept and updated here.


Having a good user interface that on one hand incentivises users to run ooniprobe tests, but at the same time ensures they are not putting themselves at risk by not understanding what this entails. We also want to make it easier to people to understand what OONI does and what they are contributing to by running measurements.

As such we want to:

  • Make the mobile and web based user interfaces more cohesive.
  • Ensure risks are communicated effectively and appropriately to users.
  • Improve the mobile and web based UIs that allow users to run tests, view test results and schedule tests (only in web based UI)

The activities that are going be carried out to achieve such goals are:

  • Analyse the current interface formally and provide feedback on what we currently have (ooniprobe mobile and web UI). (XXX add link the initial pdf UI breakdown)
  • Redesign of the mobile and web ui: going screen by screen and proposing the changes to be made.
  • High-fi mockups for the suggested changes to the views.
  • Graphical design work: for example stylistic changes (i.e. spacing, fonts, colors, etc.).
  • Documentation of the work: describing why you changed what you changed, what you didn't change and why. Similar to what has been done

in redesigning metrics (

  • Test implementation of UI/UX, and review platforms for usability

Communicating risks to users


OONI's software tests, called ooniprobe, serve as an investigatory tool for examining and uncovering internet censorship. As such, the use of ooniprobe can be associated with different types of risks, depending on the country that the tests are being run from.

The main risks associated with the use of ooniprobe include:

  • Anyone monitoring your internet activity (e.g. ISP, government, employer) will know that you are running ooniprobe;
  • The tested URLs include provocative or objectionable sites (e.g. pornography, hate speech);
  • Some ooniprobe tests might trigger the suspicion of your ISP if they are viewed as a form of "hacking";
  • The use of ooniprobe and/or its dependencies (such as circumvention software for relevant tests) might be illegal or viewed as such in certain countries;
  • The use of ooniprobe might be viewed as a form of espionage or condemned under broad national security laws in certain countries.

However, it's worth highlighting that, to our knowledge, no ooniprobe user has ever gotten into any trouble as a result of using this software or generally engaging with the OONI project.

While the risks outlined here are quite speculative, we have an ethical obligation to inform our users of potential risks. To this end, we have developed documentation, in consultation with lawyers, that explains in detail the risks associated to installing and running ooniprobe, and in regards to publishing measurements. This documentation is published on OONI's website and can be found here.

Initially, this documentation was also included in OONI's desktop and mobile clients. However, as this documentation is far too long, there is the concern that users will likely not read it and feel dis-encouraged from using the clients.

To address this, we are revising the Risks documentation so that it conveys the information in a concise and "user friendly" way through the desktop and mobile clients. As part of this process, we are aiming to strike a balance between informing users adequately of potential risks, while not dis-encouraging them from using ooniprobe.


To acquire consent from our users, we have created a quiz that they are required to answer correctly as a prerequisite to using ooniprobe.

This quiz attempts to ensure that users understand that:

  • Anyone monitoring their internet activity will be able to identify them as an ooniprobe user;
  • Unless they opt-out, their measurements will automatically be published by OONI.

As part of the review process, we aim to revise the quiz to improve upon consent acquisition.

Dump of links and text

Organize later.

Attachments (4)