- Fix broken magnet associations in Windows, macOS, Linux, and browsers.
- Learn when Chrome, Edge, or Firefox is blocking qBittorrent.
- Separate launch problems from Downloading metadata issues.
- Quick Checks Before Changing Settings
- Open The Magnet Link Manually In qBittorrent
- Set qBittorrent As The Magnet-Link Handler In Windows
- Fix Magnet Links In Chrome
- Fix Magnet Links In Microsoft Edge
- Fix Magnet Links In Firefox
- Fix Magnet Links On macOS
- Fix Magnet Links On Linux
- Remove Conflicts With Other Torrent Clients
- Reinstall qBittorrent Without Losing Torrent Data
- What To Do When qBittorrent Opens But The Torrent Is Not Added
- What To Do When qBittorrent Adds The Magnet But Stays On Downloading Metadata
- Frequently Asked Questions
- Conclusion
If you click a magnet link and nothing happens, qBittorrent does not open, your browser shows a warning, or a different torrent client launches instead, the problem is usually not the torrent itself. The issue is normally that the magnet link is not being handed to qBittorrent correctly.
Magnet links use the magnet: protocol. Your browser and operating system must know that qBittorrent is the app that should handle that protocol. The most common causes of qBittorrent magnet links not opening are a broken protocol association, a browser blocking the external-app prompt, another torrent client taking over the association, or a damaged qBittorrent installation.

Start with free Canva bundles
Browse the freebies page to claim ready-to-use Canva bundles, then get 25% off your first premium bundle after you sign up.
Free to claim. Canva-ready. Instant access.
1. Quick Checks Before Changing Settings
Start with the simple checks. They can save you from changing settings that are not actually broken.
- Open qBittorrent directly from its desktop shortcut, Start menu entry, Applications folder, or app launcher.
- Try more than one magnet link from a legitimate source. A single broken page button can make it look like your setup is broken.
- Restart both qBittorrent and your browser, then test again.
- Check whether qBittorrent opened in the background, minimized to the system tray, or on another monitor.
- Right-click the magnet link and copy the full link address instead of relying only on the webpage button.
If qBittorrent itself will not open normally, fix that first. Magnet links cannot work if the application is not launching at all.
2. Open The Magnet Link Manually In qBittorrent
Before you repair browser or operating-system settings, confirm that the magnet URI is valid and that qBittorrent can accept it.
2.1 How To Paste The Magnet Link Manually
- Right-click the magnet link on the webpage.
- Choose the browser option that copies the link address. The exact wording varies, such as Copy link address or Copy Link.
- Open qBittorrent.
- Use qBittorrent’s option for adding a torrent link or URL.
- Paste the complete link. It should begin with magnet:?xt=.
- Confirm the add action if qBittorrent asks you to continue.
2.2 What The Result Means
If manual pasting works, the magnet link itself is valid. The remaining problem is almost certainly the browser prompt, the operating-system protocol association, or another app intercepting the link.
If qBittorrent rejects the link, the copied text may be incomplete, altered, or not a valid magnet URI. Copy it again and confirm that it begins with magnet:.
If qBittorrent adds the torrent but it remains on Downloading metadata, that is a different issue. In that case, the magnet link reached qBittorrent successfully, but qBittorrent has not found usable metadata from peers yet.
3. Set qBittorrent As The Magnet-Link Handler In Windows
On Windows, magnet links are handled through default apps by protocol. If a magnet link does nothing, or a magnet link opens wrong application, check the MAGNET protocol assignment.
3.1 Windows 11
- Open Settings.
- Go to Apps.
- Open Default apps.
- Scroll down and choose the option for defaults by link type or protocol.
- Find MAGNET.
- Set it to qBittorrent.
- If another torrent client is assigned, replace it with qBittorrent.
- Close and reopen your browser, then test the magnet link again.
3.2 Windows 10
- Open Settings.
- Go to Apps.
- Open Default apps.
- Select Choose default apps by protocol.
- Find MAGNET.
- Choose qBittorrent as the default application.
- Restart your browser before testing again.
If qBittorrent is missing from the list, reinstalling or repairing qBittorrent may restore the qBittorrent magnet association. Download qBittorrent only from its official source. Also remember that installing or updating another torrent client later may cause that client to take over magnet links again.

4. Fix Magnet Links In Chrome
If Chrome not opening magnet links is the symptom, check both Chrome’s external-protocol prompt and your operating-system association.
4.1 Allow Chrome To Open qBittorrent
Click a magnet link and look for Chrome’s external-application confirmation prompt. If Chrome asks whether it should open qBittorrent or an external application, allow it.
Do not change ordinary website notification permissions. Browser notifications are unrelated to magnet links and will not make qBittorrent open.
4.2 Reset A Blocked Protocol Choice
If you previously denied the prompt, Chrome may remember that choice for the affected website. Open Chrome’s site settings and protocol-handler related permissions, then clear the saved permission for that site if needed. After clearing it, click the magnet link again and allow the external-app prompt.
4.3 Test Without Extensions
Temporarily disable extensions that intercept links, block scripts, block redirects, or rewrite URLs. Then test the same magnet link again.
Chrome usually passes the magnet link to the operating system. That means Windows, macOS, or Linux must still have qBittorrent registered as the correct magnet handler.
5. Fix Magnet Links In Microsoft Edge
Microsoft Edge can also block or remember decisions about external applications. If Edge asks whether to open an external application, allow it to open qBittorrent.
If the prompt was previously denied, reset the affected site’s permissions in Edge and try again. Temporarily disable extensions that may block redirects, scripts, or external protocols.
On Windows, also confirm that the MAGNET protocol is assigned to qBittorrent in Windows Settings. After changing the association, restart Edge before testing again.
6. Fix Magnet Links In Firefox
Firefox has its own Applications list for content and protocol handling. If magnet links not opening in qBittorrent happens only in Firefox, check the Firefox magnet link handler.
6.1 Set The Firefox Magnet Action
- Open Firefox.
- Open Settings.
- Find the Applications or file-handling section.
- Search for magnet.
- Set the action to use qBittorrent, or set it to ask each time.
- If another application is selected, remove or change that incorrect saved handler.
6.2 If Magnet Does Not Appear
If magnet does not appear in the Applications list, restore the operating-system association first, then click a magnet link again. You can also reinstall qBittorrent so the handler is registered again. Once Firefox sees the protocol, it should let you choose what to do with it.
7. Fix Magnet Links On macOS
On macOS, first confirm that the current qBittorrent release opens normally. If qBittorrent does not launch from the Applications folder, fix the app installation before troubleshooting browser behavior.
Try opening a magnet link. If macOS or the browser asks which app should handle it, choose qBittorrent. If the association appears missing or damaged, reinstall qBittorrent from the official source.
Move qBittorrent into the Applications folder instead of running it permanently from a disk image or temporary download location. Running apps from temporary locations can cause confusion later when the system or browser tries to open them.
After reinstalling, restart your browser. If the problem continues, restart macOS as well. Browser extensions, privacy tools, and content blockers can also prevent the external-app prompt from appearing, so test with those disabled if necessary.
8. Fix Magnet Links On Linux
Linux behavior varies by desktop environment, distribution, and package type. The general goal is to set qBittorrent as the default handler for x-scheme-handler/magnet.
First, make sure qBittorrent is installed and launches normally from your application menu. Then set the magnet scheme handler. A commonly used command is:
xdg-mime default org.qbittorrent.qBittorrent.desktop x-scheme-handler/magnet
The desktop-file name can differ depending on how qBittorrent was installed. Repository packages, Flatpak packages, and Snap packages may register different desktop entries. Do not blindly assume the example name is correct on every system.
You can inspect installed desktop files through your desktop environment’s application settings or by checking the desktop entries available on your system. After changing the handler, restart the browser or log out and back in before testing.
9. Remove Conflicts With Other Torrent Clients
Other torrent applications may take ownership of magnet links during installation or updates. If another client opens instead of qBittorrent, close or uninstall the unwanted client, then reset the MAGNET association to qBittorrent afterward.
Do not assume that uninstalling another client will automatically restore qBittorrent. In many cases, the protocol may remain unset or assigned incorrectly until you choose qBittorrent again.
Also check browser extensions. Some extensions can open links in a web-based torrent service or redirect magnet links to another application. Disable suspicious extensions and retest with a clean browser session.

10. Reinstall qBittorrent Without Losing Torrent Data
If qBittorrent is missing from protocol-handler lists or magnet registration appears damaged, reinstalling can help. Use this step after the simpler browser and default-app checks.
- Close qBittorrent completely, including any tray or background instance.
- Back up important qBittorrent configuration and resume-data folders before making major changes.
- Uninstall qBittorrent using the normal method for your operating system.
- Download and reinstall qBittorrent from the official source.
- During installation, allow qBittorrent to register supported torrent and magnet-link associations if that option is offered.
- Restart your browser and test a magnet link again.
Reinstalling the application normally does not require deleting downloaded files. Be careful not to delete configuration or resume-data folders unless you intentionally want to reset qBittorrent and remove its saved torrent state. Folder locations vary by operating system, package type, and user profile, so do not rely on one universal path.
11. What To Do When qBittorrent Opens But The Torrent Is Not Added
If qBittorrent opens but the torrent does not appear, the link reached the application but something still interrupted the add process.
- Check whether the Add New Torrent dialog opened behind another window.
- Check whether qBittorrent is configured to show a confirmation dialog before adding torrents.
- Paste the magnet URI manually using qBittorrent’s add link or URL option.
- Confirm that the copied text starts with magnet: and has not been truncated.
- Test the same link in a different browser.
- Review qBittorrent’s execution log for relevant errors.
An invalid or incomplete magnet link cannot be repaired by changing the default-app association. If the URI is broken, qBittorrent cannot add it correctly no matter which browser you use.
12. What To Do When qBittorrent Adds The Magnet But Stays On Downloading Metadata
If qBittorrent adds the magnet but stays on Downloading metadata, the browser and magnet association are working correctly. That is not the same as a magnet link does nothing when clicked.
The remaining issue may involve unavailable peers, DHT, trackers, firewall settings, VPN configuration, proxy settings, or general network connectivity. Troubleshoot that separately as a connectivity or peer-discovery problem, not as a browser protocol-handler problem.
13. Frequently Asked Questions
13.1 Why Does Nothing Happen When I Click A Magnet Link?
Usually the browser is not allowed to open an external application, or the operating system does not know which app should handle the magnet: protocol.
13.2 How Do I Make qBittorrent The Default App For Magnet Links?
On Windows, set qBittorrent as the default app for the MAGNET protocol in Default apps. On Linux, set qBittorrent as the handler for x-scheme-handler/magnet. On macOS, reinstall qBittorrent if needed and choose it when prompted.
13.3 Why Does Another Torrent Client Open Instead Of qBittorrent?
Another client has likely taken over the magnet association. Reset the protocol handler to qBittorrent and check whether the other client or a browser extension is intercepting links.
13.4 Can I Paste A Magnet Link Directly Into qBittorrent?
Yes. Copy the full magnet URI, open qBittorrent, use the add torrent link or URL option, and paste the link beginning with magnet:?xt=.
13.5 Why Does qBittorrent Open But Remain On Downloading Metadata?
That means the magnet link reached qBittorrent. The issue is likely peer discovery, network connectivity, DHT, trackers, firewall, VPN, or proxy configuration.
13.6 Can Browser Extensions Stop Magnet Links From Opening?
Yes. Extensions that block redirects, scripts, external protocols, or rewrite links can prevent the external-app prompt from appearing.
13.7 Will Reinstalling qBittorrent Delete My Downloaded Files?
Normally, reinstalling qBittorrent does not delete downloaded files. Still, back up important configuration and resume data before major changes, and do not delete those folders unless you want a reset.
14. Conclusion
Use a simple troubleshooting order. First, paste the magnet link manually into qBittorrent. Second, repair the MAGNET protocol association. Third, reset the browser’s external-protocol permission. Fourth, remove conflicts with other torrent clients. Finally, reinstall qBittorrent only when the earlier steps fail.