Updated HowToUbuntu (markdown)

mh-g 2017-02-25 11:49:26 +01:00
parent 254ba46272
commit 253a669eda

@ -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]]
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.`