Stuck on Retrieving Metadata? Why It Happens and How to Fix It

On a busy torrent the metadata step is over before you notice it. If it lasts more than a few minutes, two quick checks tell you whether the problem is the torrent or your setup:

Is your peer discovery working? In qBittorrent, the status bar at the bottom shows DHT: N nodes, and the number should climb well above zero within a few minutes. Then open the stuck torrent's Trackers tab: at least one tracker should say Working.
Does a known-good magnet work? Paste the magnet link for Sintel, Blender's open movie (CC BY), from WebTorrent's free torrents page. If its metadata arrives quickly, your setup is fine and the stuck torrent simply has nobody online.

What you see	Likely cause	Section
DHT has nodes, trackers work, still no peers	Nobody online has the torrent	No peers
"DHT: 0 nodes", or DHT shows "Disabled"	DHT off or blocked	DHT
Trackers tab empty, or every tracker "Not working"	Magnet has no usable trackers	Trackers
Works without the VPN or proxy, stuck with it	VPN or proxy blocking UDP	VPN or proxy
Stuck on one network (work, school), fine at home	Firewall	Firewall

If the metadata arrives but the download then crawls, that is a different problem; why a torrent is slow or stuck covers the download-speed side.

What metadata is, and how a magnet gets it

A .torrent file has two parts: tracker addresses, and an "info dictionary" that describes the content. The info dictionary holds the file names, their sizes, the piece size, and a SHA-1 checksum for every piece. The torrent's info hash, the 40-character code in a magnet link, is the hash of that info dictionary. That is all the metadata is.

It is small. Each version 1 piece checksum is 20 bytes, so a 4 GiB film cut into 2 MiB pieces has 2,048 pieces and about 40 KB of checksums. Size is never why metadata is slow; finding someone who has it is.

When you open a magnet link, the client works through these steps, defined in the BitTorrent extension BEP 9:

Find peers. It asks every tracker listed in the magnet's tr= parameters. It looks the info hash up in the DHT, the distributed table that clients share among themselves; BEP 9 says a client should use the DHT when the magnet names no tracker. Once it reaches one peer, peer exchange (PEX) can introduce more, and Local Peer Discovery finds peers on your own network.
Ask for the metadata. Peers that support the extension advertise ut_metadata and the metadata's size when they connect. The client requests it in 16 KiB blocks.
Verify it. It hashes the result and compares it with the info hash from the link. A match proves nobody tampered with it.
Start the real download. From here a magnet behaves exactly like a .torrent file.

One detail explains a lot of stuck magnets: a peer can only send metadata it already has in full. The specification says a peer without the complete metadata must reject requests. So if the only peers your client can find are other people who are also stuck on the same magnet, nobody can help anyone. You need at least one peer that has the full torrent, or at least its metadata.

Each discovery method has a weakness:

Method	Carried over	Fails when
Trackers (`tr=`)	UDP or HTTP(S)	The magnet lists none, or they are offline
DHT	UDP	It is switched off, or UDP is blocked
PEX	Existing peer connections	You have no peer yet, so it cannot start
Local Peer Discovery	Your local network	Nobody on your network has it (the usual case)

PEX cannot rescue a magnet with no peers, because it only works through peers you are already connected to. In practice, a stuck magnet comes down to trackers and the DHT.

Causes, most likely first

1. Nobody online has it

This is the most common cause by far, and no setting fixes it. A magnet is just an address. If every seed has left the swarm, the address points at nobody.

How to tell: your discovery is working (the DHT has nodes, at least one tracker says Working), but the torrent still has no peers after several minutes. In qBittorrent's Trackers tab, the Seeds, Peers, and Leeches columns show what each tracker reported; zeros everywhere are a strong hint. The tab also has pseudo-entries at the top named ** [DHT] **, ** [PeX] **, and ** [LSD] **, with counts of the peers you are connected to that each method found. Note that "Working" on the DHT row only means the DHT is enabled for this torrent, not that it found anyone.

Transmission's status line spells it out too. It shows Magnetized transfer - retrieving metadata while it searches, and Downloading metadata from N peer(s) once it has someone to ask. "From 0 peers" for a long time means the swarm is empty or unreachable.

What to do: leave it running for a while, especially if the torrent is old or obscure, since seeds in other time zones come and go. If it is still empty after you have checked everything else, see when to give up.

2. The DHT is off or blocked

For a magnet with no trackers, the DHT is the only way to find a first peer.

Check it is on:

qBittorrent: Tools → Options → BitTorrent, tick Enable DHT (decentralized network) to find more peers and Enable Peer Exchange (PeX) to find more peers. Then check the torrent itself: right-click, Torrent options…, and make sure Disable DHT for this torrent and Disable PeX for this torrent are not ticked. If the DHT row in the Trackers tab says Disabled for this torrent, one of these is the reason, or the torrent is private (see below).
Transmission: Preferences → Network, tick Use DHT to find more peers and Use PEX to find more peers.

Check it is reaching anyone: the DHT runs over UDP. If qBittorrent's status bar stays at DHT: 0 nodes with the DHT switched on, something between you and the internet is dropping UDP. That points to causes 4 and 5.

Private torrents are the exception. A torrent marked private (BEP 27) must get its peers only from its own tracker, so clients turn the DHT and PEX off for it. Transmission labels these "Private to this tracker -- DHT and PEX disabled". If you open a magnet for a private torrent, the metadata can only come from peers the private tracker hands out, so the tracker must be in the magnet and you must be allowed to use it.

3. The magnet has no working trackers

Look at the magnet link itself. Trackers appear as tr= parameters, URL-encoded, so udp://tracker.example.org:1337 shows up as tr=udp%3A%2F%2Ftracker.example.org%3A1337. A link that is only magnet:?xt=urn:btih: plus the hash has no trackers at all and depends entirely on the DHT.

Also check that the hash is intact. A version 1 info hash is 40 hexadecimal characters (some older links use a 32-character base32 form instead). A link that was cut off when you copied it will never resolve.

Then open the torrent's Trackers tab (qBittorrent) or Tracker tab in Properties (Transmission). In qBittorrent, the status column reads Working, Not working, Updating..., Not contacted yet, Tracker error, or Unreachable. If every real tracker is failing, you have two options: rely on the DHT (cause 2), or add trackers (next section). Right-click a tracker and choose Force reannounce to all trackers after changing anything, instead of waiting for the next scheduled check.

4. A VPN or proxy blocks UDP

Both the DHT and UDP trackers use UDP, and that is exactly the traffic some VPN and proxy setups do not carry.

SOCKS5 proxies. SOCKS5 relays UDP only through a separate command (UDP ASSOCIATE, in RFC 1928). If the proxy or your client does not support it for torrent traffic, the DHT and UDP trackers go silent, and only HTTP(S) trackers can find peers. In qBittorrent, the proxy settings live under Tools → Options → Connection, with Use proxy for BitTorrent purposes and Use proxy for peer connections.
VPN servers or providers that restrict peer-to-peer traffic. Some only allow it on certain servers. Check your provider's documentation and use a server marked for P2P.
A client bound to a VPN that has dropped. If you bound qBittorrent to the VPN's network interface and the VPN disconnects, nothing gets through, metadata included. Reconnect the VPN, then force a reannounce.
Apps that switch the DHT off on purpose. Some apps disable the DHT in protected modes to avoid leaks. TorrentPlayer does this when it runs through a VPN app's adapter, its built-in WireGuard tunnel, or a SOCKS5 proxy. In those modes a magnet without working trackers has no way to find a peer, so prefer a .torrent file or a magnet that lists trackers.

Quick test: with a legal test magnet such as Sintel, compare with the VPN or proxy on and off. If the metadata only arrives without it, the tunnel is the cause. For choosing a VPN that handles torrent traffic well, and binding your client to it, see VPNs for torrenting.

5. A firewall blocks the traffic

Some managed networks, at work, at school, or on public Wi-Fi, block peer-to-peer traffic or UDP outright. At home, a security suite with its own firewall can do the same; qBittorrent's wiki warns that these can cause connection problems and high CPU use.

On Windows, open Windows Security → Firewall & network protection → Allow an app through firewall, choose Change settings, and make sure the client is ticked for the network type you are on (usually Private).
Third-party firewalls usually need their own rule for the client.
Restricted networks may simply not allow peer-to-peer traffic. Respect the network's rules; if it is not your network, it is not your call.

An unforwarded port is less of a problem here than you might think. Your client connects out to peers, so it can fetch metadata without being reachable from outside. A closed port makes it harder only when the few peers who have the metadata are also unreachable, because two unreachable peers usually cannot connect to each other. The firewall and NAT section of the slow-torrent guide covers port forwarding.

How to add trackers safely

Adding a working tracker to a public torrent can turn a magnet that relies on the DHT alone into one that finds peers in seconds. Done carelessly, it can also break rules or hand your IP address to more servers than you meant to.

Where to get trackers from. The best source is the publisher of the content. Official torrents from Linux distributions, the Internet Archive, and similar projects come with their own trackers, so take the magnet or .torrent from the official download page rather than a copy elsewhere that may have been stripped. For general use, stick to a short list of long-running public trackers rather than pasting in hundreds of addresses; dead trackers add nothing but failed connections.

How to add them:

qBittorrent, one torrent: open the Trackers tab, right-click, choose Add trackers..., and paste one announce URL per line.
qBittorrent, every new torrent: Tools → Options → BitTorrent, tick Automatically append these trackers to new downloads, and list them. qBittorrent skips these for torrents it knows are private.
Transmission, one torrent: Properties → Tracker, click Add, and enter the announce URLs, one per line.
Transmission, every public torrent: Preferences → Network → Default Public Trackers. As the name says, they apply to public torrents only.

Rules to keep it safe:

Never add trackers to private torrents. BEP 27 requires a private torrent to use only its own tracker; outside trackers would undermine the access control the private tracker relies on.
Every tracker sees your IP address and which torrent you want. Add only trackers you have a reason to trust, and remember that a VPN changes what they see, not whether they see it.
Trackers are URLs, nothing more. They start with udp://, http://, or https:// and often end in /announce. Never install a program that claims to "boost" torrents with better trackers.
More trackers cannot create seeders. If nobody is sharing the torrent, every tracker you add will report zero.

When to give up and find a better torrent

Give up on a magnet when your setup checks out and the swarm still does not:

The DHT shows nodes, at least one tracker reports Working, and a known-good test magnet loads quickly, yet this one finds no peers.
You have left it running across different times of day and the trackers still report zero seeds and zero peers.

At that point, look for another source of the same content. For legal content, that usually means going back to the publisher: the official download page of a distribution, the Internet Archive item, or the project's own site. Prefer torrents with recent activity and plenty of seeders, and prefer a .torrent file over a magnet when both are offered.

Internet Archive items are a good example of why the source matters. Items usually offer a .torrent file among their download options, and the Archive's help page says its torrents use web seeds, so a client that supports web seeding can download from the Archive's own servers even when no other peer is online.

A .torrent file skips the whole step

Everything above is about fetching the info dictionary from a peer. A .torrent file already contains it, so opening one takes you straight to step 4: your client knows the files, sizes, and checksums immediately, and only has to find peers for the content itself.

So when a site offers both, the .torrent file is the more reliable choice for an old or quiet torrent. You still need peers (or a web seed) to download anything, but you will at least see the file list right away, and you can tell at a glance whether the swarm has anyone in it. TorrentPlayer accepts both: paste a magnet link, or drag a .torrent file or link onto the window.

For more on how magnet links are built and why they need this step, see what is a magnet link and how to open and play a magnet link.

Sources

Checked on 20 October 2026.