# TgWitness > Open-source Telegram investigation workspace. Export chats and whole accounts, keep every observed edit and deletion notice, follow people across chats, and hand over signed archives that recipients verify on their own computers. TgWitness runs on your own computer or server and is maintained by PhishDestroy under the MIT License. These pages track the `main` source branch, version `0.9.3`; the browser demo uses fictional records. ## Key facts - Live observation saves each version of a message and keeps its text after a deletion notice; history export reads the accessible history of selected chats or the whole account. - Every record is signed and hash-chained. Recipients verify an archive offline with the bundled verifier, a separately received key fingerprint and retained checkpoints; independent witnesses add checkpoints, and RFC 3161 and OpenTimestamps add external time. - Messages arrive over the account's authenticated MTProto session and are signed on receipt. GitHub Actions capture and Phala Intel TDX deployments add attestation of the collector that received them. - Published measurements: 56,329 messages in two fresh exports on 6 November 2026, a 1,000,000-message search benchmark and a 1 November inventory of 1,610,818 journal events. - Investigation tools: people profiles across chats, watchlists over text, QR codes and OCR, Case Board, a report studio with eight designs and a BagIt court package. - Self-hosted with no telemetry: sessions and credentials live in an encrypted vault, and the panel listens on localhost. The vault key stays in the data directory unless a new installation uses an external master key. Basic collection runs without Docker, a GPU or an LLM. - Developed and tested for about six months before the public repository was created. The private regression suite has 126 test modules; public CI runs lint, dependency audits, wheel installs, installer signature checks, CodeQL, Trivy and verifier fuzzing. ## Start here - [TgWitness: start, scale and evidence](https://phishdestroy.io/tgwitness/docs/reference/overview/index.md): Install with one command or capture on GitHub Actions. Understand investigation options, published scale and what an archive verifies. - [Install, verify and update](https://phishdestroy.io/tgwitness/docs/reference/installation/index.md): Install with one command, check signatures and hashes, update and remove an installation. - [Start in minutes](https://phishdestroy.io/tgwitness/docs/start/index.md): Install with one command, connect a Telegram account and export a verifiable archive on Windows, Linux or macOS. - [GitHub Actions capture](https://phishdestroy.io/tgwitness/docs/capture/index.md): Choose Takeout, regular API export or a chat journal on a temporary GitHub runner. - [Dedicated account](https://phishdestroy.io/tgwitness/docs/dedicated-account/index.md): Prepare a separate Telegram account for collection. - [Connect an account](https://phishdestroy.io/tgwitness/docs/accounts/index.md): Connect Telegram by QR code, phone number or session import. Choose sources and check that new messages reach your journal. - [Collection modes and evidence levels](https://phishdestroy.io/tgwitness/guides/modes.md): Compare one-off export, observation, investigation and independent verification. - [Read-only browser demo](https://phishdestroy.github.io/TgWitness/demo/): Explore the panel with fictional accounts and messages. ## Investigate and preserve - [Investigate across all chats](https://phishdestroy.io/tgwitness/docs/cases/index.md): Run an end-to-end Telegram investigation across channels, groups, private chats and bots: whole-account capture, history, people, links, files, timelines and verified evidence. - [Build a Case Board](https://phishdestroy.io/tgwitness/docs/case-board/index.md): Collect saved observations, exact highlights and action slices on a private board, discuss them with your team and present a collection. - [Manage a group of accounts](https://phishdestroy.io/tgwitness/docs/groups/index.md): Compare group workspaces, find a source, review observation periods and apply shared settings with per-account exceptions. - [How collection works](https://phishdestroy.io/tgwitness/docs/reference/collection/index.md): Observation scope, live updates, rechecks, attachments, own actions and what a gap means, record by record. - [Load source history](https://phishdestroy.io/tgwitness/docs/reference/history/index.md): Load past messages from enabled sources, pause and resume, and verify a signed progress report. - [Export and verify](https://phishdestroy.io/tgwitness/docs/exports/index.md): Export captured Telegram history, verify signatures and compare a journal with a checkpoint retained by an independent witness. - [Design a report](https://phishdestroy.io/tgwitness/docs/reports/index.md): Choose report data, one of eight designs and the contents, then preview and export HTML, signed PDF or a complete evidence package. - [Prepare a sharing copy](https://phishdestroy.io/tgwitness/docs/handover/index.md): Choose the records and fields a recipient can receive, inspect the finished copy and verify its signed manifest and source journal boundary. - [Case Board reference](https://phishdestroy.io/tgwitness/docs/reference/case-board/index.md): Bookmarks, exact highlights, action slices, discussions, scoped access and the signed annotation history used by Case Board. - [Report configuration and verification](https://phishdestroy.io/tgwitness/docs/reference/case-reports/index.md): Report filters, eight designs, contents presets, saved change histories and the assessment included in signed exports. - [Evidence format](https://phishdestroy.io/tgwitness/docs/reference/evidence/index.md): Contents of the signed ZIP, record kinds, process receipts, people profiles, off-site copies and offline verification. ## Search the archive and connect AI tools - [Work the archive](https://phishdestroy.io/tgwitness/docs/archive/index.md): Load history, search saved records, review AI sources and connect your tools. - [Archive analysis](https://phishdestroy.io/tgwitness/docs/reference/analysis/index.md): Search saved messages, review AI inputs and keep analytical reports with their source references. - [Full-text search](https://phishdestroy.io/tgwitness/docs/reference/search/index.md): Find saved messages by word forms, exact phrases, domains and @usernames, best matches first, with the index bound to the signed journal. - [Read-only MCP](https://phishdestroy.io/tgwitness/docs/reference/mcp/index.md): Connect an MCP client to selected workspaces and chats with expiring, revocable access. - [Command line](https://phishdestroy.io/tgwitness/docs/reference/cli/index.md): Search, read context, count activity and export saved messages from scripts and agents, with --json output, stable exit codes and scoped read-only tokens. - [Local OCR and transcription](https://phishdestroy.io/tgwitness/docs/reference/media-analysis/index.md): Recognize captured images and audio with a local worker; keep derived text linked to its source file. - [Outgoing webhooks](https://phishdestroy.io/tgwitness/docs/reference/webhooks/index.md): Send scoped events to HTTPS receivers with HMAC signatures, retries and delivery status. ## Deploy, share and verify - [Keep it running](https://phishdestroy.io/tgwitness/docs/server/index.md): Run TgWitness on a server with persistent storage, private panel access, backups and checks after a restart. - [GitHub Actions capture](https://phishdestroy.io/tgwitness/docs/capture/index.md): Choose Takeout, regular API export or a chat journal on a temporary GitHub runner. - [Choose a proxy](https://phishdestroy.io/tgwitness/docs/proxies/index.md): Maintain automatic MTProxy routes or use your own proxy. Choose IP modes, fallback rules and the route for external requests. - [Share a case](https://phishdestroy.io/tgwitness/docs/access/index.md): Give reviewers and analysts access to selected accounts and chats, with separate permissions, session limits and revocable tokens. - [See how evidence works](https://phishdestroy.io/tgwitness/docs/concepts/index.md): Follow a message from capture to checkpoint. Change a sample record, recalculate its SHA-256 chain and see what a retained checkpoint detects. - [Set up a witness bot](https://phishdestroy.io/tgwitness/docs/witness/index.md): Publish signed journal checkpoints to your Telegram channel with a separate witness, its own key and read-only collector access. - [Timestamps](https://phishdestroy.io/tgwitness/docs/reference/timestamp/index.md): RFC 3161 timestamps for signed checkpoints: what is sent to the authority and how a response is verified. - [Security and data handling](https://phishdestroy.io/tgwitness/docs/reference/security/index.md): Threat model, access model, secrets at rest, network exposure, session imports and how to report a vulnerability. ## Reference - [Features and scope](https://phishdestroy.io/tgwitness/docs/reference/features/index.md): The current collection model, multi-account workflows, exports and operational boundaries of TgWitness. - [What has been tested](https://phishdestroy.io/tgwitness/docs/reference/verification/index.md): The live Telegram test, automated checks, browser checks and the next qualification runs. - [Changelog](https://phishdestroy.io/tgwitness/docs/reference/changelog/index.md): Every change by version, including the changes not yet released. ## Optional - [Complete English handbook as text](https://phishdestroy.io/tgwitness/llms-full.txt): The same guide and reference content in a single text download. - [Complete English handbook](https://phishdestroy.github.io/TgWitness/llms-full.md): Public guide and reference articles in one Markdown file, including source URLs. - [Documentation hub](https://phishdestroy.io/tgwitness/docs/): Browse the illustrated handbook and its language editions. - [Source code](https://github.com/phishdestroy/TgWitness): Implementation, documentation and issue templates. - [Releases](https://github.com/phishdestroy/TgWitness/releases): Packages and their release notes. - [MIT License](https://phishdestroy.io/tgwitness/repo/license/): Software license. - [Operator incompatibility notice](https://phishdestroy.io/tgwitness/docs/reference/notice/index.md): Our operator notice on Taylor Wessing and its source record. ## Complete documentation map ### Guides - [Work the archive](https://phishdestroy.io/tgwitness/docs/archive/index.md): Load history, search saved records, review AI sources and connect your tools. - [GitHub Actions capture](https://phishdestroy.io/tgwitness/docs/capture/index.md): Choose Takeout, regular API export or a chat journal on a temporary GitHub runner. - [Dedicated account](https://phishdestroy.io/tgwitness/docs/dedicated-account/index.md): Prepare a separate Telegram account for collection. - [Start in minutes](https://phishdestroy.io/tgwitness/docs/start/index.md): Install with one command, connect a Telegram account and export a verifiable archive on Windows, Linux or macOS. - [Connect an account](https://phishdestroy.io/tgwitness/docs/accounts/index.md): Connect Telegram by QR code, phone number or session import. Choose sources and check that new messages reach your journal. - [Choose a proxy](https://phishdestroy.io/tgwitness/docs/proxies/index.md): Maintain automatic MTProxy routes or use your own proxy. Choose IP modes, fallback rules and the route for external requests. - [Export and verify](https://phishdestroy.io/tgwitness/docs/exports/index.md): Export captured Telegram history, verify signatures and compare a journal with a checkpoint retained by an independent witness. - [See how evidence works](https://phishdestroy.io/tgwitness/docs/concepts/index.md): Follow a message from capture to checkpoint. Change a sample record, recalculate its SHA-256 chain and see what a retained checkpoint detects. - [Investigate across all chats](https://phishdestroy.io/tgwitness/docs/cases/index.md): Run an end-to-end Telegram investigation across channels, groups, private chats and bots: whole-account capture, history, people, links, files, timelines and verified evidence. - [Build a Case Board](https://phishdestroy.io/tgwitness/docs/case-board/index.md): Collect saved observations, exact highlights and action slices on a private board, discuss them with your team and present a collection. - [Design a report](https://phishdestroy.io/tgwitness/docs/reports/index.md): Choose report data, one of eight designs and the contents, then preview and export HTML, signed PDF or a complete evidence package. - [Prepare a sharing copy](https://phishdestroy.io/tgwitness/docs/handover/index.md): Choose the records and fields a recipient can receive, inspect the finished copy and verify its signed manifest and source journal boundary. - [Manage a group of accounts](https://phishdestroy.io/tgwitness/docs/groups/index.md): Compare group workspaces, find a source, review observation periods and apply shared settings with per-account exceptions. - [Keep it secure](https://phishdestroy.io/tgwitness/docs/security/index.md): See where sessions, keys and evidence live, what leaves your machine, what the protections cover and how to harden an installation. - [Share a case](https://phishdestroy.io/tgwitness/docs/access/index.md): Give reviewers and analysts access to selected accounts and chats, with separate permissions, session limits and revocable tokens. - [Set up a witness bot](https://phishdestroy.io/tgwitness/docs/witness/index.md): Publish signed journal checkpoints to your Telegram channel with a separate witness, its own key and read-only collector access. - [Why zero trust: Taylor Wessing, Dr. Zurheide, Dr. Schelinski](https://phishdestroy.io/tgwitness/docs/signed-export/index.md): A zero-trust case study: a GDPR answer signed by Dr. Patrick Zurheide and Dr. Tobias Schelinski of Taylor Wessing, checked against its own file, and the checkable model that would have left no room to deceive or doubt. - [Keep it running](https://phishdestroy.io/tgwitness/docs/server/index.md): Run TgWitness on a server with persistent storage, private panel access, backups and checks after a restart. - [Find what went wrong](https://phishdestroy.io/tgwitness/docs/troubleshooting/index.md): Check panel access, Telegram connection, missing messages, FloodWait and witness status using the right signals for each problem. ### Reference - [Secret Chats: setup and recording](https://phishdestroy.io/tgwitness/docs/reference/secret-chats/index.md): Install the Secret Chat protocol extra, enable it per account and record the chats TgWitness creates or accepts. - [TgWitness: start, scale and evidence](https://phishdestroy.io/tgwitness/docs/reference/overview/index.md): Install with one command or capture on GitHub Actions. Understand investigation options, published scale and what an archive verifies. - [Load source history](https://phishdestroy.io/tgwitness/docs/reference/history/index.md): Load past messages from enabled sources, pause and resume, and verify a signed progress report. - [Archive analysis](https://phishdestroy.io/tgwitness/docs/reference/analysis/index.md): Search saved messages, review AI inputs and keep analytical reports with their source references. - [Command line](https://phishdestroy.io/tgwitness/docs/reference/cli/index.md): Search, read context, count activity and export saved messages from scripts and agents, with --json output, stable exit codes and scoped read-only tokens. - [Full-text search](https://phishdestroy.io/tgwitness/docs/reference/search/index.md): Find saved messages by word forms, exact phrases, domains and @usernames, best matches first, with the index bound to the signed journal. - [Read-only MCP](https://phishdestroy.io/tgwitness/docs/reference/mcp/index.md): Connect an MCP client to selected workspaces and chats with expiring, revocable access. - [Local OCR and transcription](https://phishdestroy.io/tgwitness/docs/reference/media-analysis/index.md): Recognize captured images and audio with a local worker; keep derived text linked to its source file. - [Outgoing webhooks](https://phishdestroy.io/tgwitness/docs/reference/webhooks/index.md): Send scoped events to HTTPS receivers with HMAC signatures, retries and delivery status. - [Operator incompatibility notice](https://phishdestroy.io/tgwitness/docs/reference/notice/index.md): Our operator notice on Taylor Wessing and its source record. - [Licence and architectural incompatibility notice](https://phishdestroy.io/tgwitness/docs/reference/license/index.md): TgWitness is MIT-licensed for everyone, and why it is architecturally incompatible with the Taylor Wessing workflow. - [Quick start](https://phishdestroy.io/tgwitness/docs/reference/quickstart/index.md): Every way to install and launch TgWitness: Windows package, Python, Docker and the synthetic demo, with first checks. - [Accounts and session formats](https://phishdestroy.io/tgwitness/docs/reference/accounts/index.md): Sign in by phone, QR code or auth key, import Telethon, Pyrogram or Telegram Desktop sessions, and run several accounts. - [Access and permissions](https://phishdestroy.io/tgwitness/docs/reference/access/index.md): Issue scoped access to accounts and chats, choose permissions, limit sessions and IP addresses, and withdraw access. - [Connection, proxies and data protection](https://phishdestroy.io/tgwitness/docs/reference/connection/index.md): Authentication, automatic proxy pools, IP modes, fallback policy, external requests and secret storage. - [Deployment](https://phishdestroy.io/tgwitness/docs/reference/deployment/index.md): Run TgWitness as a service on Windows, Linux, macOS or Docker, behind HTTPS, with backups and updates. - [How collection works](https://phishdestroy.io/tgwitness/docs/reference/collection/index.md): Observation scope, live updates, rechecks, attachments, own actions and what a gap means, record by record. - [Workflows and operations](https://phishdestroy.io/tgwitness/docs/reference/operations/index.md): Daily operation of the panel: modes, monitoring categories, parameters, notifications, exports, backup and capacity. - [Investigation mode](https://phishdestroy.io/tgwitness/docs/reference/investigation/index.md): Whole-account investigations across channels, groups, private chats and bots, from scope to a verified case package. - [Case Board reference](https://phishdestroy.io/tgwitness/docs/reference/case-board/index.md): Bookmarks, exact highlights, action slices, discussions, scoped access and the signed annotation history used by Case Board. - [Report configuration and verification](https://phishdestroy.io/tgwitness/docs/reference/case-reports/index.md): Report filters, eight designs, contents presets, saved change histories and the assessment included in signed exports. - [Features and scope](https://phishdestroy.io/tgwitness/docs/reference/features/index.md): The current collection model, multi-account workflows, exports and operational boundaries of TgWitness. - [How the evidence works](https://phishdestroy.io/tgwitness/docs/reference/how-it-works/index.md): Hash chain, signatures, checkpoints and witnesses explained with the exact formulas the verifier uses. - [Evidence format](https://phishdestroy.io/tgwitness/docs/reference/evidence/index.md): Contents of the signed ZIP, record kinds, process receipts, people profiles, off-site copies and offline verification. - [Independent witness](https://phishdestroy.io/tgwitness/docs/reference/witness/index.md): Run a witness with its own key and bot, publish signed checkpoints to a channel and check exports against it. - [Timestamps](https://phishdestroy.io/tgwitness/docs/reference/timestamp/index.md): RFC 3161 timestamps for signed checkpoints: what is sent to the authority and how a response is verified. - [Translating reports for court](https://phishdestroy.io/tgwitness/docs/reference/translation/index.md): Which file is the original, what to file with a certified translation and the terms translators keep. - [Security and data handling](https://phishdestroy.io/tgwitness/docs/reference/security/index.md): Threat model, access model, secrets at rest, network exposure, session imports and how to report a vulnerability. - [Architecture](https://phishdestroy.io/tgwitness/docs/reference/architecture/index.md): Components of the collector, panel, journal, workers and witness, and how data moves between them. - [What has been tested](https://phishdestroy.io/tgwitness/docs/reference/verification/index.md): The live Telegram test, automated checks, browser checks and the next qualification runs. - [Changelog](https://phishdestroy.io/tgwitness/docs/reference/changelog/index.md): Every change by version, including the changes not yet released. - [Panel guide](https://phishdestroy.io/tgwitness/docs/reference/panel/index.md): Every screen of the panel: chats, journal, sources, exports, Extras, protection modes and the code check. - [First setup and settings](https://phishdestroy.io/tgwitness/docs/reference/settings/index.md): The setup wizard, goals, interface levels, connection routes and settings shared by an account group. - [Install, verify and update](https://phishdestroy.io/tgwitness/docs/reference/installation/index.md): Install with one command, check signatures and hashes, update and remove an installation. - [Storage and recovery](https://phishdestroy.io/tgwitness/docs/reference/storage/index.md): Backups, moving older files to your cloud, copies under Object Lock and recovery on a new machine. - [Account export](https://phishdestroy.io/tgwitness/docs/reference/account-export/index.md): Export what an account can read now: scope, resumable jobs, a signed archive and minimized sharing copies. - [Public showcase](https://phishdestroy.io/tgwitness/docs/reference/showcase/index.md): Publish saved messages of selected public channels and signed snapshots through expiring, revocable links. - [High-assurance deployment](https://phishdestroy.io/tgwitness/docs/reference/high-assurance/index.md): A sealed 24/7 server on Hetzner or Phala Cloud, Gateway DNS and the checks a third party can repeat. ## Language editions - [English](https://phishdestroy.io/tgwitness/llms.txt) - [Українська](https://phishdestroy.io/tgwitness/uk/llms.txt) - [Español](https://phishdestroy.io/tgwitness/es/llms.txt) - [Português (Brasil)](https://phishdestroy.io/tgwitness/pt/llms.txt) - [Türkçe](https://phishdestroy.io/tgwitness/tr/llms.txt) - [العربية](https://phishdestroy.io/tgwitness/ar/llms.txt) - [فارسی](https://phishdestroy.io/tgwitness/fa/llms.txt) - [اردو](https://phishdestroy.io/tgwitness/ur/llms.txt) - [हिन्दी](https://phishdestroy.io/tgwitness/hi/llms.txt) - [Bahasa Indonesia](https://phishdestroy.io/tgwitness/id/llms.txt) - [Tiếng Việt](https://phishdestroy.io/tgwitness/vi/llms.txt) - [简体中文](https://phishdestroy.io/tgwitness/zh/llms.txt) - [Français](https://phishdestroy.io/tgwitness/fr/llms.txt) - [Deutsch](https://phishdestroy.io/tgwitness/de/llms.txt) - [Italiano](https://phishdestroy.io/tgwitness/it/llms.txt) - [O‘zbekcha](https://phishdestroy.io/tgwitness/uz/llms.txt) - [한국어](https://phishdestroy.io/tgwitness/ko/llms.txt) - [繁體中文](https://phishdestroy.io/tgwitness/zh-Hant/llms.txt) - [Bahasa Melayu](https://phishdestroy.io/tgwitness/ms/llms.txt) - [Polski](https://phishdestroy.io/tgwitness/pl/llms.txt) - [日本語](https://phishdestroy.io/tgwitness/ja/llms.txt) - [ไทย](https://phishdestroy.io/tgwitness/th/llms.txt) - [עברית](https://phishdestroy.io/tgwitness/he/llms.txt) - [বাংলা](https://phishdestroy.io/tgwitness/bn/llms.txt) - [አማርኛ](https://phishdestroy.io/tgwitness/am/llms.txt) - [Русский](https://phishdestroy.io/tgwitness/ru/llms.txt) ## Controlled experiment - [Export Clinic](https://phishdestroy.io/tgwitness/docs/export-clinic/index.md): Watch a controlled Telegram Desktop export experiment, compare seven test conversations, and inspect the original recording and paired files. ## Checks and measurements - [Checks & measurements](https://phishdestroy.io/tgwitness/docs/validation/index.md): 56,329 Telegram messages exported in two measured runs. Compare message counts, collection speed, export time and signed archives.