Whisperfish is a native Signal client for Sailfish OS. Whisperfish uses the Signal client library for Go and Qt binding for Go. The user interface is heavily based on the jolla-messages application written by Jolla Ltd.

Whisperfish should be considered alpha software and used at your own risk. The client is not an official Signal client and is not affiliated with Open Whisper Systems. The code has not been audited by an expert in computer security or cryptography. The goal of Whisperfish is to eventually become a stable, secure, and robust Signal client for Sailfish OS. Code review and contributions are welcome!

• [x] Registration
• [x] Contact Discovery
• [x] Direct messages
• [x] Group messages
• [x] Storing conversations
• [x] Photo attachments
• [x] Encrypted identity and session store
• [x] Encrypted message store
• [x] Advanced user settings
• [ ] Multi-Device support (links with Signal Desktop)
• [ ] Encrypted attachments
• [ ] Archiving conversations

Whisperfish connects to Signal using Websockets. For a better user experience try adjusting the power settings on your Jolla to disable late suspend [1]. This should keep the network interfaces up and allow Whisperfish to maintain websocket connections even when the device is in "sleep". This could potentially impact your battery life depending on your usage. Otherwise every time your device goes into deep sleep, the Websocket connection is broken and you may not receive messages until the next time the OS wakes up and Whisperfish reconnects.

To disable late suspend and enable "early suspend" run:

$ mcetool --set-suspend-policy=early

See here for more information.

1. https://together.jolla.com/question/55056/dynamic-pm-in-jolla/
2. https://talk.maemo.org/showpost.php?p=1401956&postcount=29
3. https://sailfishos.org/wiki/Sailfish_OS_Cheat_Sheet#Blocking_Device_Suspend

These instructions assume you're running Linux

1. Install Go >= 1.7.1 and setup a proper GOPATH somewhere in your home directory, for example GOROOT=$HOME/projects/goroot/go and GOPATH=$HOME/projects/go.

2. Install Glide

3. Install Qt 5.7.0 the official prebuilt package

4. Install Sailfish OS SDK

5. Clone whisperfish and download dependencies:

   $ git clone https://github.com/aebruno/whisperfish.git
   $ cd whisperfish
   $ glide install
   

6. Download and install Go QT bindings. This will clone https://github.com/therecipe/qt and checkout the specific version that has been known to work with whisperfish:

   $ ./build.sh bootstrap-qt
   

7. Run qtmoc and qtminimal (this is run on your local machine not the mersdk):

   $ ./build.sh prep
   

8. Create i386 Go binary for use in Sailfish SDK. Note this only needs to be done once:

   $ ./build.sh setup-mer
   

9. Login to mersdk and setup environment. Installing Go in your home directory will provide mersdk access to the Go binaries for compiling whisperfish. Note only needs to be done once:

   $ ssh -p 2222 -i ~/SailfishOS/vmshare/ssh/private_keys/engine/mersdk mersdk@localhost
   $ vim ~/.bashrc
   [add these lines to .bashrc]
   export GOROOT=/home/src1/projects/goroot/go
   export GOPATH=/home/src1/projects/go
   export PATH=$GOROOT/bin/linux_386:$PATH
   
   $ source ~/.bashrc
   

10. Login to mersdk, compile whisperfish, and deploy to emulator:

    $ ssh -p 2222 -i ~/SailfishOS/vmshare/ssh/private_keys/engine/mersdk mersdk@localhost
    $ cd $GOPATH/src/github.com/aebruno/whisperfish
    $ ./build.sh compile
    $ ./build.sh i18n
    $ ./build.sh deploy
    

Whisperfish supports i18n translations and uses Text ID Based Translations. See here for more info. To translate the application strings in your language run (for example German):

$ ssh -p 2222 -i ~/SailfishOS/vmshare/ssh/private_keys/engine/mersdk mersdk@localhost
$ cd $GOPATH/src/github.com/aebruno/whisperfish
$ sb2 lupdate qml/ -ts qml/i18n/whisperfish_de.ts
[edit whisperfish_de.ts]
$ sb2 lrelease -idbased qml/i18n/whisperfish_de.ts -qm qml/i18n/whisperfish_de.qm

Currently translations are only accepted through github pull requests.

Note: The latest tag from the current git branch is used in the package version (mb2 -x). To add git hashes to the package version modify the /usr/bin/mb2 script with the following patch:

--- mb2.orig    2016-05-19 02:44:04.015412275 +0000
+++ /usr/bin/mb2        2016-05-19 02:44:13.722084593 +0000
@@ -154,7 +154,7 @@
 fix_package_version() {
     [[ ! $OPT_FIX_VERSION ]] && return

-    local tag=$(git describe --tags --abbrev=0 2>/dev/null)
+    local tag=$(git describe --long --tags --dirty --always 2>/dev/null)
     if [[ -n $tag ]]; then
         # tagver piece copied from tar_git service
         if [[ $(echo $tag | grep "/") ]] ; then

Copyright (C) 2016-2017 Andrew E. Bruno

Whisperfish 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 <https://www.gnu.org/licenses/>.