Omahub
← All plugins
M

Favorite Folders

by MrDemonc

Omarchy popup bar widget to manage and quickly open favorite folder shortcuts in your default file manager

GitHub

Security review

Review recommended · 1 finding

Deterministic scan — not a security guarantee

Low
Risk level
Low
Analyzed commit
47a81f8
Scanned
1 month ago

Flagged patterns appear only in documentation files (README / docs) — descriptive examples, not executable code.

  • Docs external_hosts README.md:23

    Downloads or connects to an external HTTP(S) host.

    git clone https://github.com/MrDemonc/omarchy-favorite-folders.git

Automated analysis only — not a security guarantee.

AI advisory review

No obvious issues detected

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

Low
AI risk level
Low
Recommendation
install
Model
~deepseek/deepseek-v4-flash-latest
Analyzed commit
47a81f8
Reviewed
1 month ago

The plugin is a straightforward Quickshell bar widget that manages favorite folder shortcuts: it stores them in a local JSON file, checks folder existence via a bash one-liner with paths passed as argv, and opens folders with xdg-open. The only deterministic finding is the README's `git clone` URL, which is installation documentation and is not executed by the plugin itself; no obfuscation, credential theft, destructive install steps, or hidden network activity was 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/MrDemonc/Omarchy-favorite-folders --enable
Productivity #bar

Omarchy Favorite Folders

A native Omarchy (Hyprland + Quickshell) bar widget and popup card for quickly accessing, managing, and opening your favorite folder shortcuts in your default file manager (xdg-open).

<p align="center"> <img src="res/favorite-folders.png" alt="Hardware Tooltip opening on one Omarchy theme, then following a theme change with live CPU and GPU bars" width="360"> </p>

Installation

Option 1:

omarchy plugin add https://github.com/MrDemonc/omarchy-favorite-folders.git --enable
omarchy restart shell

Option 2:

git clone https://github.com/MrDemonc/omarchy-favorite-folders.git
cd omarchy-favorite-folders
./install.sh --enable --restart

✨ Features / Características

  • 📁 Bar Widget Icon:

    • Clean folder icon (󰉋) in the Omarchy bar.
    • Active indicator when popup is open.
    • Live tooltip showing total configured shortcuts.

  • ➕ Add Folder Shortcuts (+):

    • Add any directory path (e.g., /home/demonc/Documents/Proyects/omarchy-media-control or ~/Downloads).
    • Auto-detection: Automatically extracts a clean display name from the folder path if left empty.
    • Visual Folder Picker: Built-in Browse... (󰉓) button powered by Zenity for graphical folder selection.
    • Quick Preset Chips: Fast one-click shortcuts for Home, Documents, Downloads, Projects, and Pictures.

  • 👻 Missing Folder Detection::

    • If0 an added folder is deleted or moved within the system, the widget automatically detects it and displays a ghost icon (󰊠) along with the missing label in an alert color.
    • Clicking on a broken shortcut notifies the user instead of silently failing, allowing them to edit the path or delete the shortcut.

  • 🚀 Default File Manager Integration:

    • Clicking any folder item launches your system's default file explorer (Nautilus, Dolphin, Thunar, etc.) instantly via xdg-open.

  • 󰏫 Edit Shortcuts:

    • Easily update existing folder paths and custom alias names.

  • 󰩹 Safe Deletion:

    • Remove shortcuts with a clear confirmation dialog to prevent accidental removals.

  • 💾 Persistent Configuration:

    • Automatically saves and loads your folder shortcuts in ~/.config/omarchy/favorite-folders.json.

  • ⌨️ Keyboard Accessibility:

    • Press <kbd>Esc</kbd> to exit forms or close the popup modal.
    • Press <kbd>Enter</kbd> to quickly save folder forms.

🎛️ Interaction Cheatsheet

Action Control / Gesture
Open / Close popup Left click on the bar icon (󰉋)
Close popup Press <kbd>Esc</kbd> or click outside the popup
Open Folder Left click on any folder item in the list
Add Folder Click + Add button in the header or empty state
Browse Folder Visually Click Browse... in the Add/Edit form
Edit Folder Click pencil icon (󰏫) on any folder row
Delete Folder Click trash icon (󰩹) and confirm

⚙️ Uninstallation

To remove the plugin from Omarchy:

omarchy plugin remove omarchy-favorite-folders
omarchy restart shell