1
0
Fork
You've already forked quickflare
0
No description
  • QML 100%
2026年03月16日 23:26:40 -03:00
config.json feat: app icon support, DND, and config.json defaults 2026年03月04日 12:57:33 -03:00
IconResolver.qml feat: app icon support, DND, and config.json defaults 2026年03月04日 12:57:33 -03:00
IndicatorPopup.qml fix: size popup window to content to prevent input blocking 2026年03月16日 23:20:05 -03:00
NotificationWatcher.qml feat: initial Quickshell workspace notification indicator 2026年03月04日 12:57:18 -03:00
README.md docs: remove missing preview image from README 2026年03月16日 23:26:40 -03:00
shell.qml fix: size popup window to content to prevent input blocking 2026年03月16日 23:20:05 -03:00
WorkspaceTracker.qml feat: initial Quickshell workspace notification indicator 2026年03月04日 12:57:18 -03:00

quickflare

Workspace notification indicator for Quickshell on Hyprland/wlr compositors.

When a notification arrives from an app in a different workspace, a small popup appears at the edge of the screen pointing toward that workspace. Click it to jump there.

Features

  • Directional arrow (▲さんかく / ▼) showing which way the app is
  • App name or icon display
  • Amber and dark themes
  • Left / center / right positioning
  • Auto-dismiss timeout
  • Do Not Disturb toggle (via /tmp/ws-indicator-dnd file or config.json)
  • Blocklist to ignore specific apps

Requirements

  • Quickshell
  • A wlr-layer-shell compositor (Hyprland, Sway, etc.)
  • VT323 font (optional, for the retro look)

Installation

Clone the repo and point Quickshell at it:

git clone https://codeberg.org/kurama/quickflare ~/.config/quickshell/quickflare

Add to your Quickshell config or run directly:

quickshell -p ~/.config/quickshell/quickflare

Configuration

Edit config.json:

{
 "blocklist": ["firefox", "chromium"],
 "timeoutSeconds": 5,
 "position": "center",
 "theme": "amber",
 "showWorkspace": true,
 "showIcon": false,
 "dnd": false
}
Key Values Description
blocklist array of strings App names to ignore (case-insensitive)
timeoutSeconds number (0 = no timeout) Auto-dismiss delay in seconds
position "left" "center" "right" Horizontal position of the popup
theme "dark" "amber" Color theme
showWorkspace boolean Show the workspace name in the popup
showIcon boolean Show app icon instead of app name
dnd boolean Start with Do Not Disturb enabled

Do Not Disturb toggle

Write 1 or true to /tmp/ws-indicator-dnd to suppress popups at runtime:

echo 1 > /tmp/ws-indicator-dnd # enable DND
echo 0 > /tmp/ws-indicator-dnd # disable DND

Bind this to a key in your compositor config for quick toggling.

Disclaimer

This project was vibe coded. It works on my machine. Use at your own risk.