Go

1 files changed, 34 insertions, 0 deletions

diff --git a/quickshell/gruvbar/README.md b/quickshell/gruvbar/README.md
new file mode 100644
index 0000000..3c759ec
--- /dev/null
+++ b/quickshell/gruvbar/README.md
@@ -0,0 +1,34 @@
+# Gruvbar Quickshell
+
+This is a Quickshell replacement bar for the current i3/Polybar setup. It keeps the Gruvbox palette and FiraCode Nerd Font look, but uses QML widgets instead of Polybar text modules.
+
+## Run
+
+```sh
+sudo pacman -S quickshell
+~/.config/quickshell/gruvbar/launch.sh
+```
+
+The config is a named Quickshell config, so this also works:
+
+```sh
+quickshell -c gruvbar
+```
+
+## Switch i3 From Polybar
+
+After testing the bar manually, change the i3 startup line from Polybar to Gruvbar:
+
+```i3
+# exec_always --no-startup-id ~/.config/polybar/launch.sh
+exec_always --no-startup-id /home/aag/.config/quickshell/gruvbar/launch.sh
+```
+
+## Widgets
+
+- Workspaces with click and scroll switching.
+- Expand/minimize button for compact and full modes.
+- Clickable notification, force-awake, volume, keyboard, WireGuard PC, display, mic, music, scratchpad, screenshot, clipboard, update, and power controls.
+- Live CPU, memory, disk, network, network speed, temperature, and clock status.
+
+Most actions reuse the existing Polybar scripts so the behavior stays aligned while the UI moves to Quickshell.