Repository files navigation

Provides a way to run menubar commands throughrofi, much like the Unity 7Heads-Up Display (HUD).plasma-hud was forked frommate-hud which was based oni3-hud-menu. There's also agnome-hud.

If you are interested in Unity's other feature, locally integrated menus in window titlebars, then you may want to check out theMaterial KWin decoration which has that feature.

A Heads-Up Display (HUD) allows you to search through an application'sappmenu. So if you're trying to find that single filter in Gimp butcan't remember which filter category it fits into or if you can'trecall if preferences sits under File, Edit or Tools on your favouritebrowser, you can just search for it rather than hunting through themenus.

• AUR:https://aur.archlinux.org/packages/plasma-hud-git/

sudo apt install rofi python3 python3-dbus python3-setproctitle python3-xlib gir1.2-gtk-3.0sudo apt install appmenu-gtk2-module appmenu-gtk3-module # Gtk2 / Gtk3

Or useunity-gtk2-module unity-gtk3-module for Gtk2 / Gtk3.

pacman -S rofi python python-dbus python-setproctitle python-xlib python-gobject gobject-introspectionpacman -S appmenu-gtk-module

• Either use the Global Menu widget, or add the App Menu button in to the titlebar.
• Downloadplasma-hud

git clone https://github.com/Zren/plasma-hudcd plasma-hud

• Install files

sudo mkdir -p /usr/lib/plasma-hudsudo cp usr/lib/plasma-hud/plasma-hud /usr/lib/plasma-hud/sudo mkdir -p /etc/xdg/autostartsudo cp etc/xdg/autostart/plasma-hud.desktop /etc/xdg/autostart/

• Either run the script in the terminal for plasma-hud to work in your current session. Or relog since it should now autostart the next time you login.

/usr/lib/plasma-hud/plasma-hud

• Run the following commands to bind theAlt keys. For Arch users, you will needqt5-tools installed to runqdbus.

kwriteconfig5 --file ~/.config/kwinrc --group ModifierOnlyShortcuts --key Alt "com.github.zren.PlasmaHUD,/PlasmaHUD,com.github.zren.PlasmaHUD,toggleHUD"qdbus org.kde.KWin /KWin reconfigure

• If you wish to bind to a normal shortcut key likeMenu orAlt+F1 then create a new custom global shortcut in the System Settings.
  • System Settings > Shortcuts > Custom Shortcut
  • Edit > New > Global Shortcut > D-Bus Command
  • Trigger > Shortcut:Menu
  • Action > Remote application:com.github.zren.PlasmaHUD
  • Action > Remote object:/PlasmaHUD
  • Action > Function:toggleHUD
  • Action > Arguments: Leave it empty

• Run the following commands to unbind theAlt keys.

kwriteconfig5 --file ~/.config/kwinrc --group ModifierOnlyShortcuts --key Alt ""qdbus org.kde.KWin /KWin reconfigure

• Uninstall files

sudo rm /usr/lib/plasma-hud/plasma-hudsudo rm /etc/xdg/autostart/plasma-hud.desktop

If you manually create~/.config/plasmahudrc you can change any of the following settings.

[General]Matching=fuzzySort=trueLines=20Location=centerWidth=80[Icons]Enabled=trueTheme=breeze-dark[Shortcuts]Enabled=true[Style]Font=Sans 10Title=::[Colors]Background=#111111Foreground=#eeeff0SelectedBackground=#062d25SelectedForeground=#1abc9cBorders=#000000ShortcutForeground=#888888

• [General] Matching=fuzzy can be eitherfuzzy matching ornormal matching where it matches a keyword exactly. Seeman rofi | grep "\-matching" -A20 for more info.

• [General] Location=center specifies the position relative to the window for the HUD to appear and can be one of the following values:
  northwest,north,northeast,west,center,east,southwest,south,southeast

• [General] Width=80 is 80% of the window width. The default is 100% window width.

• [Style] Title=:: will change theHUD: prompt text to::: which is roughly the width of an icon.

You can also set[Style] RofiTheme=Arc to select a rofi theme in:

• /usr/share/rofi/themes/
• ~/.local/share/rofi/themes/

[Style]RofiTheme=Arc-Dark

Run the following commands in a terminal likeKonsole to debugplasma-hud.

killall plasma-hud; LOGLEVEL=DEBUG~/Code/plasma-hud/usr/lib/plasma-hud/plasma-hud