Skip to content

Latest commit

 

History

History
40 lines (25 loc) · 1.8 KB

CONTRIBUTING.md

File metadata and controls

40 lines (25 loc) · 1.8 KB

Contributing

Building

Requirements

  1. Windows 10 v1703 build 15063 (Creators Update) or greater
  2. Visual Studio 2017 15.4 RC or greater

Steps

  1. Clone/fork the repository
  2. Open the Signal-Windows.sln in Visual Studio
  3. Build the solution
  4. Deploy to your target device

Testing Changes on Signal

Signal-Windows is able to exchange messages with every other signal device. You may also send messages to yourself, they will be sent to all sibling devices. Use any signal client you like, and setup your deployed Signal-Windows instance:

Using Signal-Windows as a master device

Note: Signal-Windows master devices cannot yet link slaves. You can register Signal-Windows as a master on any supported W10 device using a virtual (e.g. Google Voice), mobile or landline phone number.

Using Signal-Windows as a slave device

You can link Signal-Windows as a slave to any signal device capable of linking slaves.

Using a Signal-Android or Signal-iOS master

Same procedure as with Signal-Desktop: Scan the qr-code.

Using a signal-cli master

Signal-Windows kindly also displays the tsdevice string below the qrcode. Use signal-cli addDevice --uri like you would with a Signal-Desktop slave.

Backing Up the Database

Beware: Only backup Libsignal.db if you know what you are doing. The Signal Protocol is stateful, so replacing the database with an older version will most likely corrupt existing sessions with your contacts.

If you want to backup your database files, Libsignal.db and Signal.db, you can find them in C:\Users\<USERNAME>\AppData\Local\Packages\2383BenediktRadtke.SignalPrivateMessenger_teak1p7hcx9ga\LocalCache\

On mobile these are found at LocalAppData\2383BenediktRadtke.SignalPrivateMessenger_<VERSION>_arm__teak1p7hcx9ga\LocalCache\