Skip to content

BiglySoftware/BiglyBT-Android

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

BiglyBT-Android

API License

BiglyBT for Android is an ad-free, fully featured open source bittorrent client and remote control optimized for phones, tablets, Chromebooks, and Android TVs.

You can find our app on Google Play. Here's a link that maybe Google Search will like 😉 BiglyBT: Torrent Downloading Client for Android

You can also get it F-Droid:

Get it on F-Droid

This is fork of Vuze Remote for Android, which stopped development in early 2017.

Contributing

Spread the Word

As a user, the most important thing you can do to help us is to spread the word of BiglyBT. BiglyBT is fairly unknown. Mentioning BiglyBT on your favorite tracker site, blog, wiki, facebook, social media sites, and to friends would help us a lot. Don't get discouraged.

Other people will have different client preferences than you, and they will often feel attacked when someone talks about a client that isn't theirs. Try to keep discussions positive and informative! We want to co-exist with all clients, since all clients can help share.

Translations

Our translations for BiglyBT for Android are typically behind compared to BiglyBT core translations. Our Android project only has a couple of dozen languages, compared to the 40+ in BiglyBT core, and most of them are terribly incomplete.

Preferably, we'd love it if your native language wasn't English, however, anyone fluent in another language is very much appreciated.

To join in on the translations, please visit our BiglyBT-Android CrowdIn project. Translations are open to anyone with a CrowdIn account. If you would like to translate into a language that isn't listed, please let us know by creating a GitHub Issue and we will add it!

Code Style

In Android Studio, we use the plugin Eclipse Code Formatter to format the code, with the scheme in app/PreferencesJavaCodeStyleFormatter.xml

Building

Initial Steps

Due to a long git history for the core source (2003->present), ensure you have at least 400MB available.

  1. Import into Android Studio as New Project

  2. (Optional) Choose the correct build variant to compile with using Build->Select Build Variant. The most usable variant is coreFlavorFossFlavorDebug.

Migrating source from pre-1.3.1.0

What's Changed

Prior to 1.3.1.0, BiglyBT Core library was included as a jar, and a shell script was required to grab the plugin .jar files. Starting with 1.3.1.0, core and plugins are included as git submodules.

In the new structure, the Android specific code has moved from BiglyBT\ to the standard app\ folder.

Manual Source Migration Steps

If you pulled prior to 1310, this section is for you.

  1. Updating project from VCS will likely result in the new submodules not being initialized (the directories core, BiglyBT-plugin-*, mldht will be empty). To fix this, run in the Terminal window (with path at the root of the project):

    git submodule update --init

    git should reply with a checkout of 6 submodules

  2. File->Sync Projects with Gradle Files will properly setup the plugin and core module source paths.

  3. You can remove the BiglyBT folder in the project root. After the sync, it will not be marked as a Module by Android Studio, and will contain mostly empty directories, along with plugin jars that are no longer used or referenced.

    Be sure to look at your git local changed first, in case you have files that you still want.

  4. Check Settings->Other Settings->Eclipse Code Formatter, and ensure the config file path is correct. It's been moved from /BiglyBT to /app, but VCS may have prevented it from updating.

  5. Restart Android Studio. If you use the IntelliJ plugin 'Awesome Console', file links may not work until you restart.

Updating Source

No special steps are needed to update the android source. A simple VCS->Update Project... will suffice.

You can occasionaly check for submodule updates with the git submodule update in the Terminal window (Newer Android Studio versions may do this automatically with Update Project...)