Can You Stream a Torrent in VLC? What Actually Works

Which route suits you depends mostly on your operating system and on whether you want to skip around in the video. Here is the quick version:

Route	Works on	Skip ahead?	Effort
vlc-bittorrent plugin	Linux (packaged); others untested	Yes, fetches the spot VLC reads	Install one package
Client in sequential mode + VLC	Any	Only within what has downloaded	Two apps, a few settings
webtorrent-cli `--vlc`	Any with Node.js	Yes, pieces fetched on demand	Command line
A torrent streaming player instead of VLC	Depends on the app	Depends on the app	One app

All of them work with legal content you can try right now. The examples use Sintel, Blender's 2010 open movie, licensed under Creative Commons Attribution. WebTorrent's free torrents page lists its magnet link, which starts with magnet:?xt=urn:btih:08ada5a7a6183aae1e09d831df6748d566095a10, and its .torrent file. The video is a 129 MB MP4, so it makes a quick test.

What VLC supports today

VLC is very good at playing things from the network, but BitTorrent is not one of them.

VLC 3.0.24, released in September 2026, is the current version for Windows, macOS, and Linux. Its release notes cover codecs, demuxers, and network protocols such as SRT, RIST, and SFTP. There is nothing about BitTorrent.
VLC 4.0 is still in development. The change list in VLC's source tree for 4.0 does not mention BitTorrent either.
VideoLAN's features page lists the network inputs VLC supports: UDP and RTP, HTTP and FTP, MMS, TCP and DCCP. No BitTorrent, no magnet links.
VLC's source code agrees. Its network input modules include HTTP, FTP, SMB, NFS, SFTP, SRT, and RIST, among many others, in both the 3.0 branch and the main development branch. None of them speaks BitTorrent.

So if you paste a magnet link into Media → Open Network Stream, VLC has nothing that understands it. The same goes for opening a .torrent file: to VLC it is just a small file it cannot play.

The plugins and tools below fill that gap. None of them comes from VideoLAN.

Route 1: the vlc-bittorrent plugin

vlc-bittorrent is a third-party plugin that teaches VLC to open .torrent files and magnet links. Under the hood it uses libtorrent, the same engine that powers qBittorrent. It is free software under the GPL 3.0 and still maintained: version 2.17 was tagged in August 2026, and it needs VLC 3.0 or newer and libtorrent 2.0 or newer.

Installing it

On Linux it is a normal package:

Debian and Ubuntu: sudo apt-get install vlc-plugin-bittorrent
Fedora: sudo dnf install vlc-bittorrent

Debian ships it from Debian 10 onwards, with recent releases carrying versions 2.14 to 2.16.

On Windows and macOS there is no ready-made download from the project. The README's answer to "Does it work on Windows, Mac OS X…?" is: "Probably. I have not tested." In 2026 the project added a Windows build to its automated tests, which is a good sign, but for now you would have to build it yourself.

Using it

Open the torrent the way you would open any media in VLC, or from a terminal:

vlc sintel.torrent
vlc "magnet:?xt=urn:btih:08ada5a7a6183aae1e09d831df6748d566095a10&dn=Sintel"

For a magnet link, the plugin first fetches the torrent's metadata from peers, then starts playing.

How well it handles skipping

Better than a sequential download, because the plugin knows where VLC is reading. Its source shows three priority levels: the range VLC is asking for right now gets the highest priority, a small slice at the very start and end of the file comes next (where indexes usually live), and then the next stretch of the file after the read position. When you jump ahead, the spot you jumped to becomes the top priority.

The plugin sets these priorities and leaves the downloading to libtorrent, so how quickly playback resumes after a jump depends largely on the swarm.

It also seeds. The README says it "works as a regular Bittorrent client. It will upload as long as it's playing." That is good for the swarm, and it means your IP address is visible to other peers just as with any client.

Route 2: a client with sequential download, plus VLC

This is the route that works everywhere, with software you may already have. The client downloads the file from start to finish in order, and VLC plays the part that has arrived. How to stream a torrent without downloading it first has the full click-by-click steps; here is the short version for qBittorrent:

Add the Sintel magnet link (File → Add Torrent Link…).
In the add-torrent window, tick Download in sequential order and Download first and last pieces first. For a torrent already in the list, right-click it and tick both there.
Let it reach a few percent.
In VLC, choose Media → Open File and pick the video in qBittorrent's download folder.

Why "first and last pieces first" matters for VLC

Many video files keep their index, the table that maps playback time to positions in the file, at the end. MP4 files made without the "fast start" option do this, and so do MKV files written by FFmpeg. Without the index, VLC may refuse to open the file or be unable to seek. "First and last pieces first" fetches both ends of each file before the middle, so VLC can read the index straight away. Sequential download explained covers what the two options do in detail and why you should switch them off when you are done.

Two VLC settings worth knowing

Incomplete file names. If qBittorrent's Append .!qB extension to incomplete files option is on, the video keeps that extra extension until it finishes. Turn the option off for torrents you want to watch early, so the file shows up as a video when you look for it in VLC.
Damaged or incomplete AVI file. For AVI files, VLC has a setting under Tools → Preferences → Input / Codecs with four choices: Ask for action, Always fix, Never fix, and Fix when necessary. "Fixing" means VLC rebuilds the file's index while it plays. On a half-downloaded AVI, it can only index what has arrived.

Why seeking ahead stalls

Say you are 10 minutes into Sintel and jump to minute 12. Often the picture freezes, glitches, or VLC jumps somewhere else. The reason is that the two programs do not talk to each other:

The client does not know where VLC is reading. Sequential mode is just a sort order. When you jump, qBittorrent keeps downloading from where it was, so the part you want arrives only when the download reaches it.
VLC reads whatever is on disk. The file on disk has gaps where pieces have not arrived yet. VLC has no way to ask for those bytes; it can only wait, skip, or give up.

So with this route, watch from the start and let the download stay ahead of you. If you need to jump around, use one of the other routes.

Other clients

Transmission added optional sequential downloading in version 4.1, and other clients have similar options. The idea is the same: download in order, open the file in VLC.

Route 3: stream to VLC over a local web address

The third route uses a tool that does two jobs at once: it downloads the torrent and runs a small web server on your own computer, which VLC plays like any online video. Because VLC requests specific byte ranges from that server, the tool knows exactly which part VLC wants, so seeking works.

webtorrent-cli

webtorrent-cli is the command-line version of WebTorrent. It is MIT-licensed, requires Node.js 20 or newer, and was last released as version 6.0.1 in August 2026. Despite the name, it connects to ordinary BitTorrent peers, finding them through trackers, the DHT, and peer exchange.

Install Node.js, then run npm install webtorrent-cli -g.
Run webtorrent "magnet:?xt=urn:btih:08ada5a7a6183aae1e09d831df6748d566095a10" --vlc.
If the torrent has several files, add --select to list them, then run the command again with the file's number after --select.

webtorrent-cli starts its web server on http://localhost:8000 (change the port with -p) and opens VLC pointing at the file. Its README says it "fetches pieces from the network on-demand so seeking is supported (even before torrent is finished)" and switches between sequential and rarest-first piece selection. If VLC is already open, you can also paste the address the tool prints into Media → Open Network Stream.

The older peerflix tool works the same way and also has a --vlc option, but its last release dates from 2018.

What about qBittorrent?

qBittorrent does not stream torrents over HTTP. A pull request that would have added it was opened as a draft in 2020 and closed without being merged in 2021. qBittorrent 5.3.0, released in October 2026, lets the web interface download completed files, which is useful for remote access but does not help with a file that is still downloading.

Or skip VLC: a torrent streaming player

The routes above all bolt BitTorrent onto VLC. The other approach is a player that has the torrent engine built in, so the engine always knows which byte the player needs next.

TorrentPlayer, the free and open-source player we make, is one. It requests the piece at the playhead first, then the file's index, then a read-ahead window sized from the video's bitrate. When you skip, it cancels requests that no longer matter, sends the new position to the fastest peers, and asks a second peer for the most urgent blocks so one slow peer cannot stall playback. In its own benchmark on a public swarm (an Ubuntu ISO with about 600 peers, capped at 10 MiB/s), a skip took a median of 0.70 seconds. Public swarms vary.

It is honest to say where VLC is the better choice:

Codecs. TorrentPlayer plays video through the system's web engine, and that engine cannot decode some audio codecs, such as AC-3 and DTS, which are common in films. Those files play without sound. VLC's features page lists AC-3, E-AC-3, DTS, and TrueHD among the formats it decodes, so VLC plays more files today. A built-in libmpv player is planned but not there yet.
Maturity. TorrentPlayer is an early preview, and its installers are not code-signed yet, so Windows SmartScreen and macOS Gatekeeper will warn you.
Magnet links stream through TorrentPlayer's own engine since version 0.2.0, like .torrent files (an embedded librqbit only fetches their metadata). In 0.1.0 they went through librqbit, which was slower in the same benchmark (2.7 seconds per skip).

Where it is the better choice: starting in seconds and skipping freely, without setting up two programs or a command line, on Windows, macOS, or Linux. For more options, see the best torrent streaming apps.

Which route to pick

You are on Linux and want VLC: install vlc-bittorrent. It is the closest thing to VLC supporting torrents.
You already use qBittorrent and watch from the start: sequential download plus first and last pieces, then open the file in VLC.
You want to skip around in VLC on Windows or macOS: webtorrent-cli with --vlc.
You want the least setup, and your files use common audio formats: a torrent streaming player.
The file has Dolby or DTS audio: use VLC, by one of the first three routes.

A word on what you stream

Every route here is still torrenting. While you watch, your client or plugin uploads pieces to other peers, and your IP address is visible to the swarm. With open movies like Sintel, public-domain films, and Linux ISOs, that is fine. With copyrighted films or shows shared without permission it usually is not, and streaming instead of downloading does not change that. Is torrenting legal? covers the general principles; it is not legal advice.

Sources

Checked on 20 October 2026.