# TgWitness: Telegram Export, OSINT & Verification

Canonical page: https://phishdestroy.github.io/TgWitness/docs/reference/overview/

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

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

[Documentation index](https://phishdestroy.github.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.github.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 champ d’application, les autorisations et les copies de partage réduites aident les opérateurs à choisir ce qu’ils souhaitent collecter et divulguer. Les conseils relatifs à la juridiction et les paramètres de rapport facilitent cette décision ; la sélection d’un profil ne garantit pas en soi la conformité légale ni l’ admissibilité. Voir [exportation de compte](https://phishdestroy.github.io/TgWitness/fr/docs/reference/account-export/), [accès](https://phishdestroy.github.io/TgWitness/fr/docs/reference/access/) et [configuration du rapport](https://phishdestroy.github.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. Les fonctionnalités optionnelles d'OCR, de transcription et d'analyse par IA ont leurs propres exigences en matière de 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 ; une installation facile ne garantit pas une empreinte mémoire fixe pour chaque charge de travail.

## 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é. |

Ces vérifications permettent de contrôler l’intégrité et la provenance. Elles ne transforment pas le contenu d’un message en une affirmation vraie et ne permettent pas de reconstituer des messages supprimés qui n’ont jamais été vus. Utilisez une empreinte de clé obtenue de manière indépendante ainsi que les étapes de vérification décrites dans [le guide de confiance](https://github.com/phishdestroy/TgWitness/blob/main/docs/TRUST.md) et [le format de preuve](https://phishdestroy.github.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 ; il ne s'agit ni d'un test de débit ni d'une nouvelle vérification de la chaîne complète. |
| 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 ; ne concerne pas la diffusion en temps réel sur Telegram |
| 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.github.io/TgWitness/fr/docs/reference/verification/) fournit l'inventaire du serveur, les vérifications de collecte en temps réel et les mesures de recherche. [Les performances d'exportation](https://phishdestroy.github.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. Elles établissent des résultats pour les révisions et les conditions enregistrées, et non un taux universel ou un plafond de capacité.

### Historique et durée des tests

Le responsable du projet fait état de plus de six mois de tests au 6 novembre 2026. Ceci décrit l’historique des tests du projet. Les mesures publiques datées ci-dessus documentent des exécutions individuelles ; elles n’établissent pas une collecte ininterrompue de six mois vérifiée de manière indépendante. L’ancienneté des messages exportés est également différente de la durée de fonctionnement du collecteur.

## 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.github.io/TgWitness/fr/docs/reference/features/), [vérification](https://phishdestroy.github.io/TgWitness/fr/docs/reference/verification/) et [le journal des modifications](https://phishdestroy.github.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.github.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.