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

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions