libtorrent4j

A swig Java interface for libtorrent.

Features
Support for WebTorrent	https://webtorrent.io
Sequential downloading
Torrents queueing and prioritizing
Torrent content selection and prioritizing
NAT-PMP and UPnP support
Fast resume support
HTTP proxies and basic authentication
IP filter
Torrents over SSL
lt_donthave extension	BEP 54
Magnet URI extension - specify indices to download	BEP 53
BitTorrent Protocol v2	BEP 52
DHT Infohash Indexing	BEP 51
Tracker Protocol Extension: Scrape	BEP 48
Padding files and attributes	BEP 47
Multiple-address operation for the DHT	BEP 45
Storing arbitrary data in the DHT	BEP 44
Read-only DHT Nodes	BEP 43
IPv6 extension for DHT	BEP 32
uTorrent transport protocol (uTP)	BEP 29
Private Torrents	BEP 27
Tracker Returns External IP	BEP 24
Tracker Returns Compact Peer Lists	BEP 23
Extension for Partial Seeds	BEP 21
HTTP/FTP Seeding (GetRight-style)	BEP 19
Superseeding	BEP 16
UDP Tracker Protocol	BEP 15
Local Service Discovery (LSD)	BEP 14
Multitracker Metadata Extension	BEP 12
Peer Exchange (PEX)	BEP 11
Extension Protocol	BEP 10
Magnet links	BEP 9
IPv6 Tracker Extension	BEP 7
Distributed hash table (DHT)	BEP 5

Using

Download the latest JAR or get the dependency via Maven:

<dependency>
  <groupId>org.libtorrent4j</groupId>
  <artifactId>libtorrent4j</artifactId>
  <version>2.x.x</version>
</dependency>

or Gradle:

compile 'org.libtorrent4j:libtorrent4j:2.x.x'

If you use ProGuard to obfuscate/minify make sure to add the following statement

-keep class org.libtorrent4j.swig.libtorrent_jni {*;}

Note that there are multiple versions of libtorrent4j for different platforms:

libtorrent4j
libtorrent4j-android-<arch>
libtorrent4j-macos
libtorrent4j-linux
libtorrent4j-windows

These are all different artifacts, you need to select according to your architecture.

For examples look at demos and tests.

Architectures supported:

• Android (armeabi-v7a, arm64-v8a, x86, x86_64)
• macOS (arm64)
• Linux (x86_64)
• Windows (x86_64)

About stability

This library tracks libtorrent master branch. The branch is very stable, runs a lot of tests, and receives bug fixes quickly.

Android local builds

It's possible to build android binaries locally. The solution is docker based, you need to have Docker installed and running (see https://docs.docker.com/engine/install/).

Go to the folder swig/android-build and perform all the operations inside it.

1 - Build the docker image just one time (takes a long time):

docker build -t lt4j:latest .

2 - Select your architecture and run the build script, for example:

./build-arm.sh

3 - Collect the jars in build/libs at the root of the project. Repeat the step 2) for the desired architectures.

License

Licensed under the terms of the MIT license, available here.