FrostWire for Android

A file sharing client, media player and simple file manager for your Android devices.

FrostWire for Android will let you search and download files from the BitTorrent network and several popular cloud services and it will let you share files with other FrostWire for Android devices on the same local network (via WiFi)

The local sharing happens through a simple JSON/HTTP protocol (still to be documented, you can look at how it works on the code for now, very very simple)

Coding guidelines

Keep it simple.
Do not repeat yourself. Re-use your own code and our code. It'll be faster to code, and easier to maintain.
If you want to help, Issue tracker is a good place to take a look at.
Try to follow our coding style and formatting before submitting a patch.
All pull requests should come from a feature branch created on your git fork. We'll review your code and will only merge it to the master branch if it doesn't break the build. If you can include tests for your pull request you get extra bonus points ;)
When you submit a pull request try to explain what issue you're fixing in detail and how you're fixing in detail it so it's easier for us to read your patches. If it's too hard to explain what you're doing, you're probably making things more complex than they already are. Look and test your code well before submitting patches.
We prefer well named methods and code re-usability than a lot of comments. Code should be self-explanatory.

Becoming a core collaborator with direct commit access to the upstream repository will only happen after we have received lots of great patches and we get to know you better.

Submitting Pull Requests

Fork the project.
No matter how small your change will be, create a feature branch for it.
Make sure the name of your feature branch describes what you're trying to fix. If you don't know what to name it and there's an issue created for it, name your branch issue-233 (where 233 would be the number of the issue you're fixing).
If your branch has taken a while to be accepted for merging into master, it's very likely that the master branch will have moved forward while you work. In this case, make sure to sync your master.

git checkout master
git pull upstream master

and then rebase your branch to bring it up to speed so it can be merged properly:

git checkout my-branch
git rebase master

as you do this you may have to fix any possible conflicts, just follow the instruction git gives you if this is your first time.

Make sure to squash any cosmetic commits into the body of your work so that we don't pollude the history and you don't get more bitcoins than you should from the rest of the collaborators for things like fixing a typo you just introduced on your branch.

Tip for commit

You can donate for development, thereby encouraging some developers or you can participate and get a tip for commits approved us.

Build instructions

Android Studio

Make shure you have Android Studio properly installed.
Open the project in android studio.
Wait for gradle sync and indices to update.
Should work out of the box.

Happy coding.

Download

Latest binaries | Previous versions (SourceForge)

Downloading FrostWire does not constitute permission or a license for obtaining or distributing unauthorized files. It is illegal for you to distribute copyrighted files without permission.

If you want to know about legal content you can download and distribute legally please visit FrostClick, VODO, ClearBits.net and Creative Commons

License

See here for the license. Frostwire for Android is offered under the GNU General Public License.

sssemil / frostwire-android