PLEASE REPORT ALL ISSUES ON OUR PROJECT HERE:
Java Other
Latest commit 30f54a4 Feb 3, 2016 @n8fr8 n8fr8 update changelog
Failed to load latest commit information.
.settings The big reformat! Jun 2, 2012
.tx don't pull arrays from tx anymore, as we don't need it Jul 8, 2015
META-INF full update Jan 5, 2011
assets remove default emoji (will offer as plugin) Nov 24, 2013
doc Reorg data request/response, keep track of requests Jun 28, 2013
external fixes #677 on github: update asmack to address "sessionSupported" bug May 27, 2015
gitian Update NOTES.md Sep 27, 2014
libs fixes #677 on github: update asmack to address "sessionSupported" bug May 27, 2015
otr-sample Update .classpath Sep 27, 2014
res Added missing translation strings Jan 25, 2016
robo-tests Update README.md Sep 27, 2014
src fixes #728 and #718 by disabling unsupport cipher suites Feb 3, 2016
tests test whether pinned domains are working properly with the pins Dec 14, 2014
.classpath Eclipse ADT insists on reordering elements in these .classpath files Oct 20, 2014
.gitignore port basic tests from robo-tests/ to an Android Test Project Dec 5, 2014
.gitmodules purge IOCipher submodule, the v0.2 release jar is used Oct 20, 2014
.project the project has been renamed Jun 24, 2013
AndroidManifest.xml 14.2.3 Feb 3, 2016
CHANGELOG update changelog Feb 3, 2016
LICENSE Edited LICENSE via GitHub May 19, 2011
README.md update README Dec 15, 2014
XMPPClient.iml full update Jan 5, 2011
XMPPClient.ipr full update Jan 5, 2011
XMPPClient.iws full update Jan 5, 2011
add-proguard-release.xml updates to project files Feb 6, 2013
build.xml change build name to ChatSecure Jan 5, 2014
custom_rules.xml make-release-build: use version from `git describe` in original name … May 27, 2015
fix-translations OtrFileConverter is called KeySync! Jan 20, 2016
logo512.png add new base art images May 22, 2015
make-release-build make-release-build: disable faketime since it is problematic Jul 16, 2015
offline.png add new base art images May 22, 2015
pom.xml Adjust pom.xml version of asmack to the one actually included in the Jan 5, 2015
project.properties update to target android-21 to support Material Nov 10, 2014
update-ant-build.bat updating windows bat Nov 14, 2014
update-ant-build.sh add target Jan 20, 2015

README.md

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

Bug reports

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

Build Instructions

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/).

Get the source

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

ant setup

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.

Eclipse setup

  1. Start by adding ChatSecureAndroid to Eclipse by going to File -> New -> Project... -> Android project from existing code.

  2. Open the ChatSecureAndroid folder that was just cloned from git.

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

  4. Click Deselect All. The sample and example projects are not needed, and can cause conflicts.

  5. Select ChatSecure again by clicking the top item in the list.

  6. 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!

Test Instructions

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.

Logging

adb shell setprop log.tag.GB.XmppConnection DEBUG

Building for a Locale

ant -Dgibberbot.locale=fa release