Skip to content

Instantly share code, notes, and snippets.

@szepeviktor
Last active April 23, 2026 15:15
Show Gist options
  • Select an option

  • Save szepeviktor/2c6a19cb91c4bb561369707f22bcf413 to your computer and use it in GitHub Desktop.

Select an option

Save szepeviktor/2c6a19cb91c4bb561369707f22bcf413 to your computer and use it in GitHub Desktop.
Install Signal without a smartphone

Signal on Windows without a smartphone

Requirements

Installation

Install the Signal desktop app.

Install Java either offline or online.

Download precompiled signal-cli binaries: signal-cli-*.tar.gz and extract its contents to a new directory, e.g. C:\usr\signal

Phone number registration

Replace ALL-CAPITALS with your actual values.

  • bin\signal-cli.bat -u +COUNTRY-CODE-YOUR-PHONE-NUMBER register
  • Receive the verification code in SMS
  • bin\signal-cli.bat -u +COUNTRY-CODE-YOUR-PHONE-NUMBER verify VERIFICATION-CODE-RECEIVED-IN-SMS
  • Open Signal Desktop app
  • Make a cropped screenshot of the QR code
  • Decode the QR code with ZXing Decoder Online
  • bin\signal-cli.bat -u +COUNTRY-CODE-YOUR-PHONE-NUMBER addDevice --uri "tsdevice:/QR-CODE-PARSED-RESULT"
  • bin\signal-cli.bat -u +COUNTRY-CODE-YOUR-PHONE-NUMBER listDevices

Documentation: https://github.com/AsamK/signal-cli/blob/master/man/signal-cli.1.adoc

Usage

Start using Signal without a smartphone :)

Find user data to backup in %USERPROFILE%\.local\share\signal-cli\

Supported locales are stored in %LOCALAPPDATA%\Programs\signal-desktop\locales

Change locale on the command line: Signal.exe --lang=en-US

@szepeviktor

Copy link
Copy Markdown
Author

This is a gist. It has no "GitHub Issues". Please understand.

@FSNE

FSNE commented May 1, 2023

Copy link
Copy Markdown

Thank you for these instructions, very helpful. I ran Signal without smartphone/mobile number for a few years but I haven't managed to make it run again on a newly installed machine. I first had trouble getting the captcha right and tried quite a few times. Now I finally managed, I keep receiving "Failed to register: [429] Rate limit exceeded: 429". I waited a few hours, but no change. Anything I can do or should I just wait longer?

@szepeviktor

szepeviktor commented May 1, 2023

Copy link
Copy Markdown
Author

I know no more about it than you. I am sorry.

@FSNE

FSNE commented May 4, 2023

Copy link
Copy Markdown

OK after a few hours of cycling between "invalid captcha", endless 502 and 429 messages, I bought a sim card and registered to the new mobile number without any problem; it seems the landline option does not work anymore for me. Of course it means my old account is now floating and cannot be removed, which is not great. I tried with
bin/signal-cli -u +322xxxxxxxx unregister --delete-account
... but signal-cli responds that the user is not registered.
Any idea how to remove/unregister without access to the device which which I registered (the laptop was stolen)?

@szepeviktor

szepeviktor commented May 4, 2023

Copy link
Copy Markdown
Author

Please ask your question on a bigger forum.
Signal's forum, or signal-cli's issue.
I do not register numbers and do not use Signal.

Good luck!

@xixianykus

Copy link
Copy Markdown

A simple way to install Java is using the Winget the Windows package manager. From a command line just type:

winget install oracle.JDK.22

Unfortunately I got as far as decoding the QR code but then the next command just hung and nothing happened despite waiting some 5 minutes or so.

@Celine311

Celine311 commented Mar 21, 2025

Copy link
Copy Markdown

Hi,
Thank you for the instructions!
I have a problem entering the qrcode result.
The following message appears:

Invalid device link
pub_key' is not recognized as an internal or external command
or external command, an executable program or a command file.
capabilities' is not recognized as an internal or external command
or external command, an executable program or a command file.

(The words "pub_key=" and "capabilities=" appear in the qr code device link I received)

Can you help me please ? Thanks a lot

@Celine311

Copy link
Copy Markdown

Invalid device link pub_key' is not recognized as an internal or external command or external command, an executable program or a command file. capabilities' is not recognized as an internal or external command or external command, an executable program or a command file.

Hi there!
I solved my problem, I note here the solution if it can help someone: the problem came from the fact that I was using Windows Powershell.
I performed the same operations but with Cmd instead of Powershell, and it worked!

@BR-blu02

BR-blu02 commented Jun 23, 2025

Copy link
Copy Markdown

ZXing Decoder Online is currently not available. What worked for me was: https://qrcoderaptor.com/

Maybe of help for Signal Desktop users on Linux:
Furthermore, in the signal-cli command above (the one with addDevice), the URI has a different pattern for me. The link in the decoded QR code does not start with tsdevice:/... but sgnl://linkdevice?uuid=.... When I use this link for the --uri parameter, I was able to add the device.

@joshbuker

Copy link
Copy Markdown

@Celine311 that fix helped, thank you! After switching to CMD instead of Powershell, it worked immediately.

@Ladjez

Ladjez commented Apr 4, 2026

Copy link
Copy Markdown

Hi everyone, and ty szepeviktor for this useful client !

I download the latest version of the client, because Signal wasn't working anymore with the one I used, and now the registration process seems to be quite different.

Following the first step, my terminal ask what's on the screenshot :

Captcha Signal

I tried different things, but I don't really know where I've to paste the link I get after solving the captcha. Before getting the verification code by SMS, I guess. If anybody have any clue about this, I'd like to hear it !

Cheers

@Jasper3232

Jasper3232 commented Apr 15, 2026

Copy link
Copy Markdown

@Ladjez it has to be appended to the first command so for example: bin\signal-cli.bat -u +COUNTRY-CODE-YOUR-PHONE-NUMBER register --captcha YOUR-LINK

The command where you have to use the qr code is also no longer correct(bin\signal-cli.bat -u +COUNTRY-CODE-YOUR-PHONE-NUMBER addDevice --uri "tsdevice:/QR-CODE-PARSED-RESULT"). I got a uri starting with "sgnl://linkdevice?..." from the qr code. Using bin\signal-cli.bat -u +COUNTRY-CODE-YOUR-PHONE-NUMBER addDevice --uri "QR-CODE-PARSED-RESULT" was successful.

The tool i used to decrypt the qr code did not encode the url properly. I hade to use https://www.urldecoder.org/ to convert it to utf-8. If your url contains "%2B" , "%3D" or something similar you might need to use a tool like this. It seems like the uri is only valid for a few minutes.

Can confirm this method did work today to register an account and use signal desktop on windows. Maybe @szepeviktor can update the instructions.

@Ladjez

Ladjez commented Apr 16, 2026

Copy link
Copy Markdown

Hi @Jasper3232 and thanks a lot for your help, it worked !

I tried using the command --uri "tsdevice:/QR-CODE-PARSED-RESULT" and ZXing Decoder Online, and it worked for me. Even if the uri started with sgnl://linkdevice...

Thanks again for the captcha verification process, and hope those comments will help many users ;)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment