Mac Menu

A macOS-native GUI implementation inspired by fzf, providing a clean and modern fuzzy finder interface for your command-line workflows.

Features

• Native macOS UI with modern design
• Fuzzy search functionality similar to fzf
• Keyboard navigation (Up/Down arrows, Ctrl+P/N)
• Mouse support with hover effects
• Transparent, blur-backed window
• Fast and responsive
• Standard input/output for seamless integration with command-line tools
• Perfect for filtering and selecting from command output

For a detailed overview of Mac Menu, including real-world examples and use cases, check out the blog post.

Installation

Using the installation script

curl -sSL https://raw.githubusercontent.com/sadiksaifi/mac-menu/main/install.sh | bash

Manual Installation

Using Make (Recommended)

1. Clone this repository

2. Build and install:

   make
   sudo make install

3. To uninstall:

sudo make uninstall

Usage

Basic usage:

echo -e "Firefox\nSafari\nChrome" | mac-menu

The selected item will be printed to stdout.

Keyboard Shortcuts

• Up Arrow or Ctrl+P: Move selection up
• Down Arrow or Ctrl+N: Move selection down
• Enter: Select current item
• Escape: Exit without selection

Building

# Build the application
make

# Clean build files
make clean

Testing

A simple test is included to verify the application with basic input. This test will run the app with "Yes" and "No" as options:

make test

This will build the application (if needed) and launch it with "Yes" and "No" as selectable options. You can interact with the UI as usual (keyboard/mouse), and the selected value will be printed to stdout.

License

MIT License - See LICENSE file for details.

Contributing

Contributions are welcome! Please read contribution guidlines.