Witness

Field guide

For activists, legal observers and journalists.

This page is about getting the app ready. For the wider question of filming safely, where to stand, what to capture and what to say, see how to record police safely, which is mostly not about this app at all.

The single most important thing about Witness is that it has to be set up before you need it. In the moment you will not have time to connect a cloud account or grant permissions, and an app that has not been configured will not save anything.

Before the day

  1. Connect your storage. Google Drive, Dropbox, or your own Nextcloud/WebDAV server. Nothing uploads until this is done. Footage stays on the device, which is the situation the app exists to avoid.
  2. Grant camera, microphone and location. Location is what ties footage to a place in the chain-of-custody record. If you would rather not record location, you can decline it and everything else still works.
  3. Add an emergency contact. A colleague, an editor, a legal support number. They are granted access to each recording's folder automatically as footage arrives, so someone else has your material if you are detained. This is the step most people skip and most regret.
  4. Bind a fast trigger. On iPhone 15 Pro and newer, assign the Action Button. Otherwise add the Lock Screen widget, or set up the Siri phrase. Practise it once.
  5. Practise stopping. Triple-tap, then press and hold. The app walks you through this once on first run. It is deliberately awkward so it cannot be triggered by accident or by someone grabbing the phone.

Test it properly, once. Record thirty seconds, then check the footage actually appeared in your cloud account. Discovering a misconfigured account afterwards is the most common way this fails, and the only way to catch it is to look.

Choosing where footage goes

All three destinations protect footage from device loss equally. They differ in who else is involved:

If you are documenting in a context where the adversary can plausibly obtain a warrant against a US provider, that is worth thinking about before the day rather than after.

In the moment

If you are documenting immigration enforcement specifically, recording ICE covers the differences that matter there, including why relying on iCloud or Google Photos sync leaves the most important footage on the device.

If the phone is taken

Everything already uploaded is in your cloud account and unaffected by anything done to the device. The manifest describing it is there too, because it is re-uploaded continuously rather than written at the end.

What to do afterwards:

Handing footage to a lawyer or newsroom

Give them the whole session folder, not just the video: the manifest and time-stamp token are what let them confirm the footage is unaltered without taking your word for it.

Send it in a way that does not re-compress. Messaging apps and social platforms re-encode video by default, which changes the file and breaks hash verification. Share a cloud link, or transfer the original files directly.

Point them at the verification instructions, written for someone who has never used the app.

Things worth knowing in advance

No signal means no upload. Chunks queue on the device and go when connectivity returns. In a basement, a jail, or a jammed crowd, footage stays on the phone until it can leave.

Witness cannot help if you are compelled to unlock the phone. It protects footage from the device being lost, not from every kind of coercion. Uploaded footage is out of reach of the phone, but not of your cloud account.

ProRes and 4K Log recordings do not upload. Pro capture modes produce files too large to send live. ProRes stays on the device by design. If your priority is that footage survives, record in H.264 or HEVC.

Recording is not always lawful. Rules on audio consent, distance and covert recording vary widely by jurisdiction. Witness gives no legal advice and does not make an unlawful recording lawful.

For newsrooms and organisations

If you are deploying this across a team (legal observers, a bureau, a documentary crew), a few things are worth deciding centrally: which storage destination everyone uses, who the standing emergency contact is, and who on the desk knows how to run the verification steps. Questions welcome at olmaster13@gmail.com.

Know your rights

The ACLU's guidance for photographers and its protesters' rights pages are the standard starting points in the United States. Outside the US, national press-freedom and civil-liberties organisations publish equivalents, and the rules genuinely differ.

Nothing on this page is legal advice.