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

Homebrew (Recommended)

brew install sadiksaifi/tap/mac-menu

Manual Installation

Using Make

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 build

# Clean build files
make clean

Testing

Run the Swift Testing suite:

make test

For a quick manual check of the UI, pipe input into the app and launch it via the convenience target:

echo -e "Yes\nNo" | make run

License

MIT License - See LICENSE file for details.

Contributing

Contributions are welcome! Please read contribution guidlines.