| Both sides previous revisionPrevious revisionNext revision | Previous revision |
| inside_bitcomet [2012/08/30 03:53] – wxhere | inside_bitcomet [2022/06/20 15:11] (current) – [BC Link Format (obsoleted as of v.1.17)] wxhere |
|---|
| 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: |
| |
| |
| <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). | <html><span style=color:Teal>Note:</span></html> Starting with BitComet v.1.17 //BC Links// have been replaced by //Magnet Links// (see below). |
| |
| 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> |
| |
| ---- | ---- |
| === 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>** 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-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-v2>** is the torrent info-hash-v2 hex encoded, for a total of 64 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.\\ | **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]]. |
| |
