HyprFlow

Note

Originally forked from gaurav23b/simple-hyprland and extensively re-engineered with a custom Wayland layer-shell desktop engine, an instant light/dark theme switcher, standalone GTK3/Cairo system popover applets, and hybrid GPU power optimizations.

HyprFlow is a clean, modern, and cohesive Hyprland desktop environment built around the Catppuccin palette. It combines a persistent layer-shell desktop manager, lightweight Python/GTK3 system popovers, Waybar, Rofi, Dunst, and Kitty into a unified, high-performance Linux workflow.

---

Installation

git clone https://github.com/Baran-sys/hyprland-dotfiles.git ~/hyprland-dotfiles
cd ~/hyprland-dotfiles
chmod +x install.sh
./install.sh

The installer verifies and installs required dependencies, creates a timestamped backup of existing configurations in ~/.config/hyprland-backup-[TIMESTAMP]/, deploys all dotfiles and custom scripts to ~/.config and ~/.local, and reloads active session components automatically.

---

Previews

Desktop and Themes

Dark Mode (Catppuccin Mocha)	Light Mode (Catppuccin Latte)

Media and System Monitoring

Media Controller	Task and Resource Monitor

System Popover Applets

Wi-Fi Manager	Bluetooth Manager

Calendar	Clock and Pomodoro

Audio Control	Power and Display

Launcher and Screen Capture

Application Launcher (Spotlight)	Snipping and Screen Recording Tool

---

Features

Cohesive Catppuccin Mauve Design

All floating applets and Waybar modules share an identical design system. Sliders, seek bars, connected status badges, active power profiles, and RAM indicators are harmonized with Catppuccin Mauve accents and matching opacity variants across both dark and light modes.

Standalone GTK3 Popover Applets

System controls are implemented as lightweight, standalone Python/GTK3 applets managed by waybar_focus.py:

• Smart Alignment: Popovers dynamically calculate their screen position to center directly beneath their corresponding Waybar modules.
• Fast Toggle: Instant open/close with single-instance enforcement and zero background overhead.
• Auto-Dismiss: Seamlessly closes popovers whenever focus shifts to another window or workspace.

Dedicated Clock and Pomodoro Tracker (clock-app, waybar-clock, pomodoro_core.py)

• Dual Waybar Module: Clean separation of calendar date and live clock/timer.
• Pomodoro Timer: Interactive circular progress ring, configurable focus and break intervals, session counters, and desktop sound notifications.
• State Synchronization: Background daemon maintains timer state across applet open/close actions and displays a live countdown on Waybar.

Independent Calendar Applet (calendar-app)

• Displays interactive full-month navigation, current week numbering, day-of-year statistics, and quick reset to the present day.

Snipping and Screen Recording Tool (screenshot-menu)

• Floating pill-shaped toolbar centered at the top of the focused monitor.
• Supports Rectangular Selection, Active Window capture, Fullscreen screenshot, and live Screen Recording.
• Encoder dropdown settings for custom resolution (1080p / 720p), framerate (60 FPS / 30 FPS), and audio capture toggle.

Network and Device Management

• Wi-Fi Manager (wifi-manager): Real-time network scanning, signal strength bars, connection details, and secure credential handling.
• Bluetooth Manager (bluetooth-manager): Discover nearby devices, one-click pair/connect/disconnect, battery level monitoring, and consistent device row layouts.

Audio Control (audio-mixer)

• Streamlined compact interface with borderless tab switcher for Output Devices, Input Devices, and Application volume streams.
• Direct device switching, per-app mute toggles, and smooth volume adjustments.

Task and Resource Monitor (task-manager)

• Real-time CPU, RAM, and GPU load monitoring.
• Per-process hardware utilization tracking with distinct hybrid GPU tags (Intel iGPU vs. NVIDIA dGPU).
• Instant search filtering and process termination.

Persistent Layer-Shell Desktop (desktop-manager)

• Custom Wayland background layer keeping desktop files and folders visible across all workspaces.
• Spring-animated drag-and-drop, rubberband multi-selection, external file drops, and folder color customization.

Instant Light and Dark Theme Switcher (toggle-theme)

• Toggled via Super + Shift + T or right-clicking the Waybar brightness module.
• Atomically synchronizes wallpapers, Waybar CSS, GTK3/4 themes, Qt/Kvantum styles, Rofi, Dunst, Kitty, and Hyprlock without restarting the compositor.

---

Keybindings

Shortcut	Action	Shortcut	Action
Super + T	Terminal (kitty)	Super + Shift + T	Toggle Dark / Light Theme
Super + E	File Manager (dolphin)	Super + G	Toggle Floating Window
Super + B	Web Browser (firefox)	Super + P	Color Picker (hyprpicker)
Super + C	Code Editor (code)	Super + L	Lock Screen (hyprlock)
Super + O	Notes (obsidian)	Super + Q	Close Active Window
Super + A	App Launcher (spotlight-menu)	Super + H	Application Visibility Manager
Super + V	Clipboard History (clipboard-menu)	Ctrl + Escape	Toggle Waybar
Super + F	Fullscreen Window	Print / Super + Shift + S	Snipping Tool and Screen Recorder
Super + Print	Active Window Screenshot	Super + Alt + Print	Quick Area Screenshot

---

License

This project is licensed under the MIT License.