Omahub
← All plugins
A

Overview

by AyushKr2003

Hyprland workspace overview with live window previews.

GitHub

Security review

No obvious issues detected

Deterministic scan — not a security guarantee

None
Risk level
None
Analyzed commit
b09c227
Scanned
1 month 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
b09c227
Reviewed
1 month ago

The plugin is a workspace overview UI for Hyprland/Quickshell. It only reads system state via standard commands (hyprctl, xdg-settings) and displays window previews. No malicious behavior, network access, or file modifications were found.

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/AyushKr2003/omarchy-overview --enable
Appearance #Hyprland #quickshell #workspaces

Omarchy Overview Plugin

A Hyprland workspace overview plugin with live window previews, seamless theme integration, and app icon resolution for Omarchy Shell.

Omarchy Overview Screenshot

💡 Credits & Attribution: This plugin is adapted from and made compatible with Omarchy based on Shanu-Kumawat/quickshell-overview.

Installation

Via omarchy plugin (Recommended)

Install directly from GitHub using the Omarchy plugin CLI:

omarchy plugin add https://github.com/AyushKr2003/omarchy-overview.git

Manual Installation

Clone or copy this folder directly into your Omarchy plugins directory:

mkdir -p ~/.config/omarchy/plugins/omarchy-overview
cp -r . ~/.config/omarchy/plugins/omarchy-overview/

Then rescan and enable the plugin:

omarchy plugin rescan
omarchy plugin enable omarchy-overview

Uninstallation

Via omarchy plugin (Recommended)

Remove the plugin using the Omarchy CLI:

omarchy plugin remove omarchy-overview

Manual Uninstallation

omarchy plugin disable omarchy-overview
rm -rf ~/.config/omarchy/plugins/omarchy-overview
omarchy plugin rescan

Keybinding & Usage

Toggle via Shell IPC

omarchy-shell shell toggle omarchy-overview

Hyprland Keybinding (bindings.lua)

Add the following binding to your ~/.config/hypr/bindings.lua:

hl.unbind("SUPER + TAB")
o.bind("SUPER + TAB", "Overview", "omarchy-shell shell toggle omarchy-overview")

Configuration

Settings are read inline from ~/.config/omarchy/shell.json inside the plugins array entry:

{
  "id": "omarchy-overview",
  "rows": 2,
  "columns": 5,
  "hideEmptyRows": true,
  "showSpecialWorkspaces": false,
  "specialWorkspaceColumns": 5,
  "showIcons": true
}

Available Settings Schema

Setting Type Default Description
rows integer 2 Number of workspace grid rows.
columns integer 5 Number of workspace grid columns.
hideEmptyRows boolean true Hides empty rows automatically.
showSpecialWorkspaces boolean false Includes special scratchpad workspaces.
specialWorkspaceColumns integer 5 Columns count for special workspaces.
showIcons boolean false Display resolution-matched app icons on window delegates.

Features & Omarchy Integration

  • Live Window Previews: Renders real-time Hyprland window thumbnails across workspaces.
  • Dynamic App Icon Resolution: Resolves standard GUI apps, webapps/PWAs (Chrome/Brave/Edge), and terminal TUI apps (Yazi, Neovim, btop, ranger) matching omarchy.menu.
  • Theme Integration: Follows active Omarchy shell theme tokens (qs.Commons.Color & qs.Commons.Style).
  • HiDPI Scaling: Automatically scales icon rendering by Screen.devicePixelRatio for sharp rendering.

Credits

License

This project is licensed under the MIT License.