Skip to content

feat(hyprland): add unified workbar module#5211

Open
Uts-v-Sinha wants to merge 14 commits into
Alexays:masterfrom
Uts-v-Sinha:workbar
Open

feat(hyprland): add unified workbar module#5211
Uts-v-Sinha wants to merge 14 commits into
Alexays:masterfrom
Uts-v-Sinha:workbar

Conversation

@Uts-v-Sinha

Copy link
Copy Markdown

Summary

This PR introduces a new hyprland/workbar module that combines workspace navigation and taskbar functionality into a single module.

Instead of displaying workspaces and windows separately, each workspace is represented by a single pill containing the workspace number together with icons for the windows currently opened on that workspace.

The module is implemented using Waybar's native Hyprland IPC backend and does not rely on external helper scripts.


Features

  • Unified workspace and taskbar module
  • Application icons grouped by workspace
  • Active workspace highlighting
  • Active window highlighting
  • Visible workspace indication for multi-monitor setups
  • Drag-and-drop window movement between workspaces
  • Middle-click window icons to close windows
  • Incremental widget updates
  • Fully customizable through CSS
  • Native Hyprland IPC implementation

Screenshots

Normal usage

2026-07-14_15-51-02

Shows grouped window icons together with workspace numbers.


Multi-monitor

2026-07-14_15-47-58

Visible workspaces remain highlighted even when another monitor is focused.


Drag and drop

InShot_20260720_191504075

Performance

The workbar reuses existing widgets and updates incrementally instead of rebuilding the entire interface whenever Hyprland state changes.


Motivation

The existing Hyprland modules separate workspace navigation and task management into different modules.

This module provides a more workspace-centric workflow by grouping both into a single component, reducing bar clutter while making workspace contents immediately visible.


Implementation

The workbar consists of:

  • Live Hyprland IPC backend
  • Workspace container widgets
  • Workspace number widget
  • Window icon widgets
  • Incremental updates without rebuilding the entire module
  • Native Hyprland IPC dispatching

The implementation avoids external scripts and shell commands by using Waybar's existing Hyprland IPC interface.


Mouse Interaction

Action Result
Left click workspace number Switch workspace
Left click window icon Focus window
Middle click window icon Close window
Drag window icon Move window to another workspace

Documentation

  • Added man/waybar-hyprland-workbar.5.scd

Testing

Tested locally with:

  • Multiple workspaces
  • Multiple monitors
  • Window creation/removal
  • Window movement between workspaces
  • Active window switching
  • Drag-and-drop window movement
  • Native Hyprland IPC (no external scripts)

@Uts-v-Sinha Uts-v-Sinha changed the title Workbar feat(hyprland): add unified workbar module Jul 20, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant