Widgets¶
Widgets are special bar items that go beyond launching apps. Use them to run actions with a click, group items into folders, or access your bookmarks directly from the bar.
Adding a widget¶
Open ExtraBar and click Manage on a preset
Click the + button to add items
Choose a widget type: Action, Folder, or Bookmark
All widgets have a custom name, icon, and icon color.
Action widget¶
An action widget puts a single action on your bar as a clickable icon. When Run on Click is enabled (the default), clicking the widget executes the action immediately — no menu needed.
Configure an action widget:
Action — Choose any action from the action library (Open, Open URL, Run Script, etc.)
Target App — Optionally set a target application for the action
Run on Click — Execute the action on click instead of opening a menu
Folder widget¶
A folder widget groups multiple items behind a single icon. Click it to open a popover with all the items inside.
A folder can contain:
Apps — Add apps with their own action menus
Actions — Add standalone actions
Bookmarks — Add a bookmark list filtered by folder or tag
Import from Preset — Pull items from an existing preset
Manage folder items:
Drag to reorder
Click the gear icon to configure an item
Use Select mode to multi-select items for bulk move/copy operations
Apps inside a folder can have their own custom action menus, just like top-level bar items.
Bookmark widget¶
A bookmark widget shows your Shiori bookmarks in a popover with search and filtering. Requires a Shiori account.
Display options:
Search bar — Toggle the search field
Max visible items — Limit how many bookmarks appear
Sort — By recent, name, or URL (ascending or descending)
Behavior options:
Show favicons — Display site icons
Show folders — Show folder badges
Show tags — Show tag badges
Pinned first — Pin important bookmarks to the top
Filter options:
Folders — Show bookmarks from specific folders only
Tags — Show bookmarks with specific tags only
Saved filter — Use a saved filter from Shiori