From 253a669edae6155553f7e542554f0dca815fb2f3 Mon Sep 17 00:00:00 2001 From: mh-g Date: Sat, 25 Feb 2017 11:49:26 +0100 Subject: [PATCH] Updated HowToUbuntu (markdown) --- HowToUbuntu.md | 37 ++++++++++++++++++++++++++++++++++++- 1 file changed, 36 insertions(+), 1 deletion(-) diff --git a/HowToUbuntu.md b/HowToUbuntu.md index 2bbc2be..a5735e1 100644 --- a/HowToUbuntu.md +++ b/HowToUbuntu.md @@ -8,5 +8,40 @@ While the experienced developer will most likely delve into the source code and * Java Runtime Environment configured with unlimited strength crypto (follow download links on [[StackOverflow|http://stackoverflow.com/a/6481658]] ## Installation +Unpack a release from [[https://github.com/AsamK/signal-cli/releases]], e.g. to `~/signal-cli`. -Unpack a release from [[https://github.com/AsamK/signal-cli/releases]] \ No newline at end of file +Open a command line and change to the subdirectory `bin` where the release has been unpacked into: +`cd ~/signal-cli/bin` + +## Set up an account + +Note: In Signal/signal-cli the account is called "username", which is slightly misleading, since it is a phone number including the country code. The used phone number is required for one-time verification of the installation. In this example I will use two German cell phone numbers, thus they will start with +491515... + +1. Register your phone number +Enter `./signal-cli -u +4915151111111 register` on the command line. If all goes well, there is no reply. Execution takes a few seconds. ++491515111111 is thus the phone number that will be used by the signal-cli installation. + +After a few seconds, you will receive an SMS on the cell phone with phone number +4915151111111 that contains the verification code (123-456 in this example): +> Your TextSecure verification code: 123-456 +> 25 Feb. 2017 10:52 + +2. Verify your phone number +Enter `./signal-cli -u +4915151111111 verify 123-456` on the command line. Again, no reply if all is fine. + +## Send a first message from the command line +We assume that the receiver of the message has the phone number +4915152222222. Enter `./signal-cli -u +4915151111111 send -m "My first message from the CLI" +4915152222222` on the command line. Again, no reply if all is fine. + +Within a few seconds, the Signal App on the cell phone +4915152222222 will receive the message. + +## Send a first reply to the command line +With the same setup, enter a message (e.g. "First reply to the CLI") on the cell phone +4915152222222. + +Enter `./signal-cli -u +4915151111111 receive`. This gets more output after a few seconds: +`Envelope from: +4915152222222 (device: 1)` +`Timestamp: 1488016532387 (2017-02-25T09:55:32.387Z)` +`Message timestamp: 1488016532387 (2017-02-25T09:55:32.387Z)` +`Body: First reply to the CLI` + +`Envelope from: +4915152222222 (device: 1)` +`Timestamp: 1488017026720 (2017-02-25T10:03:46.720Z)` +`Got receipt.`