ChatSecure for Android (previously known as Gibberbot) is a secure messaging app built on open standards like XMPP/Jabber and OTR encryption: https://guardianproject.info/apps/chatsecure
It includes OTR4J: https://github.com/otr4j/otr4j
and BouncyCastle for Java: http://www.bouncycastle.org/java.html
and SQLCipher for Android: https://guardianproject.info/code/sqlcipher/
Original wallpaper generated using Tapet app and Gimp: https://play.google.com/store/apps/details?id=com.sharpregion.tapet
and previously included some CC0 public domain beautiful images: Ry Van https://unsplash.com/ryvanveluwen https://unsplash.com/license
Please report any and all bugs or problems that you find. This is essential for us to be able to improve this software!
https://dev.guardianproject.info/projects/chatsecure/issues
First make sure you have the Android SDK and Eclipse installed. Follow instructions here:
Please help us keep this process easy by letting us know if you have problems. If you have any questions, don't be afraid to email us at support@guardianproject.info or jump into our IRC chatrooms for real-time help at #guardianproject on freenode or OFTC (https://guardianproject.info/contact/chat/).
The source code is all in the main git repos, with sub-projects setup as git submodules:
git clone https://github.com/guardianproject/ChatSecureAndroid.git
cd ChatSecureAndroid
git submodule update --init
We use ant
to make our official releases and automated test builds. If you
are not familiar with Eclipse, then it is easier to start with the ant
build:
export ANDROID_HOME=/path/to/android-sdk
./update-ant-build.sh
ant clean debug
Then the installable APK will be in bin/ChatSecure-debug.apk.
-
Start by adding ChatSecureAndroid to Eclipse by going to File -> New -> Project... -> Android project from existing code.
-
Open the ChatSecureAndroid folder that was just cloned from git.
-
Eclipse will next show a list of subprojects to import, all of the libraries with New Project Name of library must be renamed after the project name, i.e. SlidingMenu, AndroidEmojiInput, ViewPagerIndicator.
-
Click Deselect All. The sample and example projects are not needed, and can cause conflicts.
-
Select ChatSecure again by clicking the top item in the list.
-
Outside of Eclipse, open up the text file project.properties. Then back in Eclipse, for each line that starts with
android.library.reference
, select that path from the list of included sub-projects in Eclipse.
Now you should be ready to build ChatSecure!
mvn test
See robo-tests/README.md for eclipse instructions.
Currently the instrumented target tests (to be run on a device) in the directory tests
are empty.
adb shell setprop log.tag.GB.XmppConnection DEBUG
ant -Dgibberbot.locale=fa release