frostwire-jlibtorrent

A swig Java interface for libtorrent by the makers of FrostWire.

Develop libtorrent based apps with the joy of coding in Java.

Using

Download the latest JAR or get the dependency via Maven:

<dependency>
  <groupId>com.frostwire</groupId>
  <artifactId>jlibtorrent</artifactId>
  <version>1.2.x.x</version>
</dependency>

or Gradle:

compile 'com.frostwire:jlibtorrent:1.2.x.x'

Note that there are multiple version of jlibtorrent for different platforms: jlibtorrent, jlibtorrent-windows, jlibtorrent-linux, jlibtorrent-macosx and jlibtorrent-android-<arch>. These are all different artifacts.

For examples look at https://github.com/frostwire/frostwire-jlibtorrent/tree/master/src/test/java/com/frostwire/jlibtorrent/demo

Architectures supported:

Android (armeabi-v7a, arm64-v8a)
Linux (x86, x86_64, armhf, arm64)
Windows (x86, x86_64)
Mac OS X (x86_64)

Building

You need:

Setup a travis account at http://travis-ci.org and get familiar with the service if necessary.
Open an account with Amazon Web Services (AWS) and get familiar with S3 (for storage) and IAM (for users).
Some familiarity with git commands.

The process is:

Create a user in amazon IAM, let's suppose it is user1. Download credentials for the keys.
Create a bucket in amazon S3, let's suppose it is jlibtorrent1.
Set the permission of the bucket according to your workflow, but at least the user1 should have permission to put/upload to the bucket. See for example this bucket policy:

{
	"Statement": [
		{
			"Effect": "Allow",
			"Principal": {"AWS":"arn:aws:iam::<user1's ARN here>:user/user1"},
			"Action": "s3:PutObject",
			"Resource": "arn:aws:s3:::jlibtorrent1/*"
		},
		{
			"Effect": "Allow",
			"Principal": "*",
			"Action": "s3:GetObject",
			"Resource": "arn:aws:s3:::jlibtorrent1/*"
		}
	]
}

Fork the project in github.
Go to travis an enable the repository.
Go to 'More options' > 'Settings' > 'Environment Variables' and set the S3_ACCESS_KEY, S3_SECRET_KEY, S3_BUCKET variables using the values in the credentials file for the user you created and the bucket name you created.
Clone locally your repo, let's assume to the jlibtorrent folder and checkout the stable branch:

$ git clone <your fork repo url> jlibtorrent
$ cd jlibtorrent
$ git checkout master

Verify in your travis online if the build already started. The build could take about 40 minutes, be patient.
When finished, check your s3 bucket for the binaries.
To trigger a new build, just make a change or merge new changes from the stable branch, commit and push.

NodeJs JLibTorrent Module (alpha)

We have recently added support for a NodeJS binary module so you can now have all the power of libtorrent in Javascript/Node.

Help Wanted: At the moment we can only do simple things, like creating torrents and opening torrents, but nothing related to an actual torrenting session is still available, we need to figure out how to add a thread to process libtorrent alerts and then invoke the necessary callbacks for these alerts.

For now it builds, it can be imported in node and you can do simple things.

MBP:swig aldenml$ node
> var jlib = require("./build/Release/jlibtorrent");
undefined
> var s = new jlib.session()
undefined
> var ti = new jlib.torrent_info("/Users/aldenml/Downloads/Lisa_Richards_Beating_of_the_Sun_FrostWire_MP3_Nov_09_2015.torrent");
undefined
> ti
torrent_info {}
> ti.name()
'Lisa_Richards_Beating_of_the_Sun_FrostWire_MP3_Nov_09_2015'
>

Here is an example of how to create a simple .torrent using the low level libtorrent API already available in Javascript/Node.

If you want to build the NodeJS module, you will need to install node-gyp

npm install -g node-gyp

then from the swig/ folder you can build the NodeJS jlibtorrent module with

node-gyp build

after the build is done, you can test by going to the swig/build/Release folder and issuing:

$ node -e "var jlibtorrent = require('./jlibtorrent'); console.log(jlibtorrent.LIBTORRENT_VERSION);"
1.1.0.0

Contributions are rewarded instantly with our Bitcoin donations fund

License

This software is offered under the MIT License, available here.

Nikitenko/frostwire-jlibtorrent

frostwire-jlibtorrent

Using

Building

NodeJs JLibTorrent Module (alpha)

License