Repository / docs/README.md
TgWitness documentation
Offline handbook · FAQ · GitHub Wiki
Current capabilities · Verification record · Performance graphs · Signed English audit
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:
- Try the demo, fake data, no Telegram login
- Connect and collect a message from a chat you control
- 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
- Investigation mode
- System map and network observations
- Collection and visibility
- Complete project guide
- Evidence format and trust boundaries
- Architecture
- Security model and data handling
- Access scopes, permissions and sessions
- Connection and secret storage
- Release checks
- Live acceptance procedure
- External timestamps
- Release procedure
- Website preview and publishing · SEO
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 |