TgWitness / Documentation

Repository / docs/README.md

TgWitness documentation

TgWitness

TgWitness / Documentation

Offline handbook · FAQ · GitHub Wiki

Current capabilities · Verification record · Performance graphs · Signed English audit

Observe, preserve and verify.

Start here#

Linux / macOS (root on an Ubuntu server, normal user on a desktop):

curl -fsSL https://get.destroy.tools/install.sh | bash

Windows (PowerShell or CMD, no admin needed):

powershell.exe -NoProfile -ExecutionPolicy Bypass -Command "irm https://get.destroy.tools/install.ps1 | iex"

Python comes bundled. Everything runs on your machine, only the download files sit on Cloudflare. Signatures, panel access, updates and removal.

Licence: MIT License. Our position on Taylor Wessing adds no condition to it.

Ethical Notice & Historical Continuity Read our author statement and its source record.

First time? Do it in this order:

  1. Try the demo, fake data, no Telegram login
  2. Connect and collect a message from a chat you control
  3. Read how the record works and what each check establishes

Find your workflow#

Set up a workspace#

I want to… Read
Try the interface Quick start
Connect my account Account setup
Pick a goal and tweak settings First setup and settings
Understand every screen Panel guide
Add browser or AyuGram capture Optional capture (preview)
See how protected a workspace is Protection modes
Check the program matches GitHub Code check
Run several accounts Account groups

Collect and investigate#

I want to… Read
Capture one chat from my fork GitHub Actions capture (preview)
Understand Secret Chat support and try its interface Secret Chat installation and recording
Load older messages Source history
Export an account Account export
See what was collected and what was not Coverage and missing material
Ask questions, write a report Archive analysis
Find messages by word forms, domains or @usernames Full-text search (preview)
Keep team notes on a case Case Board
Read text in images and audio Local OCR and transcription
Follow Telegram's similar-channel suggestions Similar channels
See what a mini application loads Mini applications
Investigate a whole account Investigation walkthrough
Document a conversation for court Investigation mode
See how the installation reaches Telegram and outside services System map

Share and verify#

I want to… Read
Send a trimmed copy to a lawyer Minimized disclosure
Give someone limited access Access and permissions
Hand over a readable report Case reports
Describe a verified evidence archive Evidence narratives · Configuration examples
Share something verifiable Export and verify
Publish checkpoints to a channel Witness bot
Let others check the server itself High-assurance deployment

Operate and connect#

I want to… Read
Connect an AI client Read-only MCP
Script searches, statistics and exports Command line (preview)
Connect n8n or a SIEM Signed webhooks · Integration examples
Pick a connection route Proxy settings
Run it on a server Deployment
Fix a problem Operations

Also: panel safeguards, storage and recovery, what's been tested, questions and checks, wiki, glossary.

Technical reference

Section divider

Browse the source#

Area Guide
Application and recorder code Application · Independent capture
Install and run Deployment · Launchers
Configure an export or integration Export examples · Webhooks and n8n
Build and contribute Tools · Contribution guide
Maintain the documentation Website · Wiki source · Assets

Full repository map · Maintainer procedures