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
- 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.
- 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.
- 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.
- 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.
- 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:
- Google Drive or Dropbox. The simplest options, and the only options where emergency contacts can be granted access automatically. Both are large US companies subject to legal process; footage in your account is reachable by warrant served on them.
- Nextcloud or WebDAV. Your own server, or one run by an organisation you trust. No US cloud provider in the middle. The trade-off is that WebDAV has no sharing mechanism, so emergency contacts are not granted access automatically and you would need to share a folder yourself.
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
- Start early. Uploads happen during the recording, so footage that has been running for a minute is already partly safe. Footage started as things escalate is not.
- The screen stays black. The phone looks idle and off. You do not need to hold it up like a camera, and you can put it in a pocket facing outward.
- Say that you are recording, if it is safe to. In most US jurisdictions openly recording on-duty police in public is protected; covert recording is treated differently in some places, particularly for audio.
- Keep your distance. Interference is the thing most often charged, and it is the thing the recording cannot protect you from.
- Do not rely on the battery. Continuous recording and upload is demanding. Bring a power bank for anything long.
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:
- Check the account from another device as soon as you can, and confirm what arrived.
- Change your cloud account password if the phone was unlocked when it was taken. This is the real remaining exposure: someone with access to your unlocked phone can reach the cloud account through its own app and delete footage there. The app's in-app guidance covers hardening this in advance.
- Preserve the originals. Do not re-encode, trim or re-upload the files you want to rely on. Any of that breaks the hash match. Keep untouched copies and share duplicates.
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.