Skip to content

aldenml/libtorrent4j

Repository files navigation

libtorrent4j

macOS Linux Windows Android Codacy Badge Maven Central

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.