Skip to content

ajxcodes/mac-app-menu

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

173 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Mac App Menu

A Mac-like window title and context menu applet built natively for KDE Plasma 6.

Features

  • Mac-Style App Menu: Left-click the active window's title in the panel to open a native context menu with window management actions (Minimize, Maximize, Close, Keep Above, etc.).
  • Native Plasma 6 Architecture: Built on PlasmaExtras.Menu to ensure robust Wayland support, focus management, and flawless C++ backend integration.
  • Pixel-Perfect Aesthetic: Mathematically centered layouts and 2px tight vertical panel margins seamlessly mirror the native Plasma 6 Global Menu button contour and styling.
  • Dynamic Substitutions: Highly customizable text display using variables like %a (App Name) and %w (Window Title).

Credits & Acknowledgments

This project was heavily refactored and expanded from the fantastic foundational work of:

  • Dhruvesh Surolia (who ported the original concept to Plasma 6)
  • Psifidotos (creator of the original Active Window Control applet)

Substitutions

Images

image
App name (not clicked)

image
App name clicked

image
App name with icon


Appearance Settings

Screenshot_20240728_192316
Behavior Settings

Screenshot_20240728_192323
Substitutions Settings

Installation

Via KDE Store (Recommended)

You can easily install this directly through your Plasma Desktop:

  1. Right-click your panel and select Add Widgets...
  2. Click Get New Widgets...
  3. Search for Mac App Menu and hit install!

Manual Installation

If you've cloned this repository, you can easily install and test it using the provided script:

./install.sh

Note: This script copies the contents to ~/.local/share/plasma/plasmoids/com.ajxcodes.macappmenu and automatically restarts the Plasma shell.

Alternatively, you can build and install it using Plasma's native package tool:

kpackagetool6 -t Plasma/Applet -i ./

About

Plasma 6 Window Title applet

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages

  • QML 95.2%
  • JavaScript 4.3%
  • Shell 0.5%