陈斌彬的技术博客

Stay foolish,stay hungry

iOS - ChatSecure

ChatSecure

ChatSecure is a free and open source instant messaging client for iOS and Android that integrates encrypted OTR (“Off the Record”) messaging support from the libotr library and the XMPPFramework to handle Jabber/GTalk (XMPP).

Cost

This project is 100% free because it is important that all people around the world have unrestricted access to privacy tools. However, developing and supporting this project is hard work and costs real money. Please help support the development of this project! We now also accept Bitcoin via Coinbase! :)

Localization

If you would like to contribute/improve a translation:

  1. Visit our Transifex project page and make an account if you don’t have one already.
  2. Go to the resources subsites AppStore.strings & Localizable.strings to add a new language or improve an existing translation.
  3. Open an issue on Github notifying us of your translation.

Compatibility

There’s a more full list of OTR clients on Wikipedia.

Desktop

Mobile

Build Instructions

You’ll need Cocoapods for most of our dependencies.

$ gem install cocoapods

Download the source code and don’t forget to pull down all of the submodules as well.

$ git clone https://github.com/ChatSecure/ChatSecure-iOS.git
$ cd ChatSecure-iOS/
$ git submodule update --init --recursive

img

Now you’ll need to build the dependencies. During this process we will automatically verify the integity of each package by checking its GPG signature. Install GPGTools and add the public signing keys for OpenSSL, GnuPG, libevent, and libotr. (TODO make these links to the keys)

$ bash ./Submodules/CPAProxy/scripts/build-all.sh
$ bash ./Submodules/OTRKit/scripts/build-all.sh
$ pod install

img img

Next you’ll need to create your own version of environment-specific data. Make a copy of OTRSecrets-Template.m as OTRSecrets.m:

$ cp ChatSecure/Classes/Utilities/OTRSecrets-Template.m ChatSecure/Classes/Utilities/OTRSecrets.m
$ cp ./configurations/OTR_Codesigning.xcconfig.sample ./configurations/OTR_Codesigning.xcconfig

Then set your own value for PROVISIONING_PROFILE_Debug in OTR_Codesigning.xcconfig to your iOS team provisioning profile identifier to run it on your device. You can get this identifier by temporarily selecting the desired profile in Xcode (Build Settings -> Provisiong Profile), then selecting “Other…”.

Open ChatSecure.xcworkspace in Xcode and build.

Note: Don’t open the .xcodeproj because we use Cocoapods now!

If you’re still having trouble compiling check out the Travis-CI build status and .travis.yml file.

Contributing

Thank you for your interest in contributing to ChatSecure! To avoid potential legal headaches and to allow distribution on Apple’s App Store please sign our CLA (Contributors License Agreement). For contributing translations, please check out our Transifex page.

  1. Sign the CLA (odt, pdf) and email it to chris@chatsecure.org.
  2. Fork the project and (preferably) work in a feature branch.
  3. Open a pull request on GitHub.
  4. Thank you!

License

Software License Agreement (GPLv3+)

Copyright (c) 2015, Chris Ballinger. All rights reserved.

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <http://www.gnu.org/licenses/>.

If you would like to relicense this code to distribute it on the App Store, please contact me at chris@chatsecure.org.

Third-party Libraries

This software additionally references or incorporates the following sources of intellectual property, the license terms for which are set forth in the sources themselves:

The following dependencies are bundled with the ChatSecure, but are under terms of a separate license:

For a more complete list, check the Podfile.

Acknowledgements

Thank you to everyone who helped this project become a reality! This project is also supported by the fine folks from The Guardian Project and OpenITP.