Skip to content

Omakey 1.2.0

Choose a tag to compare

@gladimdim gladimdim released this 08 Oct 10:02
· 12 commits to main since this release

Omakey 1.2.0 for Omarchy and the Steam Deck: the omakeyd service and the bar widget.

Website and live demo: https://gladimdim.github.io/omakey-omarchy-plugin/
Android app: https://github.com/gladimdim/omakey-mobile/releases/tag/v1.2.0 (signed APK, free to redistribute)

Install on Omarchy

Needs Omarchy with the Omarchy shell and Rust (sudo pacman -S rust).

omarchy plugin add https://github.com/gladimdim/omakey-omarchy-plugin --enable
~/.config/omarchy/plugins/gladimdim.omakey/install.sh

Then click the keyboard icon in the bar → Pair a phone, and scan it with the app.

Upgrading from 1.1.0: update the plugin and the widget offers Update the service (it expects omakeyd 1.2.0); it rebuilds and restarts the daemon in a terminal.

Install on a Steam Deck with SteamOS

No Omarchy, sudo or compiler needed. In Desktop Mode, open Konsole and run:

curl -fsSL https://raw.githubusercontent.com/gladimdim/omakey-omarchy-plugin/main/install-steamos.sh | bash

It downloads the static omakeyd attached below, checks its checksum, and installs it in your home folder with a user service, so it runs in Game Mode too and SteamOS updates leave it alone. Pair from Omakey: pair a phone (app menu, and Steam's Non-Steam library). Remove it with ... | bash -s -- --uninstall.

What's new

  • Shared clipboard. New CLIP / CLIP_REPLY packets (docs/PROTOCOL.md): the phone's Copy presses Ctrl+Insert on the desktop and gets the copied text; its Paste sets the desktop clipboard and presses Shift+Insert. Up to 64 KB of text, in 1 KB pieces with resends, and passwords' sensitive hint carried both ways. omakeyd uses wl-copy/wl-paste, or KDE's clipboard over D-Bus where there's no Wayland desktop. It works on a worker thread, so no key waits for it. Servers advertise it in WELCOME; older apps and servers simply don't use it.
  • Steam Deck with SteamOS. install-steamos.sh (rootless, above), and each release now carries a static omakeyd-x86_64-linux-musl, its .sha256 and the service file, built by a GitHub Action. On SteamOS typing, the touchpad, pairing and the Bluetooth fallback work in Game Mode and Desktop Mode; the clipboard in Desktop Mode. install.sh hands over to it on SteamOS.
  • The bar icon is the Android app's icon, in colour; its signal waves light up while a phone is connected.
  • Test vectors include a CLIP and its reply.