====== Structure d'un fichier torrent ======

===== Spécification =====

Une description est publiée ici: https://wiki.theory.org/index.php/BitTorrentSpecification#Metainfo_File_Structure

En résumé :

Le hash du torrent est utilisé pour identifier les torrents sur les sites de liens.

//La liste des trackers, ainsi que les commentaires, n'interviennent pas dans le calcul du hash, ce qui fait qu'on peut changer ces données sans affecter le hash du torrent. (à confirmer)//

L'une des propriétés des fichiers .torrent est le flag «private», qui a été ajouté de façon non-officielle, et qui vise à signaler que DHT et PEX doivent être désactivés sur le torrent en question. En revanche, étant donné qu'il ne s'agit pas d'une donnée standardisée, le comportement des logiciels peut varier et n'est pas défini((http://en.wikipedia.org/wiki/BitTorrent#Creating_and_publishing_torrents)).



===== Structure d'un lien magnet =====

Bien que les liens magnet soient souvent affiliés à BitTorrent, d'autres P2P utilisent des variantes (Direct Connect, eMule...) ce qui a aboutit à un standard de facto.

Voici deux exemples de lien magnet :

**magnet:?xt=urn:btih:**aa0b15c3fc0297bd29e15e7b8ba405a4572483f3**&dn=**JoJo's.Bizarre.Adventure.Diamond.is.Unbreakable.S03.SUBFRENCH.WEBRiP.720p.x264-BSD**&tr=**udp:ipv4.tracker.harry.lu:80/announce**&tr=**udp:tracker.zer0day.to:1337

**magnet:?xt=urn:btih:**2e99d97f1768644a86a8e99bfd80c816490f959b**&dn=**Linux+Mint+Debian+%5B201101%5D+%5BISO%5D+%5B32-Bit%5D+%5Bgeno7744%5D+**&tr**=udp%3A%2F%2Ftracker.openbittorrent.com%3A80**&tr**=udp%3A%2F%2Ftracker.publicbt.com%3A80**&tr=**udp%3A%2F%2Ftracker.ccc.de%3A80

Note : Dans le second exemple, les caractères sont encodés afin d'être mieux intégrés dans du code HTML.

Les mots-clés importants sont :

  * **magnet:?xt=urn:btih:**, on y appose le hash (xt = exact topic, btih = BitTorrent info hash)
  * **&dn=**, on donne une dénomination au contenu correspondant au hash (dn = data name)
  * **&tr=**, on inscrit l'URL du tracker (tr = tracker)

Voir aussi :
  * [[def>checksum#exemples]]
  * [[wp>Magnet_URI_scheme]]
  * http://www.makeuseof.com/tag/bittorrent-magnets-work-technology-explained/ 

===== Manipuler des fichiers .torrent =====

==== Créer (graphiquement) ====

La plupart des clients P2P disposent d'une fonction permettant de créer des torrents à partir de fichiers dont vous disposez sur votre disque dur.

==== Créer (en ligne de commande) ====

Voir : [[.:creer-un-torrent-avec-mktorrent]]
==== Editer un fichier torrent ====

Des outils existent pour modifier ces données.

  * [[https://sites.google.com/site/ultimasites/bencode-editor|BEncode]], un logiciel sous Windows
  * [[http://torrenteditor.com|TorrentEditor.Com]], un site qui permet d'éditer les informations triviales d'un torrent
  * [[https://github.com/drizt/torrent-file-editor|Torrent File Editor]], logiciel écrit en C++ avec interface QT, pour windows/linux/mac

Fonctionnalités de Torrent File Editor :

  * Create .torrent file from scratch
  * Edit .torrent file in user-friendly way
  * Edit .torrent file in JSON format
  * Add, remove and interchange files in .torrent file
  * Support for codings


===== Conversion Torrent <-> Magnet =====

==== Torrent vers Magnet ====

  * https://nutbread.github.io/t2m/ (web)
  * https://github.com/ungoldman/magnet-link (node.js)

==== Magnet vers Torrent ====

(à compléter)