Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at


Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.



If you find a bug or need a feature, please report it to https://bitbucket.org/saibotd/bitbeaker/issues. Please keep in mind that this is free software with very few volunteers working on it in their free time.

In many cases a stacktrace from crash is appreciated. If you can't get it via IDE, you can try aLogcat.


Contribution is very welcome! If you want to add a feature or fix a bug yourself, please fork the repository at https://bitbucket.org/saibotd/bitbeaker, do your changes and send a pull request.

Getting started

First make sure you have set a username in Mercurial. Add something like this to ~/.hgrc (*nix) or %USERPROFILE%\Mercurial.ini (Windows):

username = John Doe <john@example.com>

See also https://bitbucket.org/saibotd/bitbeaker/wiki/OAuth

The rest of this guide assumes you use Eclipse. After you have added Bitbeaker into Eclipse's workspace, you need to download and prepare ActionBarSherlock library project (see option 1. in Usage: Including In Your Project). Check that you have set path of ActionBarSherlock correctly (you should see green check mark) by following this: Referencing a library project. You may need to remove the old reference of ActionBarSherlock first. Since we might have different library path, please do not commit/push your changes of project.properties file to our repository. To prevent accidentally commiting modified path of ActionBarSherlock to repository, add this to your .hg/hgrc configuration file

commit = commit -X project.properties

Note: this may cause problems during merge. If you get errors like this abort: cannot partially commit a merge (do not specify files or patterns) even when you commit your merge with hg commit -m 'merge', disable that alias temporarily. If you have better solution for not committing project.properties accidentally, please answer to question at http://stackoverflow.com/questions/12483244/eclipse-override-library-path-defined-in-project-properties.


Translations are very welcome! Please use http://crowdin.net/project/bitbeaker.

Alternatively send a pull request. Useful resources:


We have IRC channel #bitbeaker on the Freenode IRC network (irc.freenode.net). You may access IRC through web chat if you don't have IRC client installed already.