signald
Toggle Dark/Light/Auto mode Toggle Dark/Light/Auto mode Toggle Dark/Light/Auto mode Back to homepage

Captchas

Sometimes Signal requires a completion of a captcha to register. When this happens, signald throws a CaptchaRequiredException error. If that error is thrown the user must complete a captcha.

Getting A Token

Consider using an existing captcha helper GUI utility:

Alternatively, follow these steps with your browser:

  1. Navigate to https://signalcaptchas.org/registration/generate.html
  2. Preform whatever action is needed to pass the captcha. You need to be able to load a Google captcha, which may require disabling some content filtering. Try using a private browsing window if you get a blank screen.
  3. You will be given a link to a URL in the form “signalcaptcha://signal-hcaptcha..registration.”. Remove the first sixteen characters (“signalcaptcha://"). The remaining string is your captcha.

Register With A Token

Most users will simply need to provide the captcha token to their client. Client authors should simply include the captcha token in a registration request.

signaldctl account register +12024561414 --captcha signal-hcaptcha.e7502e64-2124-11ee-bdd8-0090f5d7e2dd.registration.dV9mcmOMmhHZ19E_4waszAMc7EmPM7IfGSJc4471E45JLXgr2YjRlp36k7_AU5t8ww1IOrZid8hl9fqMs9FNIWx9IUj-TpmTdGnYTKpHhLKsQ5EjO53DeJcccp3Ay66PsvHWHXdda9rEAD-DDt6WbU7m-Mki_sVBIo3kJiV094fLOALTz7tTccAyGHH-rna9lIqceaxgeuvJhxteT_xdf2OU3df1TIQsUGbComAEYNCoreElcpBIv70BmsfCQiN_uUA76ILbnFJS5Ox_kFjqSscjR9V0VUbKE3SKknCc84NT3bPCYo9zSCUZDZ5VksbcaGxfziUMBnXG3MGUH__zu9hRoyZcf1ZWO-1_T2WnCQSvafKjle3DB08KBk5immiXwcIjkEDqshoJWXHUpHC7PcI0d0Q9hAXffuWvB4K5bfqNlgJIa_IigN_f06362sWyzHBkqcpcvAmJbf8rggKuW3OIQ5fvOIvUZ5NKBgZSj8g46mAoJj3fsLVCRn9vz7zKFZZRLMg8
{
    "type": "register",
    "version": "v1",
    "account": "+12024561414",
    "captcha": "signal-hcaptcha.e7502e64-2124-11ee-bdd8-0090f5d7e2dd.registration.dV9mcmOMmhHZ19E_4waszAMc7EmPM7IfGSJc4471E45JLXgr2YjRlp36k7_AU5t8ww1IOrZid8hl9fqMs9FNIWx9IUj-TpmTdGnYTKpHhLKsQ5EjO53DeJcccp3Ay66PsvHWHXdda9rEAD-DDt6WbU7m-Mki_sVBIo3kJiV094fLOALTz7tTccAyGHH-rna9lIqceaxgeuvJhxteT_xdf2OU3df1TIQsUGbComAEYNCoreElcpBIv70BmsfCQiN_uUA76ILbnFJS5Ox_kFjqSscjR9V0VUbKE3SKknCc84NT3bPCYo9zSCUZDZ5VksbcaGxfziUMBnXG3MGUH__zu9hRoyZcf1ZWO-1_T2WnCQSvafKjle3DB08KBk5immiXwcIjkEDqshoJWXHUpHC7PcI0d0Q9hAXffuWvB4K5bfqNlgJIa_IigN_f06362sWyzHBkqcpcvAmJbf8rggKuW3OIQ5fvOIvUZ5NKBgZSj8g46mAoJj3fsLVCRn9vz7zKFZZRLMg8"
}

If you’re having issues, file an issue