DHIVA LABS · LEARN

Appearance

Troubleshooting and FAQ ​

Each heading below is a symptom or a question. Find yours, then read the cause and the fix.

Troubleshooting ​

The phone says Connecting over WiFi and never connects ​

  • Different networks. The phone and the computer must be on the same network. Guest networks often keep devices apart; use your main network.
  • A firewall blocks the port. Allow incoming connections to the KeyDeck port, 8737 by default, on the computer. With ufw on Ubuntu: sudo ufw allow 8737/tcp.
  • Old addresses. If the computer joined a new network after the app started, select the refresh button next to Scan with the KeyDeck app and scan again.

The phone says Bad token ​

The QR code is from an earlier run of the desktop app. The token changes each time the desktop app starts. Scan the code that is on screen now instead of using Reconnect.

Bluetooth does not find the phone ​

  • In the desktop app, turn on the switch on the Bluetooth line. The phone only advertises; the desktop does the searching.
  • Check that Bluetooth is on in the computer's settings. If the desktop shows Bluetooth is off, turn it on there.
  • On the phone, allow the Bluetooth permissions KeyDeck asks for.
  • Keep the phone close to the computer while it connects.

I tap a key but nothing happens on the computer ​

  • No keystroke tool. If the desktop app shows Key injection unavailable., install xdotool (X11) or ydotool (Wayland). See Install.
  • ydotool is not running. On Wayland, ydotoold must be running for ydotool to work.
  • Wrong window. Hotkeys and text go to the window in front. Click the window you want first.
  • The key has no action. If the key shows Not set in the desktop grid, program it.

Check the Activity list in the desktop app. If your tap is listed there, the phone is connected and the problem is on the computer side.

A hotkey works in some apps but not others ​

Some programs, especially on Wayland, ignore key presses that come from tools like xdotool. Try ydotool on Wayland, or use a Command key that starts the action another way.

My command does nothing ​

The command runs in the background without a terminal, so you do not see errors. Test it in a terminal first. Use full paths for scripts, such as /home/you/bin/backup.sh, and make sure the script is executable.

Questions ​

Can I switch layouts from the phone? ​

No. The phone shows the layout that is selected in the desktop app. Switch layouts on the desktop.

Can two phones connect at once? ​

The desktop app accepts several connections over Wi-Fi and lists them after Connected:. All of them show the same layout.

Does KeyDeck work over the internet? ​

No. KeyDeck works on your local network, over USB tethering, or over Bluetooth. There is no cloud service.

Is there an iPhone app or a Windows build? ​

The current release has an Android APK and an Ubuntu/Debian .deb only.

Where do I report a problem? ​

Open an issue on the KeyDeck issues page.

Next steps ​