Skip to content

Enhanced plank-wayland dock with multi-window picker, hover menu, 20+ themes #9

Description

@franklinbravos

I forked and enhanced the original plank-wayland example with several improvements for daily driver use. Sharing back to the community:

Repository: https://github.com/franklinbravos/plank-wayland

Features added:

  • Multi-window picker — click or hover (400ms delay) on apps with multiple windows to show a window selection menu
  • Hover auto-open/close — hover over dock icons opens/closes the window menu automatically
  • Multi-monitor support — dock renders on both internal and external displays
  • Window focus via Hyprland IPC — clicking a window entry in the menu dispatches focuswindow + alterzorder + movecursor
  • Auto-hide timer — menu auto-closes after 5s of inactivity (pauses on hover)
  • Tooltip suppression — app name tooltip hides when window menu is open
  • 20+ built-in themes — macos, glass, neon, obsidian, deep-sea, frost, etc.
  • Settings panel — right-click dock background to customize live
  • Icon theme auto-detection — follows GTK/KDE system icon theme

Key fixes over the original example:

  • Fixed ReferenceError: dockWindow is not defineddockWindow is inside a Loader > Component and was inaccessible from ShellRoot.activateApp()
  • Added WlrLayershell.layer: WlrLayer.Overlay to menu PanelWindow so clicks register above windows

All configuration is documented with a full README.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions