Home > Specs > BitTorrent
Magnet Links

Magnet links are used to start a torrent download.  They contain the torrent info hash ID, and usually also a temporary display name for the torrent that is used until the full info map is downloaded.

Example: magnet:?xt=urn:btih:jlsgqrqon246xiueantpdpqwj7ywtzyk&dn=cats&xl=54535480&fc=53

The hash section is always first.  The info hash should be base32 encoded, but base16 is also acceptable.

After, the following attributes can be added:

dn
Display name

xl
Torrent size in bytes

fc
Number of files in the torrent

tr
Tracker URL

ws
Web Seed URL

The attribute values are URL segment encoded.  This is in addition to any URL encoding that URLs may have already had.