Home

A free C++ BitTorrent/HTTP/FTP Download Client

English
inside_bitcomet
 
Trace:

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
inside_bitcomet [2011/01/15 20:47] – [Torrent File Format] greywizardinside_bitcomet [2022/06/20 15:11] (current) – [BC Link Format (obsoleted as of v.1.17)] wxhere
Line 137: Line 137:
 ==== BC Link Format (obsoleted as of v.1.17) ====  ==== BC Link Format (obsoleted as of v.1.17) ==== 
  
-A BC Link contains information for creating a BT task, HTTP task or FTP task.+A //BC Link// contains information for creating a BT task, HTTP task or FTP task.
 The basic plain format is as following: The basic plain format is as following:
  
Line 146: Line 146:
 In additional, more parameters can be added: In additional, more parameters can be added:
  
-  bc://bt2/${TaskName}/${FileSize}/${InfoHash}/?torrent=${torrent_url} +  bc://bt2/${TaskName}/${FileSize}/${InfoHash}/?torrent=${torrent_url}&infohash_v2=${InfoHashv2} 
-  bc://http2/${TaskName}/?url=${url}&usr=${username}&psd=${password}&refer=${url_referer}&cookie=${url_cookie}+  bc://http2/${TaskName}/?url=${url}&usr=${username}&psd=${password}&refer=${url_referer}&cookie=${url_cookie}&user_agent=${user_agent}&mirror=${mirror_url}&custom_headers_for_mirrors=true
   bc://ftp2/${TaskName}/?url=${url}&usr=${username}&psd=${password}   bc://ftp2/${TaskName}/?url=${url}&usr=${username}&psd=${password}
 +  
 Finally, with the advantage of hiding details from end-user, the BASE64 encoded format is recommended to distribute for public: Finally, with the advantage of hiding details from end-user, the BASE64 encoded format is recommended to distribute for public:
  
Line 158: Line 158:
  
 <html><span style=color:Teal>Note:</span></html> To support various languages besides English, all parameters should be UTF8 + URL_Escape encoded before Base64 encoding.  <html><span style=color:Teal>Note:</span></html> To support various languages besides English, all parameters should be UTF8 + URL_Escape encoded before Base64 encoding. 
 +
 +<html><span style=color:Teal>Note:</span></html> If multiple HTTP mirrors available for a HTTP task, multiple "mirror" parameters can be added.
 +
 +<html><span style=color:Teal>Note:</span></html> If "custom_headers_for_mirrors" parameter is true, the "referer", "cookie" and "user_agent" will also be sent to mirror addresses.
 +
 +<html><span style=color:Teal>Note:</span></html> Starting with BitComet v.1.17 //BC Links// have been replaced by //Magnet Links// (see below).
  
 ---- ----
Line 164: Line 170:
  
 A [[peers_seeds_torrent_tracker_dht_peer_exchange_pex_magnet_links#magnet_links|Magnet URI]] contains information for locating a P2P resource. BitComet can use it to start a BT download. A [[peers_seeds_torrent_tracker_dht_peer_exchange_pex_magnet_links#magnet_links|Magnet URI]] contains information for locating a P2P resource. BitComet can use it to start a BT download.
-The format is as following:+The basic v1 format is as following:
  
-  magnet:?xt=urn:btih:<info-hash>&dn=<name>&tr=<tracker-url>&xl=<task-size>+  magnet:?xt=urn:btih:<info-hash-v1> 
 + 
 +The basic v2 format with a 32 bytes info hash of SHA256: 
 + 
 +  magnet:?xt=urn:btmh:1220<info-hash-v2> 
 + 
 +The hybrid format with info hash v1 and v2: 
 + 
 +  magnet:?xt=urn:btih:<info-hash-v1>&xt=urn:btmh:1220<info-hash-v2> 
 +   
 +In additional, more parameters can be added:   
 + 
 +  magnet:?xt=urn:btih:<info-hash-v1>&dn=<name>&xl=<task-size>&tr=<tracker-url>&ws=<escaped_web_seed_url>&xs=<escaped_torrent_file_url>
  
 ---- ----
Line 172: Line 190:
 === Mandatory parameter === === Mandatory parameter ===
  
-**xt**=urn:btih:<info-hash> is a mandatory parameter for BitTorrent magnetic links.+**xt**=urn:btih:<info-hash-v1> is a mandatory parameter for BitTorrent v1 magnetic links. 
 + 
 +**<info-hash-v1>** is the torrent info-hash-v1 hex encoded, for a total of 40 characters. The 32 character [[http://www.ietf.org/rfc/rfc3548.txt|base32]] encoded info-hash-v1 is also accepted. 
 + 
 +**xt**=urn:btmh:1220<info-hash-v2> is a mandatory parameter for BitTorrent v2 magnetic links.
  
-**<info-hash>** is the torrent info-hash hex encoded, for a total of 40 characters. The 32 character [[http://www.ietf.org/rfc/rfc3548.txt|base32]] encoded info-hash is also accepted.+**<info-hash-v2>** is the torrent info-hash-v2 hex encoded, for a total of 64 characters.
  
 ---- ----
Line 181: Line 203:
  
 **dn** is the user-friendly display name (which may be displayed while waiting for metadata); it should be UTF8 + URL_Escape encoded for non-English characters.\\ **dn** is the user-friendly display name (which may be displayed while waiting for metadata); it should be UTF8 + URL_Escape encoded for non-English characters.\\
-**tr** is a tracker URL, if there is one; for multiple trackers multiple "tr" parameters may be added.\\ 
 **xl** is the task size.\\ **xl** is the task size.\\
 +**tr** is a tracker URL, if there is one; for multiple trackers multiple "tr" parameters may be added.\\
 +**ws** is the escaped web seed URL.\\
 +**xs** is the escaped HTTP URL of torrent file.\\
 +
 For a technical introduction to Magnet URIs please refer to [[wp>Magnet URI scheme]]. For a technical introduction to Magnet URIs please refer to [[wp>Magnet URI scheme]].
  
Line 251: Line 276:
   - When a task finished downloading, a Hash Checking will be performed to prepare for eMule plugin uploading, if the torrent is not private and the eMule plugin is not disabled, but it was not supported by the torrent maker.   - When a task finished downloading, a Hash Checking will be performed to prepare for eMule plugin uploading, if the torrent is not private and the eMule plugin is not disabled, but it was not supported by the torrent maker.
   - When a task finished downloading, a Hash Checking will be performed if the "//bittorrent.hash_check_on_finished//" option on the //Advanced Options// page is set to TRUE.    - When a task finished downloading, a Hash Checking will be performed if the "//bittorrent.hash_check_on_finished//" option on the //Advanced Options// page is set to TRUE. 
 +
 +----
 +
 +==== AJAX interface for Remote Download ====
 +
 +see details in [[AJAX interface for Remote Download|this page]]
  
 ---- ----
 -[[bitcomet_command_line|Previous Page]]\\ -[[bitcomet_command_line|Previous Page]]\\
 -[[start|Main Index]] -[[start|Main Index]]
 
inside_bitcomet.1295124425.txt.gz · Last modified: 2015/08/15 04:21 (external edit)
  • Recent Changes
  • Media Manager
  • Sitemap
  • Show page
  • Old revisions
  • Backlinks
  • Back to top
    • Recent changes RSS feed Driven by DokuWiki

    Copyright © 2003-2010 BitComet. All rights reserved. License | Privacy policy | Terms of use