Skip to content

edmogeor/kppleMenu

 
 

Repository files navigation

Kpple Menu (Customizable)

A macOS-style Apple menu for KDE Plasma 6, now fully customizable.

Forked from ChrTall's Kpple Menu.

Features

  • Add, remove, and reorder menu items
  • Create custom menu items with any command
  • Add dividers anywhere in the menu
  • Edit item names and commands
  • Optional keyboard shortcut labels
  • Custom panel icon support

Previews

menu preview customization preview

Default Menu Items

  • About This Computer (System Info)
  • System Preferences
  • App Store (Discover)
  • Sleep, Restart, Shut Down
  • Lock Screen & Log Out

All items can be customised, removed, or reordered in settings.

Installation

From KDE Store (Recommended)

Install via the KDE Store (link coming soon).

Manual Installation

git clone https://github.com/edmogeor/kppleMenu.git
cd kppleMenu
./install.sh

To install system-wide:

./install.sh --global

To uninstall:

./uninstall.sh

Usage

  1. Add the widget to your panel
  2. Right-click and select "Configure..."
  3. Use the menu editor to add, remove, edit, or reorder items
  4. Click "Add Item" for custom commands or "Add Divider" for separators

Keyboard Navigation

  • Configure a global shortcut under Settings → Keyboard Shortcuts
  • Navigate with Tab/Shift+Tab or Arrow keys
  • Press Enter or Space to execute selected item
  • Lock Screen: Ctrl + Alt + Q
  • Log Out: Shift + Alt + Q

Credits

  • Original Kpple Menu by Kpple (2020)
  • KDE Plasma 6 port by ChrTall (2024)

License

GNU GPL v2.0

About

The Kpple menu is the drop-down menu of Kpple OS.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages

  • QML 85.0%
  • Shell 12.4%
  • JavaScript 2.6%