# TgWitness: Telegram Export, OSINT & Verification

Canonical page: https://phishdestroy.io/tgwitness/docs/reference/overview/

Explore TgWitness installation, Telegram capture, investigation tools and evidence verification. Read measured workloads with their methods and revisions.

[Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/)

[Documentation index](https://phishdestroy.io/tgwitness/llms.txt)

Installer en une seule commande ou capturer sur GitHub Actions. Comprendre les options d’investigation, l’échelle publiée et ce qu’une archive vérifie.

TgWitness est un exportateur Telegram open source et un espace de travail dédié aux enquêtes. Installez-le en une seule commande, connectez un compte, sélectionnez les discussions et exportez une archive signée . Il prend également en charge la collecte temporaire sur GitHub Actions et la poursuite des enquêtes grâce à la sauvegarde des modifications, aux observations de suppression, à la recherche et aux rapports.

## Commencez par la tâche qui vous a été confiée

| Votre mission | Chemin le plus court | Ce que vous recevrez |
| --- | --- | --- |
| Enregistrer une conversation ou un compte | Installer, connecter un compte, sélectionner la portée de l'exportation | Une archive signée contenant l'historique sélectionné, les résultats de la collecte et les éléments de vérification |
| Collecter sur un exécuteur temporaire | Utiliser GitHub Actions pour capturer les données, autoriser une nouvelle session et choisir la portée. | Une archive chiffrée avec traçabilité du workflow GitHub |
| Suivre les évolutions au fil du temps | Maintenir l'observation active pour les discussions sélectionnées | Versions enregistrées, avis de suppression, pièces jointes et couverture enregistrée |
| Enquêter et partager les conclusions | Effectuer une recherche dans les archives, utiliser le Case Board et configurer un rapport ou une copie à partager | Conclusions référencées à la source et transfert vérifiable adapté au destinataire |

### Installation en une seule commande

Le programme d'installation inclut Python et ses dépendances. Le téléchargement du code source, Docker, un fournisseur d'IA et un témoin indépendant sont des options facultatives, et non des prérequis à l'installation.

Linux / macOS :

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

Sous Windows, dans PowerShell ou l'invite de commande :

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

Ouvrez le panneau, connectez votre compte Telegram et sélectionnez la portée de la collecte. L'installation ne lance pas automatiquement la collecte. Le guide d'[installation](https://phishdestroy.io/tgwitness/fr/docs/reference/installation/) explique l'accès local, les serveurs, les mises à jour et la vérification de la version téléchargée.

Pour un exécuteur temporaire, suivez la capture [GitHub Actions](https://github.com/phishdestroy/TgWitness/blob/main/docs/SEALED-ACTIONS.md). Ce workflow nécessite un fork GitHub, une autorisation et un mot de passe d'archive. La page de capture explique ces étapes ainsi que la durée de session disponible avant l'exécution. Téléchargez et conservez l'archive obtenue ainsi que ses éléments de vérification.

## Paramètres supplémentaires si la tâche le nécessite

L'exportation d'une seule conversation nécessite un compte et une portée sélectionnée. L'observation continue, les comptes multiples, les proxys, les politiques relatives aux pièces jointes, la conception des rapports, l'accès des réviseurs, les horodatages externes et le stockage hors site répondent à différentes exigences en matière d'enquête et de transfert. Configurez ces fonctionnalités lorsqu'elles sont pertinentes.

Le périmètre, les autorisations et les copies de partage réduites aident les opérateurs à choisir ce qu’ils souhaitent collecter et divulguer. Les recommandations juridictionnelles et les paramètres de rapport consignent la procédure sélectionnée et les étapes de préparation. Voir [l’exportation de compte](https://phishdestroy.io/tgwitness/fr/docs/reference/account-export/), [l’accès](https://phishdestroy.io/tgwitness/fr/docs/reference/access/) et [la configuration des rapports](https://phishdestroy.io/tgwitness/fr/docs/reference/case-reports/).

L’application s’exécute sur l’ordinateur ou le serveur choisi. La collecte de base ne nécessite ni GPU ni LLM. L’OCR, la transcription et l’analyse IA, disponibles en option, ont leurs propres besoins en ressources. Dimensionnez le déploiement en fonction du débit de messages, des pièces jointes, de l’ historique conservé et du nombre de comptes simultanés.

## Conserver l'historique, quelle que soit la personne à qui cela profite

L’objectif est de préserver les éléments observés, leur contexte et leurs modifications, quelle que soit la position qu’ils soutiennent. Les preuves peuvent contester le propre récit des événements fournis par le collecteur. Veillez à ce que les observations sources, les lacunes de couverture et les conclusions analytiques restent identifiables afin qu’une autre personne puisse évaluer les mêmes éléments.

Le processus est le suivant : observation visible sur le compte → journal signé → exportation → vérification par le destinataire. Les modifications enregistrées ajoutent des versions. Les observations supprimées conservent le contenu précédemment capturé. Les enregistrements de couverture révèlent les interruptions connues. Les rapports et les analyses par IA renvoient aux sources enregistrées ; une interprétation ne devient pas une observation source simplement parce qu’elle apparaît dans un rapport signé.

| Contrôle de vérification | Ce qu'un destinataire peut établir |
| --- | --- |
| Hachages de fichiers, signatures et chaîne de journaux | Les enregistrements et fichiers fournis correspondent à la clé attendue et aux limites du journal. |
| Un point de contrôle ou témoin conservé séparément | L'archive correspond à un état du journal précédemment conservé. |
| Un horodatage externe vérifié | Les octets référencés existaient à la date et à l'heure indiquées, dans le cadre des hypothèses de confiance énoncées. |
| Attestation de capture GitHub | L'archive correspond au flux de travail approuvé, à la révision du collecteur et au résumé enregistré. |
| Attestation Intel TDX | La citation, l’état de la plateforme, les mesures attendues du système d’exploitation et des applications, la fraîcheur des données et l’identité du collecteur satisfont aux contrôles configurés. |

Dans le cadre d’une acquisition certifiée, la connexion Telegram authentifiée du collecteur agréé et sa sortie sont liées à l’environnement d’exécution vérifié. L’archive conserve le contenu et le contexte capturés ; les rapports et analyses se réfèrent à ces enregistrements. Utilisez les étapes de vérification spécifiques au mode et les entrées fiables décrites dans [le guide de confiance](https://github.com/phishdestroy/TgWitness/blob/main/docs/TRUST.md) et [le format de preuve](https://phishdestroy.io/tgwitness/fr/docs/reference/evidence/).

## Échelle publiée et performances mesurées

Les résultats suivants décrivent différentes charges de travail et dates. Les comptages ne sont pas interchangeables : un événement du journal ne correspond pas nécessairement à un message Telegram unique.

| Date | Charge de travail | Résultat publié | Ce qui a été mesuré |
| --- | --- | --- | --- |
| 1er novembre 2026 | Serveur en cours d'exécution, dix bases de données d'espaces de travail | Enregistrements du journal 1,610,818 ; événements de nouveaux messages 900,232, événements de modification 80,683 et événements de suppression 400,536 | Inventaire en lecture seule des journaux stockés |
| 5 novembre 2026 | Recherche parmi les messages synthétiques 1,000,000 dans les discussions 200 | Index créé en 71 secondes ; temps de recherche médian par requête compris entre 9 et 190 ms | Test de performance de recherche locale |
| 6 novembre 2026 | Deux nouvelles exportations réelles depuis Telegram | Messages 27,030 et 29,299 ; 56,329 pour les deux exécutions | Deux comptes par exécution via WARP, texte et métadonnées, aucun téléchargement de pièces jointes |
| 6 novembre 2026 | Les deux mêmes exportations, y compris la préparation et le conditionnement | 127.713 et 141.781 messages par seconde | Taux d'exportation complète mesurés ; les deux archives ont été vérifiées par rapport aux clés épinglées |

L'[enregistrement de vérification](https://phishdestroy.io/tgwitness/fr/docs/reference/verification/) fournit l'inventaire du serveur, les vérifications en temps réel de la collecte et les mesures de recherche. [Les performances d'exportation](https://phishdestroy.io/tgwitness/docs/validation/) publient les deux exécutions réelles, le matériel, les durées, les hachages d'archives et les fichiers de mesure signés, chacun avec sa révision et ses conditions enregistrées.

La [qualification historique public](https://github.com/phishdestroy/TgWitness/blob/main/docs/EXPORT-BENCHMARK-2026-11-06.md) recense également **48 archives vérifiées comprenant 3,598,381 enregistrements**, provenant d’une liste de 50 sources d’entrée et de 40 espaces de travail de comptes. Sa source A, composée de huit comptes, a acquis **768,007 enregistrements d’historique en 1,117.082 secondes**, temps d’attente compris : **687.512 enregistrements/seconde**, avec les téléchargements de pièces jointes désactivés. L’essai complet, validation comprise, a duré 1,574.920 secondes. Ces mesures décrivent cette charge de travail, parallèlement aux exemples d’exportation récente plus modestes présentés ci-dessus.

### Historique et durée des tests

TgWitness a été développé et testé pendant environ six mois. Le collecteur, le journal signé et le vérificateur ont été développés en premier ; le panneau web et les modules complémentaires ont été construits par la suite sur cette base. Ce dépôt a été créé le 29 octobre 2026 en vue de sa publication et s’appuie sur le code existant ; son âge ne correspond donc pas à celui du projet ([historique de développement](https://github.com/phishdestroy/TgWitness/blob/main/docs/QUESTIONS-AND-CHECKS.md#development-history)). La charge de travail cumulée est de l’ordre de 100 millions, incluant les exécutions antérieures, les échecs, les corrections et les validations répétées. Certaines exécutions, chacune avec sa propre révision, sa méthode et son résultat, sont documentées dans les [mesures publiques datées](https://github.com/phishdestroy/TgWitness/blob/main/docs/QUESTIONS-AND-CHECKS.md#dates-of-the-published-measurements).

## Lire avec précision l'état des capacités

Évaluer chaque workflow par rapport à sa mise en œuvre, à sa version publiée et aux tests enregistrés. Le code source est actuellement marqué comme preview. Cette mention de version coexiste avec la collecte de données, les exportations, la vérification indépendante et les mesures d’échelle publiées. Une fonctionnalité en préversion et un workflow validé peuvent coexister au sein d’une même application ; décrire la fonctionnalité spécifique et les preuves sous-jacentes à une évaluation.

Utilisez [capacités actuelles](https://github.com/phishdestroy/TgWitness/blob/main/docs/STATUS.md), [fonctionnalités et limites](https://phishdestroy.io/tgwitness/fr/docs/reference/features/), [vérification](https://phishdestroy.io/tgwitness/fr/docs/reference/verification/) et [le journal des modifications](https://phishdestroy.io/tgwitness/fr/docs/reference/changelog/) ensemble. Enregistrez la révision testée lorsque vous citez un résultat. Le 6 L'instantané de mesure de novembre conserve également les tests ayant échoué ou ayant été ignorés ; ceux-ci ne sont pas considérés comme réussis.

## Lisible par les humains et les outils d'IA

Le site web propose un document `llms.txt` concis, un manuel complet en anglais dans les sections `llms-full.txt` et `llms-full.md`, ainsi que des versions Markdown de ses pages. Il s'agit là de formats de documentation, et non d'une exigence de l'IA pour l'exécution de la section TgWitness.

L'accès facultatif en ligne de commande [MCP](https://phishdestroy.io/tgwitness/fr/docs/reference/mcp/) et  permet aux outils autorisés de lire les enregistrements sélectionnés et sauvegardés. Le contenu des messages reste une entrée non fiable. Les résumés doivent citer leurs sources, distinguer les faits observés des déductions et préserver l'incertitude. La recherche en texte intégral, la reconnaissance optique de caractères (OCR) et les résultats générés par l'IA ne modifient pas les observations signées d'origine.
