Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

iTechGuides is reader-supported. When you buy through links on our site, we may earn an affiliate commission. As an Amazon Associate I earn from qualifying purchases. Learn more

First check where the process stops: if clicking a magnet link does not open qBittorrent, fix the magnet: protocol association; if qBittorrent opens and stays on “Retrieving metadata” or “Gathering info,” the link reached the client and it is waiting for torrent information from the swarm.

Find out which failure you have

What happens after you click Where the process stopped What to check
Nothing happens, or a different app opens The browser or operating system did not hand the magnet: link to qBittorrent. Set qBittorrent as the magnet-link handler in the operating system or browser. The qBittorrent options documentation describes the association and notes it can also be managed through system settings or the browser.
qBittorrent opens, but the torrent has no details and shows “Retrieving metadata” or “Gathering info” The handoff worked; qBittorrent has not yet obtained the torrent metadata. Allow time for discovery. Magnet links rely on peers to provide metadata, so a swarm without reachable metadata sources may remain unresolved. See the libtorrent magnet-links manual and qBittorrent FAQ.

If clicking the link does nothing or opens the wrong app

A magnet link uses the magnet: URI protocol. It is separate from the file association for .torrent files, so setting qBittorrent to open torrent files does not necessarily make it the magnet-link handler. qBittorrent’s options documentation says this association can be controlled in the application, in system defaults, or in the browser.

  1. In qBittorrent’s options, look for the setting to associate the client with magnet links and enable it if available. The precise label and location can vary by version and operating system.
  2. Check the operating system’s default-app or protocol-handler settings and choose qBittorrent for the magnet protocol. The exact screens differ across Windows, macOS, and Linux.
  3. If the browser asks which application should handle a magnet link, select qBittorrent. If you previously chose another app or declined the prompt, review the browser’s link-handling settings.
  4. Click the magnet link again. If qBittorrent launches, the protocol handoff is working; use the next section if the task remains without details.

Do not apply a protocol-association fix when qBittorrent already opens from the link: in that case, the issue is downstream of the handoff.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

If qBittorrent opens but remains on “Retrieving metadata”

A magnet link is not a complete .torrent file. It carries an info-hash and may include a display name or tracker, but qBittorrent still needs torrent metadata from peers before it can show the full torrent details. The libtorrent manual explains that magnet links typically rely on DHT for discovery; metadata retrieval can take time, and a swarm with no reachable metadata sources may never resolve.

#1 Best Overall
Sale
TP-Link USB Bluetooth Adapter for PC - Bluetooth 5.4 USB Dongle Receiver
  • Bluetooth 5.4 + Broad Compatibility - Provides Bluetooth 5.4 plus EDR technology and is backward compatible with Bluetooth V5.3/5.0/4.2/4.0/3.0/2.1/2.0/1.1.
  • Faster Speed, Extended Range - Get up to 2x faster data transfer and 4x broader coverage compared to Bluetooth 4.0 — perfect for smooth audio streaming and stable connections.
  • EDR and BLE Technology - This Bluetooth dongle is quipped with enhanced data rate and Bluetooth low energy, UB500 has greatly improved data transfer speed and operates at the optimal rate of power consumption
  • Nano-Sized - A sleek, ultra-small design means you can insert the Nano Bluetooth receiver into any USB port and simply keep it there regardless of whether you are traveling or at home
  • Plug & Play with Free Driver Support - Plug and play for Windows 8.1/10/11 (internet required). Supports Win7 (driver required and can be downloaded from website for free). Download the latest driver from TP-Link website to utilize Bluetooth 5.4
  1. Give qBittorrent some time to retrieve metadata. The absence of torrent details immediately after adding a magnet does not by itself mean the browser handoff failed.
  2. Check that the magnet link was copied or opened intact. A truncated or altered URI may not identify the intended torrent correctly.
  3. If needed, use qBittorrent’s own Add Torrent Link interface to paste the magnet URI. The qBittorrent help and FAQ describe adding magnet links directly; this also helps distinguish a browser handoff problem from a link or metadata-discovery problem.
  4. If it remains unresolved, the swarm may not be providing metadata to your client. A protocol-association change will not make metadata available.

If you use qBittorrent WebUI

WebUI users may route browser magnet links to a remote qBittorrent instance with a browser extension. The qBittorrent FAQ lists extensions for this workflow. If the link is being sent to WebUI, check that the extension is configured for the intended WebUI endpoint and that you can access that WebUI. This route is relevant only when you deliberately use a remote client; it is not required for ordinary desktop qBittorrent.

Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Check version and platform before trying version-specific fixes

Association behavior and magnet handling can differ by operating system and qBittorrent version. The project history records past fixes for Windows magnet association under non-admin accounts and for a race condition when adding a magnet. Those entries show that implementation issues have existed, but they do not establish that either issue explains a current failure. Check the qBittorrent release history and the current official downloads page for your platform before relying on version-specific advice. Available builds and platform support can change; the project notes that macOS is barely supported because it has no active macOS developers or contributors.

Best Value
Sale
Long Range USB Bluetooth 5.4 Adapter for Desktop PC Plug&Play Mini Dongle
  • Bluetooth 5.4 dongle: Applies the latest Bluetooth 5.4+EDR technology, compatible with Bluetooth 5.3/5.2/4.2/4.2 LE/4.0/2.1+EDR, and supports Dual mode (BR/EDR+ Bluetooth Low Energy) to achieve low energy consumption and high speed. Quick response and better anti-interference.
  • Plug & Play: USB wireless Bluetooth is not limited by network and location, no need to install drivers, just plug the USB wireless adapter into your computer, you can use it directly. You can use the Bluetooth function at any time. Greatly improve your work efficiency and save your time.
  • Long Range Bluetooth Adapter: The USB Bluetooth 5.4 dongle uses Class 1 radio technology, equipped with extra long antenna, and the transmission range in the open area can reach 500ft/150m, Bluetooth connections are no longer affected by distance. Note: The actual transmission range will be affected by physical obstructions and wireless interference.
  • Fast Transmission Rate: This upgraded Bluetooth 5.4 adapter features EDR technology and Bluetooth Low Energy (BLE) configuration up to 3Mbps, which greatly improves transmission rates and reduces the loss of transmission efficiency due to interference in the 2.4GHz band. Enables fast, no delay wireless data connections between your computer and Bluetooth devices.
  • System Support: The upgraded Bluetooth 5.4 dongle has a wide range of applications. You can connect up to 5 devices at the same time using Bluetooth wireless. Such as Bluetooth speakers,keyboards,headsets,mice, and Bluetooth printers,etc. Only supports Windows 11/10/8.1, Not compatible with Mac OS, Linux,car stereo systems,XBOX,ps4 or TVs.
Rank #4
UGREEN USB Bluetooth Adapter for PC Bluetooth 6.0 Dongle Receiver
  • This Bluetooth adapter for PC utilizes the latest Bluetooth 6.0 EDR technology, delivering faster data transfer speeds, seamless high-quality audio/video streaming, and efficient large-file transfers.
  • Up to 5 Devices Sync Connected: This Bluetooth dongle for PC supports up to 5 different types of Bluetooth devices to be connected at the same time without interfering with each other, such as Bluetooth mouse/keyboard/mobile phone/headphones, etc. Note: If Bluetooth audio devices of the same type (such as speakers/headphones) are connected, only one device can play music.
  • Ultra-High Data Transfer Speeds: With Bluetooth 6.0 technology, this bluetooth dongle will bring us a faster speed experience. And Bluetooth 6.0 is backward compatible with Bluetooth5.4/5.3.
  • EDR and BLE Technology - This Bluetooth dongle is equipped with enhanced data rate and Bluetooth low energy, it wil optimize energy.
  • Plug and Play: The Bluetooth receiver is developed for Windows systems only and does not support other systems. No driver installation is required under Windows 11/10/8.1. NOTE: Linux and MacOS , Win 7 System are NOT supported.
Rank #3
UGREEN USB Bluetooth 5.3 Adapter for PC Bluetooth Dongle Receiver
  • Upgraded Bluetooth 5.3 Adapter: This bluetooth adapter for pc uses the latest upgraded Bluetooth 5.3 BR+EDR technology, greatly improves the stability of the connection data transfer speed, reduces the possibility of signal interruption and power consumption.
  • Up to 5 Devices Sync Connected: UGREEN Bluetooth dongle for PC supports up to 5 different types of Bluetooth devices to be connected at the same time without interfering with each other, such as Bluetooth mouse/keyboard/mobile phone/headphones, etc. If Bluetooth audio devices of the same type (such as speakers/headphones) are connected, only one device can play music.
  • Plug and Play: The Bluetooth adapter is developed for Windows systems only and does not support other systems. No driver installation is required under Windows 11/10/8.1. NOTE: Win 7, Linux and MacOS System are NOT supported.
  • Mini Size: An extremely compact Bluetooth stick that you can leave on your laptop or PC without removing it.The compact size does not interfere with other USB ports. Convenient to carry, no space occupation.
  • What Can I do if the Bluetooth adapter can not work?: Ensure there are no other Bluetooth devices installed on the computer. If there are, disable all existing Bluetooth devices in "Device Manager", then insert the adapter and try again. (For detailed information please read the user manual)
Rank #2
Amazon Basics Bluetooth 5.4 USB Adapter Dongle for PC, USB Receiver for Bluetooth Mouse, Keyboard, Laptop, Works with Windows 11/10/8.1
  • INSTANT BLUETOOTH ACCESS: Bluetooth dongle adapter receiver for PCs converts non-Bluetooth devices into Bluetooth-capable with simple USB connection
  • WIDE COMPATIBILITY: Supports Bluetooth 5.4 and is backwards compatible with Bluetooth 5.3/5.2/5.1/5.0/V4.2/4.0/3.0/2.1/2.0/1.1; ONLY works with Windows 8.1, 10, and 11
  • MULTI-DEVICE CONNECTION: Connect up to 6 devices simultaneously; Not compatible with all other operation systems e.g. Mac, Linux, Chrome, Unix, Playstation(PS), Windows 7 and below; Nano bluetooth receiver can be plugged in via any standard USB port
  • ENHANCED PERFORMANCE: EDR and BLE technology offers enhanced data rate/transfer speed and low energy consumption
  • SYSTEM REQUIREMENTS: Not compatible with all other operation systems e.g. Mac, Linux, Chrome, Unix, Playstation(PS), Windows 7 and below; Disable any built-in Bluetooth of the device before use this product, refer to the user manual for detail

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.