Skip to content

johang/vlc-bittorrent

Folders and files

NameName
Last commit message
Last commit date

Latest commit

4827cc7 · Oct 5, 2024
Aug 20, 2024
Mar 18, 2024
Dec 16, 2018
Oct 5, 2024
Dec 13, 2021
Dec 21, 2020
Jun 17, 2018
Oct 5, 2024
Oct 5, 2024
Dec 8, 2016
May 21, 2020
Jan 6, 2024
Aug 20, 2024

Repository files navigation

vlc-bittorrent (Bittorrent plugin for VLC)

What is this?

With vlc-bittorrent, you can open a .torrent file or magnet link with VLC and stream any media that it contains.

Example usage

$ vlc video.torrent
$ vlc http://example.com/video.torrent
$ vlc https://example.com/video.torrent
$ vlc ftp://example.com/video.torrent
$ vlc "magnet:?xt=urn:btih:...&dn=...&tr=..."
$ vlc "magnet://?xt=urn:btih:...&dn=...&tr=..."

Installing on Debian/Ubuntu

$ sudo apt-get install vlc-plugin-bittorrent

Installing on Fedora

$ sudo dnf install vlc-bittorrent

FAQ

Does it upload/share/seed while playing?

Yes. It works as a regular Bittorrent client. It will upload as long as it's playing.

Does it work on Ubuntu/Debian?

Yes!

Does it work on Windows, Mac OS X, Android, Windows RT, iOS, my toaster?

Probably. I have not tested. It should run since libtorrent works on most systems and the plugin is just standard C and C++. Patches are welcome.

Dependencies (on Linux)

  • libtorrent ("libtorrent-rasterbar2.0" in Ubuntu 22.04)

Building from git on a recent Debian/Ubuntu

$ sudo apt-get install autoconf autoconf-archive automake libtool make libvlc-dev libvlccore-dev libtorrent-rasterbar-dev g++
$ git clone https://github.com/johang/vlc-bittorrent.git vlc-bittorrent
$ cd vlc-bittorrent
$ autoreconf -i
$ ./configure --prefix=/tmp/vlc
$ make
$ make install

Then, to load it in VLC player:

$ VLC_PLUGIN_PATH=/tmp/vlc/lib vlc --no-plugins-cache video.torrent