Magnet URI scheme

Template:Short description Template:Use dmy dates Template:Multiple issues

Rounded magnet icon used on The Pirate Bay

Magnet is a URI scheme that defines the format of magnet links, a de facto standard for identifying files (URN) by their content, via cryptographic hash value rather than by their location.

Although magnet links can be used in a number of contexts, they are particularly useful in peer-to-peer file sharing networks because they allow resources to be referred to without the need for a continuously available host, and can be generated by anyone who already has the file, without the need for a central authority to issue them. This makes them popular for use as "guaranteed" search terms within the file sharing community where anyone can distribute a magnet link to ensure that the resource retrieved by that link is the one intended, regardless of how it is retrieved.

HistoryEdit

The standard for Magnet URIs was developed by Bitzi in 2002, partly as a "vendor- and project-neutral generalization" of the ed2k: and freenet: URI schemes used by eDonkey2000 and Freenet (now Hyphanet), respectively, and attempts to follow official IETF URI standards as closely as possible. BitTorrent introduced the btmh: protocol in 2020 as part of its BitTorrent v2 changes.<ref name="bitv2">{{#invoke:citation/CS1|citation |CitationClass=web }}</ref>

Format Template:AnchorEdit

Magnet URIs consist of a series of one or more parameters, the order of which is not significant, formatted in the same way as query strings that ordinarily terminate HTTP URLs.

The following parameters are supported:<ref name=":0" /><ref name="BEP-9" />

Parameter	Name	Description
xt	eXact Topic	URN containing file hash. This is the most crucial part of the magnet link, and is used to find and verify the specified file. The URN is specific to the protocol, so a file hash URN under btih (BitTorrent) would be completely different from the file hash URN for ed2k `xt=urn:btih:c12fe1c06bba254a9dc9f519b335aa7c1367a88a`
dn	Display Name	A filename to display to the user, for convenience.
xl	eXact Length	The file size, in bytes
tr	address TRacker	Tracker URL; used to obtain resources for BitTorrent downloads without a need for DHT support.<ref name="BEP-9"/> The value must be URL encoded. `tr=http%3A%2F%2Fexample.org%2Fannounce`
ws	Web Seed	The payload data served over HTTP(S)
asTemplate:Citation needed	Acceptable Source	Refers to a direct download from a web server. Regarded as only a fall-back source in case a client is unable to locate and/or download the linked-to file in its supported P2P network(s) `as=[web link to file(URL encoded)]`
xsTemplate:Citation needed	eXact Source	Either an HTTP (or HTTPS, FTP, FTPS, etc.) download source for the file pointed to by the Magnet link, the address of a P2P source for the file or the address of a hub (in the case of DC++), by which a client tries to connect directly, asking for the file and/or its sources. This field is commonly used by P2P clients to store the source, and may include the file hash. `xs=http://[Client Address]:[Port of client]/uri-res/N2R?[ URN containing a file hash ]` `xs=http://192.0.2.27:6346/uri-res/N2R?urn:sha1:FINYVGHENTHSMNDSQQYDNLPONVBZTICF`
ktTemplate:Citation needed	Keyword Topic	Specifies a string of search keywords to search for in P2P networks, rather than a particular file `kt=martin+luther+king+mp3`
mtTemplate:Citation needed	Manifest Topic	Link to the metafile that contains a list of magnets (MAGMATemplate:Spaced ndash MAGnet MAnifest); i.e. a link to a list of links `mt=http://example.org/all-my-favorites.rss` `mt=urn:sha1:3I42H3S6NNFQ2MSVX7XZKYAYSCX5QBYJ`
citation	CitationClass=web }}</ref><ref>{{#invoke:citation/CS1\|citation	CitationClass=web }}</ref>	Select Only	citation	CitationClass=web }}</ref> indicated as individual or ranges (inclusive) of file indexes. `so=0,2,4,6-8`
x.pe	PEer	Specifies fixed peer addresses to connect to. Used to bootstrap discovery of peers in the absence of (e.g.) trackers or DHT.<ref name="BEP-9" /> `x.pe=hostname:port` `x.pe=ipv4-literal:port` `x.pe=[ipv6-literal]:port`

The standard also allows for application-specific experimental parameters, which must begin with "x".Template:Citation needed

Exact Topic (xt)Edit

The xt parameter specifies the URN for a given p2p protocol. Its purpose is to provide a search parameter for finding the metadata to the torrent. This effectively acts as a replacement to a .torrent file, which itself contains the torrent metadata, by instead searching the p2p network (using the URN) for that metadata. Each protocol handles a URN uniquely; for example, xt=urn:btih:FFC7E738EAA4CD4ECF51EC6FD669C6CDE2C281A8 uses the btih (BitTorrent v1 protocol), so a BitTorrent client can take the hash and lookup the torrent's metadata in the BitTorrent DHT.<ref>{{#invoke:citation/CS1|citation |CitationClass=web }}</ref> In the case of DHT the client searches through a set of pre-known nodes and requests the metadata for an infohash; those nodes will make the same request to other known nodes until eventually a swarm is found and returned.

xt also allows for a group setting. Multiple files can be included by adding a count number preceded by a dot (".") to each link parameter.Template:Citation needed

magnet:?xt.1=[ URN of the first file]&xt.2=[ URN of the second file]

Tiger Tree Hash (TTH): These hashes are used on Direct Connect and G2 (Gnutella2), among others.; xt=urn:tree:tiger:[ TTH Hash (Base32) ]
Secure Hash Algorithm 1 (SHA-1): These hash sums are used on gnutella and G2 (Gnutella2).; xt=urn:sha1:[ SHA-1 Hash (Base32) ]
BitPrint: Such hash sums consist of an SHA-1 Hash, followed by a TTH Hash, delimited by a point; they are used on gnutella and G2 (Gnutella2).; xt=urn:bitprint:[ SHA-1 Hash (Base32) ].[ TTH Hash (Base32) ]
ED2K (eDonkey2000) hash: These hash sums are used on eDonkey2000.; xt=urn:ed2k:[ ED2K Hash (Hex) ]
Advanced Intelligent Corruption Handler (AICH): Not formal URNs for Magnet links, such hash sums are used by eDonkey2000 to restore and control the integrity of downloading and already downloaded files.; xt=urn:aich:[ aich Hash (Base32) ]
Kazaa hash: Used on FastTrack, these hash sums are vulnerable to hash collision attacks.; xt=urn:kzhash:[ Kazaa Hash (Hex) ]
BitTorrent info hash (BTIH): These are hex-encoded SHA-1 hash sums of the "info" sections of BitTorrent metafiles as used by BitTorrent to identify downloadable files or sets of files. For backwards compatibility with existing links, clients should also support the Base32 encoded version of the hash.<ref name="BEP-9">{{#invoke:citation/CS1|citation

|CitationClass=web }}</ref>

xt=urn:btih:[ BitTorrent Info Hash (Hex) ]; Some clients require Base32 of info_hash (e.g., Vuze).
BitTorrent info hash v2 (BTMH): BitTorrent v2 replaces the obsolete SHA-1 hash with a SHA-256 info hash. The v2 info-hash is given a new prefix (btmh) to allow for torrents that can participate in both v1 and v2 swarms.<ref name="bitv2"/>; xt=urn:btmh:[1220: (v2 prefix) BitTorrent Info Hash (Hex) ]
Message Digest 5 (MD5): Supported by G2 (Gnutella2), such hashes are vulnerable to hash collision attacks.; xt=urn:md5:[ MD5 Hash (Hex) ]

Web links to the fileEdit

There are two types of download links that a Magnet link can include as a direct or backup source.

"as" ("acceptable source"): Most clients treat "as" as equal to the "xs" token when it comes to priority, and ignore the timeout before contacting "as" sources denoted by the specs.
Content-Addressable Web URL: This type of Template:IETF RFC-based link is used by gnutella as well as G2 applications.<ref>{{#invoke:citation/CS1|citation

|CitationClass=web }}</ref>

xs=http://[Client Address]:[Port of client]/uri-res/N2R?[ URN containing a file hash ]; xs=http://192.0.2.27:6346/uri-res/N2R?urn:sha1:FINYVGHENTHSMNDSQQYDNLPONVBZTICF
Link to a DirectConnect hub to find sources for a file: This type of link connects a DirectConnect client immediately to the hub in question.; xs=dchub://[hub address]:[hub port]
Reference to a web-based source cache for a file on Gnutella2: In this case, the included link points, not to a client IP or direct source, but to a source cache which stores the IPs of other clients contacting it to download the same file. Once a client connects to the cache, it is served IPs for alternate sources, while its own IP is stored within the cache and forwarded to the next one connecting to the cache. This system operates similar to a BitTorrent tracker.; xs=http://cache.freebase.be/[ SHA-1 hash ]
Reference to an eD2k source: xs=ed2kftp://[client address]:[client port]/[ed2k hash]/[file size]/

Supplement format (x.)Edit

For experimental and self-complementing informal options, the prefix <syntaxhighlight lang="text" class="" style="" inline="1">x.</syntaxhighlight> followed by a chosen suffix letter can be used. These names are guaranteed to never be standardized.

x.[name of the new parameter]=[data of the new parameter (URL encoded)]Template:Citation needed

ClientsEdit

Client	dn	xl	xt	tr	xs	as	kt	mt	ws
AMule	Template:Yes	Template:Yes	`urn:ed2k:`	Template:No	Template:Unk	Template:Unk	Template:Unk	Template:Unk	Template:Unk
ApexDC++	Template:Yes	Template:Yes	`urn:bitprint:` `urn:tree:tiger:`	Template:No	Template:Yes<ref name="Dchub" group="Note">dchub://[hubaddress]:[hubport]</ref>	Template:Yes<ref name="Dchub" group="Note"/>	Template:No	Template:No	Template:Unk
BitComet	Template:Yes	Template:Yes	`urn:btih:`	Template:Yes	Template:Yes`1.76`	Template:No	Template:No	Template:No	Template:Yes`1.74`<ref name="v1.74 Core Improve: support ws parameter in Magnet URI, to add web seed">{{#invoke:citation/CS1\|citation	CitationClass=web }}</ref>
Bitflu	Template:Yes	Template:No	`urn:btih:`	Template:Yes	Template:No	Template:No	Template:No	Template:No	Template:Unk
Deluge	Template:Yes	Template:No	`urn:btih:`	Template:Yes	Template:No	Template:No	Template:No	Template:No	Template:Unk
EiskaltDC++	Template:Yes	Template:Yes	`urn:tree:tiger:` `urn:bitprint:` `urn:btih:`<ref name="toBTClient" group="Note">Passes link to external software</ref> `urn:btmh:`<ref group="Note" name="toBTClient"/>	Template:No	Template:Yes<ref group="Note" name="Dchub" /> adc:<ref name="ADC" group="Note">adc://[hubaddress]:[hubport]</ref> adcs:<ref name="ADCS" group="Note">adcs://[hubaddress]:[hubport]</ref>	Template:Yes<ref name=Dchub group=Note/>	Template:Yes	Template:No	Template:Unk
FlylinkDC++	Template:Yes	Template:Yes	`urn:tree:tiger:` `urn:bitprint:` `urn:btih:`	Template:No	Template:Yes<ref group="Note" name="Dchub" /> adc:<ref name="ADC" group="Note"/> adcs:<ref name="ADCS" group="Note"/>	Template:Yes<ref name=Dchub group=Note/>	Template:Yes	Template:No	Template:Unk
gtk-gnutella	Template:Yes	Template:Yes	`urn:sha1:`	Template:No	Template:Yes push:	Template:Yes	Template:Yes	Template:No	Template:Unk
KTorrent	Template:Yes	Template:No	`urn:btih:`	Template:Yes	Template:No	Template:No	Template:No	Template:No	Template:Unk
LimeWire	Template:Yes	Template:Yes	`urn:sha1:`	Template:No	Template:Yes urn:guid:	Template:Unk	Template:No	Template:No	Template:Unk
MonoTorrent	Template:Yes	Template:Yes	`urn:btih:`	Template:Yes	Template:No	Template:Yes	Template:No	Template:No	Template:Unk
μTorrent	Template:Yes	Template:No	`urn:btih:`	Template:Yes	Template:No	Template:No	Template:No	Template:No	Template:Yes
qBittorrent	Template:Yes	Template:Yes<ref>{{#invoke:citation/CS1\|citation	CitationClass=web }}</ref>	`urn:btih:` `urn:btmh:`	Template:Yes	Template:Unk	Template:Unk	Template:No	Template:No	Template:Unk
Shareaza	Template:Yes	Template:Yes	`urn:bitprint:` `urn:btih:` `urn:ed2k:` `urn:md5:` `urn:sha1:` `urn:tree:tiger:`	Template:Yes<ref group=Note>Since v2.5.1.0</ref>	Template:Yes ftp:	Template:Yes ftp: (Same priority as xs)	Template:Yes	Template:No	Template:Unk
Tixati	Template:Yes	Template:Yes	`urn:btih:`	Template:Yes	Template:Yes	Template:Yes	Template:Unk	Template:Unk	Template:Yes
Transmission<ref name=":0">{{#invoke:citation/CS1\|citation	CitationClass=web }}</ref><ref>{{#invoke:citation/CS1\|citation	CitationClass=web }}</ref>	Template:Yes	Template:No	`urn:btih:`	Template:Yes	Template:No	Template:No	Template:No	Template:No	Template:Yes<ref>{{#invoke:citation/CS1\|citation	CitationClass=web }}</ref>
Vuze	Template:Yes	Template:Yes	`urn:btih:` `urn:sha1:`	Template:Yes	Template:Yes`5.7.5.0`	Template:Yes`5.7.5.0`	Template:No	Template:No	Template:Yes

Explanatory notesEdit

Template:Reflist

ReferencesEdit