qBittorrent is the most popular free torrent client — and for good reason. It handles magnet links natively, has excellent DHT support, and gives you detailed control over tracker configuration. This guide covers everything from basic magnet link usage to advanced settings that maximise performance.
Opening a Magnet Link in qBittorrent
Method 1: Click the Link (Simplest)
If qBittorrent is set as your default magnet handler, clicking any magnet link will open qBittorrent automatically and prompt you to choose a save location.
Method 2: File → Add Torrent from URL
- Copy the magnet link
- In qBittorrent: File → Add Torrent from URL
- Paste the magnet link and click OK
- Choose your save folder and confirm
Method 3: Drag and Drop
You can drag a magnet link from your browser address bar directly onto the qBittorrent window.
Setting qBittorrent as Default Magnet Handler
If clicking magnet links doesn't open qBittorrent, set it as the default handler:
- Windows: Tools → Options → General → check "Associate qBittorrent with magnet links"
- macOS: qBittorrent usually registers itself on first launch. If not, open qBittorrent once with a magnet link via File → Add Torrent from URL.
- Linux: Run
qbittorrent --set-handlersor usexdg-mime default qbittorrent.desktop x-scheme-handler/magnet
Optimal qBittorrent Settings for Magnet Links
BitTorrent Tab (Tools → Options → BitTorrent)
- ✅ DHT (decentralised network) — must be enabled for magnet links
- ✅ DHT for new torrents — enables per-torrent DHT lookup
- ✅ Peer Exchange (PEX) — peers share peer lists with each other
- ✅ Local Service Discovery — finds peers on your local network
- ✅ Automatically add these trackers — paste your tracker list here
Connection Tab
- Set Maximum connections per torrent to 300-500
- Enable Use UPnP / NAT-PMP port forwarding
- Check your listening port is not blocked (default: 6881)
Speed Tab
Leave global limits uncapped unless you need to limit bandwidth. Per-torrent limits can be set by right-clicking a torrent.
Reading the Trackers Tab
Click any torrent → open the Trackers tab at the bottom to see per-tracker status:
- Working — connected, peers returned ✅
- Not working — tracker down or unreachable
- Updating — currently announcing
- 0 peers (working) — tracker responds but has no peers for this torrent
- [DHT] X peers — peers found via DHT (not from trackers)
Troubleshooting: Magnet Link Stuck in qBittorrent
If your magnet link shows "Queued" or "Metadata" status indefinitely:
- Check the DHT status bar (bottom right) — it should show a green network icon with a node count
- Right-click the torrent → Edit Trackers → add public trackers
- Wait 5-10 minutes for DHT to bootstrap fully on first launch
- Check that port 6881 UDP isn't blocked by your firewall
Still stuck? Convert the magnet link to a .torrent file first:
💡 qBittorrent Can't Retrieve Metadata?
Use the Magnet to Torrent Converter to pre-fetch the metadata independently. Download the .torrent file, then open it in qBittorrent — it skips the metadata retrieval step entirely and starts downloading immediately.
Frequently Asked Questions
What does "Stalled" mean in qBittorrent?
Stalled means your client has found peers but isn't downloading — typically because all available peers are also downloading (no seeds available) or your connection to peers is blocked. Try adding more trackers and enabling UPnP.
How do I see which trackers are working?
Click the torrent → Trackers tab. Green "Working" entries are active. Right-click "Working" tracker → Copy → you can see its URL.
Does qBittorrent support BitTorrent v2 magnet links?
Yes — qBittorrent 4.4+ supports hybrid v1/v2 torrents. The info hash in v2 magnet links is 64 characters (SHA-256) rather than 40 (SHA-1).
