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

## Verifying signatures

**Step 1:**

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

**Step 2:**

Get the signed hash for this release. `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
```

**Step 3:**

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.

**Step 4:**

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-2021 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
Update README 2021-05-24 03:04:43 +00:00			`## Verifying signatures`
add verify sha instructions in README 2021-05-24 00:11:01 +00:00
Update README 2021-05-24 03:04:43 +00:00			`Step 1:`
add verify sha instructions in README 2021-05-24 00:11:01 +00:00
			```
			`wget https://raw.githubusercontent.com/oxen-io/oxen-core/master/utils/gpg_keys/KeeJef.asc`
			`gpg --import KeeJef.asc`
			```

Update README 2021-05-24 03:04:43 +00:00			`Step 2:`

			Get the signed hash for this release. `SESSION_VERSION` needs to be updated for the release you want to verify.
add verify sha instructions in README 2021-05-24 00:11:01 +00:00
			```
			`export SESSION_VERSION=1.10.4`
			`wget https://github.com/oxen-io/session-android/releases/download/$SESSION_VERSION/signatures.asc`
			```

Update README 2021-05-24 03:04:43 +00:00			`Step 3:`

			`Verify the signature of the hashes of the files.`
add verify sha instructions in README 2021-05-24 00:11:01 +00:00
			```
			`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.`

Update README 2021-05-24 03:04:43 +00:00			`Step 4:`

add verify sha instructions in README 2021-05-24 00:11:01 +00:00			`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 2021-05-24 03:04:43 +00:00			`Copyright 2019-2021 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`