Omahub
← All plugins
A

Unified Launcher

by alivault

Fast unified launcher for commands, apps, keybindings, clipboard, emoji, and reminders

GitHub

Security review

No obvious issues detected

Deterministic scan — not a security guarantee

None
Risk level
None
Analyzed commit
167d407
Scanned
2 weeks ago

No potentially dangerous behavior detected in the analyzed commit.

Automated analysis only — not a security guarantee.

AI advisory review

No obvious issues detected

Language-model assessment · ~deepseek/deepseek-v4-flash-latest — advisory only

None
AI risk level
None
Recommendation
install
Model
~deepseek/deepseek-v4-flash-latest
Analyzed commit
167d407
Reviewed
2 weeks ago

Manual review of the manifest, README, and sampled QML/JS/shell sources found no obfuscated code, hidden persistence, destructive install behavior, or data exfiltration. The plugin's command execution and clipboard/reminder handling are user-initiated and match the documented launcher functionality. The deterministic scan's 'none' rating is consistent with this review.

How this check works

This review combines the deterministic scan (the rule-based results above) with an independent look at the plugin's code by a language model. The model reads a trimmed sample of the repository's files, the manifest, and the README, then gives a plain-language risk level and a recommendation: install (no notable danger), review (look closer first), or avoid (clearly dangerous).

It runs on the same analyzed commit as the deterministic scan and is strictly advisory — it is not a security guarantee and never blocks a plugin by itself. A human moderator still reviews plugins before they are listed.

AI advisory only — automated analysis, not a security guarantee.

Install
$ omarchy plugin add https://github.com/alivault/omarchy-unified-launcher --enable
Productivity #Hyprland #quickshell #launcher

Unified Launcher for Omarchy

A fast, preloaded command palette for Omarchy Quattro. Unified Launcher brings apps, Omarchy actions, live Hyprland keybindings, clipboard history, emoji, and reminders into one searchable menu while leaving specialized fullscreen surfaces—such as Omarchy's image picker—as standalone overlays.

Unified Launcher

Features

  • Search and launch desktop applications and Omarchy actions.
  • Browse and execute live Hyprland keybindings with their shortcuts visible.
  • Native clipboard history with text, file, and image previews.
  • Native emoji grid backed by Omarchy's emoji catalog and insertion helper.
  • Set and manage Omarchy reminders without replacing their systemd backend.
  • Keyboard, mouse, arrow, Page Up/Down, Home/End, and Ctrl+J/K navigation.
  • Preserved submenu search, selection, and scroll state.
  • Preloaded inside the existing omarchy-shell process.

Clipboard contents, clipboard images, and reminder runtime state remain under Omarchy's normal runtime directories. Unified Launcher does not copy them into the plugin directory.

Requirements

  • Omarchy Quattro with the current Quickshell plugin system.
  • The standard Omarchy clipboard, emoji, reminder, menu, and Hyprland tools.

No extra daemon is installed and the plugin never starts a second Quickshell process.

Install

Review the repository first: Omarchy plugins execute unsandboxed with your user permissions. Then install and enable it:

omarchy plugin add https://github.com/alivault/omarchy-unified-launcher.git --enable

Unified Launcher intentionally declares that it replaces omarchy.menu while enabled. This preserves existing omarchy-menu commands and Omarchy's menu shortcuts. Removing the plugin restores the built-in menu.

Recommended shortcut

Add this user-owned override to ~/.config/hypr/bindings.lua:

hl.unbind("SUPER + SPACE")
o.bind(
  "SUPER + SPACE",
  "Unified Launcher",
  hl.dsp.global("io.github.alivault.omarchy-unified-launcher:toggle")
)

Reload and check Hyprland after editing:

hyprctl reload
hyprctl configerrors

The plugin also supplies a bar widget. Omarchy places it in the left section by default when there is no built-in menu widget to replace.

Usage

Open the root or a native subview through Omarchy's normal menu interface:

omarchy menu toggle root
omarchy menu summon clipboard
omarchy menu summon emoji
omarchy menu summon reminder-set
omarchy menu summon reminders

Useful keys:

Key Action
Enter / Right Open or execute
Left / Backspace Return to the previous view
Arrow keys Navigate
Ctrl+J / Ctrl+K Next / previous
Page Up / Page Down Move by page
Home / End First / last
Delete Delete the selected clipboard entry or reminder
Shift+Delete Clear clipboard history or all reminders, with confirmation
Escape Clear search, go back, or close

The fullscreen Theme and Background image pickers remain their own Omarchy overlays by design.

User menu overrides

Unified Launcher layers its additions between Omarchy's default menu and your existing user extension:

Omarchy defaults → plugin menu.jsonc → ~/.config/omarchy/extensions/omarchy-menu.jsonc

Reuse an item ID in your extension to change its label, icon, action, provider, position, or aliases.

Update and remove

omarchy plugin update io.github.alivault.omarchy-unified-launcher
omarchy plugin remove io.github.alivault.omarchy-unified-launcher

Development

omarchy plugin validate .
qmllint -I "$OMARCHY_PATH/shell" \
  Menu.qml BarWidget.qml ClipboardSubview.qml EmojiSubview.qml ReminderSubview.qml

When testing a changed checkout, restart the shell if QML's component cache does not pick up a hot reload:

omarchy restart shell

License

MIT. See LICENSE and NOTICE. Unified Launcher is based on Omarchy's MIT-licensed first-party menu and helper modules.