TgWitness / Documentation

Repository / docs/wiki/Home.md

The TgWitness handbook

TgWitness — Work the case. Keep the record. An illustrated sequence follows a captured message, its edit and the retained record.

Download chats, follow changes or prepare a case. Start with the task you need.

Explore the demo · Set up TgWitness · How the record works · Project

Start with your task#

Task in the panel Start here
Just download Export one chat or download an account. Read the HTML archive, save media and keep JSON for other tools.
Follow chats Choose sources and coverage. Keep accessible history, captured edits and deletion notices.
Evidence for a case Investigate saved records, prepare a report and verify the export.

From a chat to a case.#

Export a chat, follow leads across recorded chats and retain observed changes. Three illustrated workflows.

Export a chat · Investigate · Capture changes

Your first investigation#

From the first captured message to an export someone else can check.

  1. Connect a dedicated account
  2. Pick sources and scope
  3. Follow the records across chats
  4. Export and verify

Quick sanity check: send a test message in a chat you control, edit it, delete it. You should see the message, a second version, and the content still there after the deletion. Then verify the export and keep the result with the test archive.

All handbook topics · panel, accounts, integrations, backups and troubleshooting
I want to… Open
Try it and connect an account Getting started → Accounts
Know what every screen does Panel guide
Choose chats, keep changes Collection and coverage
Save one chat for offline reading Export one chat
Run several accounts as a group Accounts
Investigate across chats Investigations
Keep team notes Case Board
Load history, use AI, connect tools Archive and integrations
Hand over and verify Exports and verification
Keep an independent checkpoint Independent witness · Protection modes
Alerts, encrypted remote copy Notifications · Off-site copy
Run on a server, recover Server and Docker · Backup and recovery
Fix something, look up a term Troubleshooting · FAQ · Glossary
Setup and advanced guides

Give others scoped access to chosen accounts and chats. Pick proxy routes and IP modes.

Set up your workspace, work a case and keep the investigation running.

Get started and connect your account Investigation guide Server and Docker deployment

Understand the evidence#

Captured events link through SHA-256 hashes and carry Ed25519 signatures. Verify the record against a separately trusted key.

The evidence model and formulas · Interactive explanation

Read this before connecting#

Ethical Notice & Historical Continuity Read the complete author statement: our statement on Taylor Wessing PartG mbB — German core, Hamburg office.

TgWitness is MIT-licensed. Our position on Taylor Wessing is a statement, not a licence condition.

Use an account you can afford to lose. A session is full access to that account, so keep sessions, panel tokens and keys to yourself. Keep messages and files on an encrypted disk.

Verify the signed archive with a key fingerprint and checkpoint kept elsewhere. It checks the saved records and files, and the archive reports the collection period and any gaps. Export and verify.

Project and help#

Project overview · Complete project guide · Technical documentation · Verification record · Get help · Contribute · Report a vulnerability

Labels here follow the English interface and can drift between releases.