A soundboard for Omarchy, a Linux alternative to Soundpad. Press a key, and a sound plays into your microphone: whoever is on the other end of the call, stream or game hears it along with your voice.
It is an Omarchy shell plugin, not a separate app. The board is a keyboard-first overlay drawn with the shell's own components, so it follows whatever theme you use, and it costs nothing while you are not using it: no daemon, no web view, no audio processing running in the background.
- Plays into your mic, the way Soundux does: each sound goes straight into the apps recording a microphone (Discord, the browser, games), mixed with your voice. No virtual device, no setup, nothing changes in your audio settings. Prefer a device? Switch to a virtual "Omahorn Microphone" instead.
- You hear it too, on your own output and at your own volume.
- Global hotkeys for any sound, bound through Hyprland, plus one to open the board and one to stop everything.
- Folders are the library. Point it at folders of audio files; subfolders become tabs. Coming from Soundux? Your tabs and favorites are imported on first run.
- Waveforms on every pad, filling in as the sound plays.
- Plays wav, flac, ogg, opus, mp3 and aiff directly; m4a, aac, webm, wma and friends are converted once with ffmpeg and cached.
Everything here ships with Omarchy 4; there is nothing to install.
- Omarchy 4, whose shell (
omarchy-shell, Quickshell 0.3) hosts the plugin - PipeWire with WirePlumber and pipewire-pulse:
pw-play,pw-link,pw-dumpandpactl - Hyprland, for the global hotkeys
bash,jq,findand the usual coreutilsffmpegandffprobe, for sound lengths, waveforms and playing m4a, aac, webm or wma. Without them sounds still play, just without those.
omarchy plugin add https://github.com/allankayan/omahorn.git --enableOr from a local checkout:
ln -s ~/path/to/omahorn ~/.config/omarchy/plugins/io.github.allankayan.omahorn
omarchy-shell shell rescanPlugins
omarchy plugin enable io.github.allankayan.omahorn --before omarchy.audioA bullhorn appears in the bar. Put sounds in ~/Music/Soundboard (created on
first run) and press Super+Ctrl+M.
Type to search; the board narrows as you type, accents and case ignored.
| Key | Does |
|---|---|
| Enter | Play the selected sound (and close the board) |
| Shift+Enter | Play and keep the board open |
| Ctrl+Enter | Preview: play only for you, not into the mic |
| Alt+1…9 | Play the first nine sounds shown |
| Arrows, PgUp/PgDn, Home/End | Move around the pads |
| Tab / Shift+Tab | Next / previous tab |
| Ctrl+F | Favorite (favorites lead the list and get their own tab) |
| Ctrl+K | Set a global hotkey for the sound |
| Ctrl+←/→ | Make this sound quieter / louder |
| Ctrl+S | Stop everything |
| Ctrl+O | Open the sound's folder |
| Ctrl+R | Rescan the folders |
| Ctrl+, | Settings |
| Esc | Clear the search, then close |
With the mouse: click a pad to play it, right-click to preview, middle-click (or the star) to favorite, click the hotkey chip to set one.
The bar button opens the board, right-click stops all sounds, middle-click toggles hearing them yourself. While something plays, the icon turns into an equalizer.
Ctrl+K on a pad, then press the combination. Use Super, Ctrl or Alt with any key, or F13 and up on their own, which is what macro keys on most keyboards send. Keys Hyprland already uses are refused, with what uses them; a key another sound uses moves to this one. Backspace removes the hotkey.
Hotkeys follow the physical key, so they keep working when you switch layouts.
Omahorn registers them as Hyprland global shortcuts and keeps the binds in
~/.local/state/omarchy/toggles/hypr/omahorn.lua, a folder Omarchy loads on
every Hyprland reload. Your own config files are never touched.
| Default | Does |
|---|---|
| Super+Ctrl+M | Open / close the board |
| Super+Ctrl+Shift+M | Stop all sounds |
Both can be changed or cleared in settings.
The shell exposes Omahorn over IPC:
omarchy-shell omahorn play "airhorn" # best match by name, or an exact path
omarchy-shell omahorn preview "airhorn" # only for you
omarchy-shell omahorn random Memes # a random sound, optionally from one tab
omarchy-shell omahorn stop
omarchy-shell omahorn toggle
omarchy-shell omahorn status # JSON: mic, who is listening, what playsTo reach the board from the Omarchy menu as well, add a row to
~/.config/omarchy/extensions/omarchy-menu.jsonc:
Into apps (the default). When you play a sound, Omahorn looks for the streams recording a microphone right now and links the sound into each of them; PipeWire mixes it with the microphone they already hear. The player is created unlinked, which holds it at its first sample until the links exist, so nothing is cut off. Your devices, defaults and voice path stay exactly as they were.
your mic ─────────────────────────────┐
├──► Discord, browser, game (each app recording a mic)
pw-play sound ──(linked per app)──────┘
pw-play sound ──────────────────────────► your headphones
Every app recording a microphone gets your sounds unless you switch it off in settings, where apps show up as they start recording. The catch: an app has to be recording when the sound starts. Apps that only open the microphone while you hold push-to-talk need you to hold it.
Virtual mic (optional). A single module-remap-source in pipewire-pulse
creates "Omahorn Microphone", which passes your real microphone through, and
sounds are played into it. Apps that pick that device always hear sounds,
push-to-talk or not. Use as default microphone in settings (off unless you
turn it on) makes it the system default input, so apps on the default input
hear them too. The passthrough follows your default input, and Omahorn never
fights you over which device is the default. Switching back to Into apps removes the device as soon as no app
is using it, so a call in progress carries on.
Either way each sound is a short-lived pw-play per destination, and nothing
runs between sounds.
Privacy. Process arguments are visible to every user on the machine, so
Omahorn keeps your sounds out of them: the helpers in bin/ take paths and
names on stdin, pw-play, ffmpeg and ffprobe read each sound on their
stdin, and Hyprland loads the hotkeys from their file by path. The one path
that does show is a folder you open with Ctrl+O, which your
file manager is started with. Omahorn's own
folders (~/.config/omahorn, ~/.cache/omahorn, ~/.local/state/omahorn)
and the hotkeys file are readable only by you. Notifications, whose text also
passes through arguments, never name a sound.
Ctrl+, in the board covers everything: how sounds reach
people and which apps get them, the volume of sounds for them and for you,
overlap, hotkeys and folders. Changes save as you go to
~/.config/omahorn/config.json, which you can also edit by hand; the shell
picks edits up live.
{
"version": 1,
"folders": [
{ "path": "~/Music/Soundboard", "recursive": true },
{ "path": "~/Downloads/audios", "name": "Memes" }
],
"routing": "inject",
"exclude": ["obs"],
"mic": "auto",
"defaultMic": false,
"monitor": true,
"micVolume": 80,
"monitorVolume": 60,
"overlap": false,
"closeOnPlay": true,
"sounds": {
"/home/you/Music/Soundboard/airhorn.mp3": {
"favorite": true,
"volume": 120,
"hotkey": { "keys": "SUPER + ALT + code:38", "label": "Super+Alt+A" }
}
}
}| Key | |
|---|---|
folders |
Where sounds come from. recursive folders turn their subfolders into tabs; name renames the tab |
routing |
inject: straight into apps recording a microphone. vmic: through the Omahorn Microphone device |
exclude |
Apps (name or binary) that never get sounds injected |
mic |
Virtual mic: auto follows your default input; or a source name from pactl list short sources |
defaultMic |
Virtual mic: make Omahorn Microphone the system default input (off by default) |
monitor |
Hear sounds yourself |
micVolume, monitorVolume |
0–150%: what others hear, what you hear |
overlap |
Let sounds play over each other instead of replacing the one playing |
closeOnPlay |
Enter closes the board |
sounds |
Per-sound favorite, volume and hotkey, keyed by full path |
The file must stay valid JSON. If it stops parsing, Omahorn keeps running on the last good settings (defaults, if it started that way) and writes nothing to the file until it parses again.
People hear me but not the sounds. In Discord, turn off Noise Suppression (Krisp): it is built to remove anything that is not a voice, sounds included. Then check the header of the board: Live · Discord means the app is getting them. If it says No app listening, the app is not recording right now (push-to-talk released, call not joined) or is switched off in settings. With the virtual mic, set the app's input to Default or Omahorn Microphone.
They hear the sounds twice, or with an echo. You are probably on speakers, and your microphone picks up the copy you hear. Use headphones, or turn off Hear sounds yourself.
"Mic offline" in the board (virtual mic only). Check the module and the shell's log:
pactl list short modules | grep omahorn_mic
qs log -p "$OMARCHY_PATH/shell" | grep omahornA hotkey does nothing. hyprctl globalshortcuts should list
omahorn:play-… for it, and omarchy menu keybindings --print the bind.
omarchy plugin update io.github.allankayan.omahorn
omarchy restart shellThe shell keeps a plugin's service loaded across plugin reloads, so a new version of Omahorn only takes over after the shell restarts.
omarchy plugin remove io.github.allankayan.omahornThis removes the hotkeys and, if you used it, the virtual microphone, restoring
your default input. That cleanup runs in the shell, so remove the plugin while
omarchy-shell is running; if it was not, delete
~/.local/state/omarchy/toggles/hypr/omahorn.lua yourself.
Settings stay in ~/.config/omahorn; delete that folder, ~/.cache/omahorn
and ~/.local/state/omahorn to remove everything. Your sound folders stay as
they are, including ~/Music/Soundboard, which Omahorn created on first run.
dev/run # run Omahorn in its own Quickshell instance
dev/run ipc toggle # open the board there
dev/run key ctrl+k # simulate a key press on the board
dev/run log # follow its log
dev/run stop
node --test tests/ # unit tests for the logic in lib/The dev instance opens the board on the monitor you are not using and without
taking the keyboard, and leaves hotkeys off, so it never fights an installed
Omahorn. OMAHORN_DEV_FOCUS=1 and OMAHORN_DEV_HOTKEYS=1 turn those back on.
The pieces:
Service.qml |
Library, playback, virtual microphone, hotkeys, IPC |
Board.qml |
The overlay |
BarWidget.qml |
The bar button |
components/ |
Pads, waveform, settings page, hotkey recorder |
lib/ |
Pure logic: search, config, hotkey parsing (tested with node) |
bin/omahorn-play |
Plays one copy of a sound, for you or into the virtual microphone |
bin/omahorn-inject |
Finds the apps recording a microphone and plays into them |
bin/omahorn-audio |
Creates and manages the virtual microphone |
bin/omahorn-scan |
Lists the sound folders, with cached durations |
bin/omahorn-peaks |
Computes and caches waveforms |
bin/omahorn-decode |
Converts formats pw-play cannot read |
bin/omahorn-binds |
Writes the hotkeys file and has Hyprland load it |
MIT


