Skip to content

bjarneo/omarchy-shell-plugins

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

20 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Omarchy Shell Plugins

Personal third-party plugins for omarchy-shell.

Quick Start

Local install from this checkout:

mkdir -p ~/.config/omarchy/plugins
rm -rf ~/.config/omarchy/plugins/omni
cp -a omni ~/.config/omarchy/plugins/omni
omarchy plugin validate ~/.config/omarchy/plugins/omni
omarchy plugin rescan
omarchy plugin enable omni
omarchy-restart-shell

Open Omni:

omarchy-shell shell toggle omni '{}'

Suggested Alt+Space binding for ~/.config/hypr/bindings.lua:

hl.unbind("ALT + SPACE")
hl.bind("ALT + SPACE", hl.dsp.exec_cmd([[omarchy-shell shell toggle omni '{}']]), { description = "Omni" })

If this repository is added as a trusted plugin source, install with:

omarchy plugin source add https://github.com/bjarneo/omarchy-shell-plugins --as bjarneo
omarchy plugin add omni --from bjarneo --enable

Omarchy rejects symlinked plugin folders. Use real copied directories for local testing.

Projects

omni

Standalone Omarchy shell command palette for apps, Omarchy actions, files, themes, GitHub search, tldr, and local Ollama prompts.

Features:

  • Overlay plugin enabled with omarchy plugin enable omni
  • Searches installed desktop apps and a bundled Omarchy action index
  • Drill-down categories for Quick, Apps, Files, GitHub, Favourites, History, and Themes
  • File previews, theme swatches, GitHub repo/PR previews, tldr docs, and local Ollama prompt previews
  • Uses Omarchy shell shared colors, font settings, and state fills through qs.Commons
  • Keyboard controls: arrows or j/k to move, Enter to launch, Esc to unwind/close, Ctrl+S to favourite

Useful commands:

omarchy-shell shell toggle omni '{}'
omarchy-shell shell call omni toggle ""
omarchy-shell shell call omni openCategory Quick
omarchy-shell shell hide omni

Optional tools:

  • fd for file search
  • gh for GitHub search
  • tldr for inline command docs
  • ollama with qwen3.5:0.8b for local chat and command generation

See omni/README.md for details.

quickapps-hud

Fast Iron Man-style quick-app launcher overlay for omarchy-shell.

Features:

  • Animated hex app ring with a center arc-reactor readout
  • Scanline sweep, HUD corner brackets, target beam, and launch charge flash
  • Uses Omarchy shell shared colors through qs.Commons
  • Unloads when hidden and only animates while open
  • Reads apps from ~/.config/omarchy-quickapps-hud/apps.json, with fallback to older quickapps config files

Install from this checkout:

mkdir -p ~/.config/omarchy/plugins
rm -rf ~/.config/omarchy/plugins/quickapps-hud
cp -a quickapps-hud ~/.config/omarchy/plugins/quickapps-hud
omarchy plugin validate ~/.config/omarchy/plugins/quickapps-hud
omarchy plugin enable quickapps-hud
omarchy-restart-shell

Launch it:

omarchy-shell shell toggle quickapps-hud '{}'

Override the HUD apps by creating ~/.config/omarchy-quickapps-hud/apps.json, then refresh the open overlay:

omarchy-shell shell call quickapps-hud refresh ""

See quickapps-hud/README.md for details.

cliamp

Top-right now-playing card for cliamp, loaded inside omarchy-shell.

Features:

  • Appears when cliamp starts or changes songs, then hides itself after a few seconds
  • Title and artist display with a themed visualizer
  • Winamp-style spectrum visualizer powered by cliamp visstream
  • Uses Omarchy shell shared colors and fonts through qs.Commons

Install from this checkout:

mkdir -p ~/.config/omarchy/plugins
rm -rf ~/.config/omarchy/plugins/cliamp
cp -a cliamp ~/.config/omarchy/plugins/cliamp
omarchy plugin validate ~/.config/omarchy/plugins/cliamp
omarchy plugin enable cliamp
omarchy-restart-shell

See cliamp/README.md for details.

Validate

omarchy plugin validate omni
omarchy plugin validate quickapps-hud
omarchy plugin validate cliamp
qmllint omni/*.qml omni/components/*.qml
qmllint quickapps-hud/*.qml
qmllint cliamp/*.qml

License

MIT. See LICENSE.

About

Personal Omarchy shell plugins, including the Omni command palette.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors