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 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, 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 <>

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 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

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 accidentally, please answer to question at


Translations are very welcome! See official guide for creating alternative resources. You may find command line tool Android Localization Helper useful when searching missing or obsolete Strings.