session-android/README.md

# Session Android

[Download on the Google Play Store](https://getsession.org/android)

Add the [F-Droid repo](https://fdroid.getsession.org/)

[Grab the APK here](https://github.com/loki-project/session-android/releases/latest)

## Summary

Session integrates directly with [Oxen Service Nodes](https://docs.oxen.io/about-the-oxen-blockchain/oxen-service-nodes), which are a set of distributed, decentralized and Sybil resistant nodes. Service Nodes act as servers which store messages offline, and a set of nodes which allow for onion routing functionality obfuscating users' IP addresses. For a full understanding of how Session works, read the [Session Whitepaper](https://getsession.org/whitepaper).

![AndroidSession](https://i.imgur.com/0YC9TyI.png)

## Want to contribute? Found a bug or have a feature request?

Please search for any [existing issues](https://github.com/oxen-io/session-android/issues) that describe your bugs in order to avoid duplicate submissions. Submissions can be made by making a pull request to our `dev` branch. If you don't know where to start contributing, try reading the Github issues page for ideas.

## Build instructions

Build instructions can be found in [BUILDING.md](BUILDING.md).

## Verifing signatures

Get Kee's key and import it:

```
wget https://raw.githubusercontent.com/oxen-io/oxen-core/master/utils/gpg_keys/KeeJef.asc
gpg --import KeeJef.asc
```

Get the signed hash for this release, the SESSION_VERSION needs to be updated for the release you want to verify

```
export SESSION_VERSION=1.10.4
wget https://github.com/oxen-io/session-android/releases/download/$SESSION_VERSION/signatures.asc
```

Verify the signature of the hashes of the files

```
gpg --verify signatures.asc 2>&1 |grep "Good signature from"
```

The command above should print "`Good signature from "Kee Jefferys...`"
If it does, the hashes are valid but we still have to make the sure the signed hashes matches the downloaded files.

Make sure the two commands below returns the same hash.
If they do, files are valid.

```
sha256sum session-$SESSION_VERSION-universal.apk
grep universal.apk signatures.asc
```

## License

Copyright 2011 Whisper Systems

Copyright 2013-2017 Open Whisper Systems

Copyright 2019-2020 The Loki Project

Licensed under the GPLv3: http://www.gnu.org/licenses/gpl-3.0.html
Update README.md 2020-02-13 03:32:43 +00:00			`# Session Android`
Initial Project Import 2011-12-20 18:20:44 +00:00
Update README.md 2020-02-17 05:57:03 +00:00			`[Download on the Google Play Store](https://getsession.org/android)`
Add bithub payout slug. 2013-12-16 17:58:56 +00:00
refactor: replace fdroid deep-link with the fdroid session landing page 2021-04-09 05:44:39 +00:00			`Add the [F-Droid repo](https://fdroid.getsession.org/)`
feat: update the repo documentation readme and building file 2021-04-09 03:43:47 +00:00
Update README.md 2020-02-13 03:32:43 +00:00			`[Grab the APK here](https://github.com/loki-project/session-android/releases/latest)`
Add bithub payout slug. 2013-12-16 17:58:56 +00:00
Update README.md 2020-02-13 03:32:43 +00:00			`## Summary`
Initial Project Import 2011-12-20 18:20:44 +00:00
feat: update the repo documentation readme and building file 2021-04-09 03:43:47 +00:00			`Session integrates directly with [Oxen Service Nodes](https://docs.oxen.io/about-the-oxen-blockchain/oxen-service-nodes), which are a set of distributed, decentralized and Sybil resistant nodes. Service Nodes act as servers which store messages offline, and a set of nodes which allow for onion routing functionality obfuscating users' IP addresses. For a full understanding of how Session works, read the [Session Whitepaper](https://getsession.org/whitepaper).`
Initial Project Import 2011-12-20 18:20:44 +00:00
Update README.md 2020-02-13 03:32:43 +00:00			`![AndroidSession](https://i.imgur.com/0YC9TyI.png)`
Initial Project Import 2011-12-20 18:20:44 +00:00
Update README.md 2020-06-03 00:33:38 +00:00			`## Want to contribute? Found a bug or have a feature request?`
Initial Project Import 2011-12-20 18:20:44 +00:00
feat: update the repo documentation readme and building file 2021-04-09 03:43:47 +00:00			Please search for any [existing issues](https://github.com/oxen-io/session-android/issues) that describe your bugs in order to avoid duplicate submissions. Submissions can be made by making a pull request to our `dev` branch. If you don't know where to start contributing, try reading the Github issues page for ideas.
Update README to reflect Play Store location. 2013-02-07 20:05:36 +00:00
Update README.md 2020-06-03 00:33:38 +00:00			`## Build instructions`
Update README to reflect Play Store location. 2013-02-07 20:05:36 +00:00
Update README.md 2020-02-13 03:32:43 +00:00			`Build instructions can be found in [BUILDING.md](BUILDING.md).`
Initial Project Import 2011-12-20 18:20:44 +00:00
add verify sha instructions in README 2021-05-24 00:11:01 +00:00			`## Verifing signatures`

			`Get Kee's key and import it:`

			```
			`wget https://raw.githubusercontent.com/oxen-io/oxen-core/master/utils/gpg_keys/KeeJef.asc`
			`gpg --import KeeJef.asc`
			```

			`Get the signed hash for this release, the SESSION_VERSION needs to be updated for the release you want to verify`

			```
			`export SESSION_VERSION=1.10.4`
			`wget https://github.com/oxen-io/session-android/releases/download/$SESSION_VERSION/signatures.asc`
			```

			`Verify the signature of the hashes of the files`

			```
			`gpg --verify signatures.asc 2>&1 \|grep "Good signature from"`
			```

			The command above should print "`Good signature from "Kee Jefferys...`"
			`If it does, the hashes are valid but we still have to make the sure the signed hashes matches the downloaded files.`

			`Make sure the two commands below returns the same hash.`
			`If they do, files are valid.`

			```
			`sha256sum session-$SESSION_VERSION-universal.apk`
			`grep universal.apk signatures.asc`
			```

reorganize readme // FREEBIE 2014-04-25 22:52:03 +00:00			`## License`
Initial Project Import 2011-12-20 18:20:44 +00:00
			`Copyright 2011 Whisper Systems`
reorganize readme // FREEBIE 2014-04-25 22:52:03 +00:00
Update copyright date Closes #6678 // FREEBIE 2017-05-25 18:34:24 +00:00			`Copyright 2013-2017 Open Whisper Systems`
Initial Project Import 2011-12-20 18:20:44 +00:00
Update README.md 2020-02-13 03:32:43 +00:00			`Copyright 2019-2020 The Loki Project`
larger google play badge Closes #6701 //FREEBIE 2017-06-03 10:57:57 +00:00
Update README.md 2020-02-13 03:32:43 +00:00			`Licensed under the GPLv3: http://www.gnu.org/licenses/gpl-3.0.html`