XFCE4 Apple Menu Plugin

A panel plugin for XFCE4 that mimics the macOS Apple menu, providing a familiar and intuitive system menu experience for XFCE desktop users.

![XFCE4 Apple Menu Plugin]

Features

• 🍎 Apple-style Menu: Familiar dropdown menu with Apple logo
• 💻 System Information: Quick access to system details
• 📦 Package Management: Integration with system package manager
• 📄 Recent Items: Track and access recently used files and applications
• ⚡ Quick Actions: Sleep, restart, shutdown, lock screen, and log out
• 🎨 Themeable: Supports GTK+ theming and custom icons
• 🌍 Internationalization: Multi-language support

Menu Structure

• About This Computer - System information and details
• System Preferences - Quick access to XFCE Settings Manager
• App Store - Launch system package manager
• Recent Items - Recently accessed documents and applications
• Force Quit - Application management
• System Actions - Sleep, Restart, Shut Down, Lock Screen, Log Out

Requirements

Runtime Dependencies

• XFCE4 Panel (>= 4.16)
• GTK+3 (>= 3.24)
• libxfce4util (>= 4.16)
• libxfce4ui (>= 4.16)
• System package manager (for App Store functionality)

Build Dependencies

• meson (>= 0.49.0)
• ninja-build
• gcc or clang
• pkg-config
• libxfce4panel-2.0-dev (>= 4.16)
• libxfce4ui-2-dev (>= 4.16)
• libxfce4util-dev (>= 4.16)
• libgtk-3-dev (>= 3.24)
• libglib2.0-dev (>= 2.66)
• libexo-2-dev (>= 4.16, optional)
• libdbus-glib-1-dev (>= 0.110, optional)

Installing Build Dependencies on Debian 11

sudo apt update
sudo apt install meson ninja-build gcc pkg-config \
    libxfce4panel-2.0-dev libxfce4ui-2-dev \
    libxfce4util-dev libgtk-3-dev libglib2.0-dev \
    libexo-2-dev libdbus-glib-1-dev

Installation

From Source

# Clone the repository
git clone https://github.com/Axis0S/xfce4-applemenu-plugin.git
cd xfce4-applemenu-plugin

# Build and install using Meson
meson setup build --prefix=/usr
cd build
ninja
sudo ninja install

# Or use the provided install script
./install.sh

# Restart XFCE Panel
xfce4-panel -r

Debian/Ubuntu

# Build and install Debian package
./build-deb.sh
sudo dpkg -i ../xfce4-applemenu-plugin_*.deb

Configuration

Right-click on the plugin in the panel and select "Properties" to access:

• Icon selection (Apple logo or custom)
• Recent items settings
• Menu behavior options
• Keyboard shortcuts

Package Manager Integration

The "App Store" menu item can be configured to launch your preferred package manager through the plugin's Properties dialog. Common options include:

• pamac-manager (Arch-based distributions)
• gnome-software (GNOME)
• synaptic (Debian/Ubuntu)
• kde-discover (KDE)

Theming

The plugin respects your GTK+ theme. For custom styling, add to ~/.config/gtk-3.0/gtk.css:

#xfce4-applemenu-plugin button {
    padding: 4px 8px;
    border-radius: 4px;
}

#xfce4-applemenu-plugin button:hover {
    background-color: @theme_selected_bg_color;
}

Troubleshooting

Plugin not appearing

1. Ensure the plugin is properly installed: ls /usr/lib/xfce4/panel/plugins/
2. Add it through Panel Preferences → Items → Add → Apple Menu

Package manager not launching

1. Verify your package manager is installed
2. Configure the correct package manager in plugin Properties

Icons not displaying

1. Install an icon theme with Apple logo support
2. Or place custom Apple logo in ~/.local/share/icons/

Contributing

Contributions are welcome! Please:

1. Fork the repository
2. Create a feature branch
3. Follow XFCE coding standards
4. Submit a pull request

See CONTRIBUTING.md for detailed guidelines.

License

This project is licensed under the GPL-2.0+ License - see the LICENSE file for details.

Acknowledgments

• XFCE Development Team for the panel plugin framework
• Apple Inc. for the menu design inspiration
• Package manager developers
• Contributors and translators

Links

• Documentation
• XFCE Panel Plugin Guide
• Report Issues

Author

Kamil 'Novik' Nowicki

• Email: novik@axisos.org
• Website: https://axisos.org
• GitHub: https://github.com/Axis0S