Skip to content

ajxcodes/mac-title-menu

 
 

Repository files navigation

Mac Title Menu

Mac Title Menu Logo

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

Hover State Themes
Hover states across different Plasma themes

Pressed State Themes
Pressed states across different Plasma themes

Settings Configuration
Applet Settings (Appearance, Behavior, Substitutions, Keyboard Shortcuts)

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 Title 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

2 stars

Watchers

0 watching

Forks

Packages

 
 
 

Contributors

Languages

  • QML 95.3%
  • JavaScript 4.2%
  • Shell 0.5%