franksoong / BiglyBT

Feature-filled Bittorrent client based on the Azureus open source project

BiglyBT

Source for BiglyBT, a feature filled, open source, ad-free, bittorrent client. BiglyBT is forked from the original project and is being maintained by two of the original developers as well as members of the community. With over 15 years of development, there's a good chance we have the features you are looking for, as well as the decade old bugs you aren't looking for :)

• Official BiglyBT site
• Ways to Contribute
• Translation Information
• Feature Voting Page
• Coding Guidelines
• Beta Program Changelog

Donations

Method	Address
PayPal	BiglyBT's Donation Page
BCH/BTC/BSG/BSV	1BiGLYBT38ttJhvZkjGc5mCw5uKoRHcUmr
DASH	XjDwmSrDPQBaLzCkuRHZaFzHf7mTVxkW9K
DOGE	DMXWdEtPUJc5p2sbHGo77SvqFXKTR8Vff1
ETH/ETC	0x4e609B5EF88C8aA8Ab73945fD1ba68c9E27faC75
LTC	LKGc2utCrGfojpYsX3naT9n1AxjLiZ5MMG
TRX/BTT	TAbsb7pjEEWNpXFvPf49rfVhFSB2e3dAM7
XRP	rPFKfbx2tuzMMaz7Zy99M6CquHKgp9srSb

Setting up Dev Environment

Getting the basics to compile from source is pretty straightforward:

1. Clone the repo into your favorite IDE
2. Mark core/src and uis/src as project roots (source modules)
3. To the uis module, add core/lib/* and one of the swt.jars at /uis/lib/:
   swt-win64.jar on Windows
   swt-cocoa-64.jar on OSX
   swt-linux-64.jar on Linux (GTK)
4. To the core module, add core/lib/*
5. Make uis module depend on core. Core should not depend on uis

IntelliJ IDEA will do all these steps for you with its wizard.

External Annotations

If you wish IntelliJ IDEA to show MessageBundle strings instead of keys, as well as reduce the number of NPE warnings, you can attach the external annotations either by:

• Project Settings->Modules->Paths->External Annotations
• in <module>/<module>.iml add to component:

  <annotation-paths>
    <root url="file://$MODULE_DIR$/../external-annotations" />
  </annotation-paths>
  

External Annotations definitions are a WIP and not complete list of definitions.

Running in Dev Environment

Running is only few more steps:

• Main class is com.biglybt.ui.Main in module uis

• Working Directory should be a new folder, since the app will write things to it. Put the aereg.dll or libOSXAccess.jnilib in there.

  When a normal user is running the app, the working directory is where the jar, executable, and libraries (dll, so, jnilib) are.

• If you want a separate config dir from the default one, use VM Option -Dazureus.config.path=<some config path>

• Run it

Release Installer Notes

We build our installers using Install4j, multi-platform installer builder