Omabird
Omabird is a tiny, theme-aware pixel bird game that runs natively inside the Omarchy Quickshell. It uses original artwork and sounds and has no network, account, or telemetry. It uses the Python 3 runtime included with Omarchy to safely load its small state file.
Install
omarchy plugin add https://github.com/doctor/omabird.git --enable
Click the bird in the Omarchy bar, or launch it directly:
omarchy-shell shell summon io.github.doctor.omabird
Controls
Space,Up, or click: flap / startP: pause or resumeM: mute or unmuteR: return to the ready screenEnter: restart after game overEscape: close
The playfield follows the current Omarchy theme. Your best score and mute
preference are stored in ${XDG_STATE_HOME:-~/.local/state}/omabird/state.json.
Update and remove
omarchy plugin update io.github.doctor.omabird
omarchy plugin remove io.github.doctor.omabird
Removing the plugin does not remove its small state file. Delete that file manually if you also want to reset the best score.
Development
node --test
omarchy plugin validate .
Plugins run as unsandboxed code inside the long-lived Omarchy shell. Review the source before enabling third-party plugins. Omabird writes only its state file and invokes no privileged or network commands.
License
MIT © 2026 Doctor