https://github.com/johang/vlc-bittorrent

A bittorrent plugin for VLC.
https://github.com/johang/vlc-bittorrent

bittorrent debian libtorrent libvlc plugin stream streaming torrent ubuntu videolan vlc vlc-bittorrent

Last synced: 2 days ago
JSON representation

A bittorrent plugin for VLC.

• Host: GitHub
• URL: https://github.com/johang/vlc-bittorrent
• Owner: johang
• License: gpl-3.0
• Created: 2016-12-08T18:50:01.000Z (about 8 years ago)
• Default Branch: master
• Last Pushed: 2024-10-05T20:36:11.000Z (4 months ago)
• Last Synced: 2025-02-01T23:04:07.845Z (10 days ago)
• Topics: bittorrent, debian, libtorrent, libvlc, plugin, stream, streaming, torrent, ubuntu, videolan, vlc, vlc-bittorrent
• Language: C++
• Homepage:
• Size: 986 KB
• Stars: 414
• Watchers: 16
• Forks: 50
• Open Issues: 8
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-vlc - vlc-bittorrent - A bittorrent plugin for VLC. (VLC native plugins)
• awesome-repositories - johang/vlc-bittorrent - A bittorrent plugin for VLC. (C++)

README

        
# 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