If your phone will not connect, find the message you see in QuickText below and follow the steps. Most connection problems are fixed in a minute.
Quickest first step: on the Your phone page, click Check my setup. QuickText tests the whole connection, from your network and firewall to your phone, and tells you exactly what is wrong.
Paired, but not reachable
Paired means your phone and PC know each other. Not reachable means the phone is not answering right now. One of these four steps brings it back in almost every case.
- Open the KDE Connect app on your phone. Android puts background apps to sleep. Opening it once reconnects within a few seconds. This alone fixes most cases.
- Let it run in the background. In your phone settings, exclude KDE Connect from battery optimization (sometimes called battery saver or app sleep).
- Same Wi-Fi on both sides. Phone and PC must be on the same Wi-Fi network. Mobile data does not work, and guest networks often block devices from seeing each other.
- Click Refresh after each step. On the Your phone page, the row turns green when the phone answers. Then click Send a test for the final proof.
Found, but not paired yet
QuickText can see your phone, so both are on the same Wi-Fi with KDE Connect running. It just needs pairing.
- On the Your phone page, click Pair next to your phone.
- Pick up your phone and tap Accept in the KDE Connect app.
- The status changes to Connected. Ready to send. Click Send a test to confirm.
No phone found
QuickText cannot see your phone at all. Usually KDE Connect is not running on the phone, or the two are on different networks.
- Open the KDE Connect app on your phone. If it is not installed yet, get it from the Play Store first, then open it.
- Put both on the same Wi-Fi. Not mobile data, and not a guest network.
- Click Refresh on the Your phone page. Your phone should appear in the list.
Still nothing? Windows Firewall may be blocking QuickText, which is what listens for your phone now. On the Your phone page, run Check my setup: when no phone is found, it offers a firewall button. Make sure QuickText SMS is allowed for private networks (the connection uses ports 1714 to 1764).
The pairing request times out or is refused
While a request is in flight, QuickText shows the code and a countdown, and draws what your phone should be showing. Your phone cancels its own request after about 25 seconds, so the window is short.
- No request appeared on the phone. Open the KDE Connect app on the phone and leave it on screen, then click Pair again. If the phone shows nothing at all, check that its clock is correct: a phone whose time is more than half an hour out cannot pair.
- The codes are different. Do not accept. Something else on your network answered instead of your phone. Close the request on the phone, click Refresh on the Your phone page, and pair again from the row that carries your phone name.
- You tapped Accept but nothing changed. Click Refresh. If the row still offers Pair, the answer did not reach your PC; check that both are on the same wi-fi and try once more.
On the phone, this PC appears as QuickText on followed by your computer name. There is no KDE Connect program to install on your PC, so nothing on this side needs to be started first.
The phone unpaired QuickText
A phone can drop the pairing from its side, for example when KDE Connect is reinstalled or its data is cleared. QuickText then says so on the Your phone page, and nothing can be sent until you pair again.
- Open the KDE Connect app on your phone.
- On the Your phone page, click Pair next to it and tap Accept on the phone.
- Send yourself a test message. After a fresh pairing, Android asks for the SMS permission again, so the test is worth doing.
QuickText is blocked by antivirus or firewall
If QuickText hangs or shows a permission error when it connects, your antivirus or firewall is most likely blocking it.
- Temporarily turn off your antivirus or firewall and try again.
- If that fixes it, add QuickText to your exceptions (whitelist it), then turn your security software back on.
QuickText is safe. Major tools like Windows Defender and Kaspersky show it as clean. More detail here: Antivirus or firewall warning (false positive).
If it was your antivirus, please send me a quick email with the name of the software you use. I will reach out to them to fix the false positive, so you and others will not need to whitelist QuickText in future.
