Skip to content

Repository files navigation

MacTools logo

MacTools

Your Mac's everyday tools, right in the menu bar.

Free, open source, and native to macOS. Build your own panels, connect actions, and add the tools you need.

English · 简体中文

Latest app release macOS 14 or later GPL-3.0-only license

Website · Download · Documentation · Feedback

System status panel with live metrics, processes, device batteries, and quick controls Activity Statistics panel with input counts, screen time, app usage, and trends Quick controls for displays, appearance, audio, and power

Install

brew install --cask mactools

Or download the app from GitHub Releases. Requires macOS 14 or later; some plugins need newer macOS versions or compatible hardware.

Open MacTools, choose plugins in Settings → Marketplace, then arrange your menu bar panels. Permissions are requested as needed.

Plugin shortcut settings use the same separate section headings and native cards as other settings, without empty-section gaps or redundant navigation buttons.

Custom settings workspaces use adaptive system backgrounds that coordinate with native settings cards. Search fields, inset previews, and selected controls retain distinct visual roles in light and dark appearance.

System Status settings use subtle metric row separators, aligned controls, and a two-line metric header in narrow windows to keep names and value assignments readable.

Updates and Nightly builds

MacTools checks for app updates automatically. With Homebrew:

brew update
brew upgrade --cask --greedy mactools

Try development features with MacTools-Nightly.dmg from a nightly-* prerelease. Nightly has separate preferences and plugins and can coexist with the stable app. It is intended for testing; hardware controls still affect the same Mac.

Make it yours

Custom panels

Mix live widgets, quick controls, and feature rows. Drag to rearrange them, move them between panels, and choose each panel's icon. More and editing menus open on the first click from a background app; detail panels stay open during internal focus changes.

MacTools component library with a System Status widget preview

Custom themes

Choose built-in palettes or import iTerm2 and Base16/Base24 themes. Set light and dark themes separately, and personalize the menu bar icon with images or animations.

Dark theme gallery with System Default, One Dark, GitHub Dark, and other palettes

Automation & workflows

Chain actions with delays and failure handling. Trigger workflows by schedule, calendar events, apps, power, displays, or network changes, and review their run history.

Multi-step workflow in the MacTools automation editor

A growing plugin marketplace

Browse dozens of plugins for productivity, displays, audio, cleanup, and monitoring. Install and update the ones you need, with settings and shortcuts in one place.

MacTools plugin marketplace with category filters and installed plugins

Get to any action quickly

Search actions, settings, workflows, and plugins from the Command Palette. Press ⌘K within MacTools, or assign a global shortcut to open it from anywhere. Use Action Grid, keyboard shortcuts, mouse mappings, or trackpad gestures for frequent actions; connect Apple Shortcuts, saved scripts, and Run Links to your setup.

Window Switcher keeps search collapsed in direct-key and cycling modes. All Windows sits beside the display filter and expands when an app scope is available; Search, More, and the grid/list control align to the right. Click Search or press ⌘F to expand and focus search without inserting F into the query. From cycling, this enters persistent Search mode and keeps the panel open after the invocation modifiers are released. Window-key assignments reserve ⌘F for search. Close Search clears the query and restores the previous mode while keeping scope and display filters. Search Select mode opens with its full-width search field focused, ready for typing.

In Direct Keys mode, Tab selects the next window and Shift-Tab selects the previous one, wrapping within the current results. Return opens the selected window. Search editing and shortcut recording keep their own Tab behavior.

Switching between grid and list keeps the selected window and visible shortcut numbers in sync, including after scrolling or filtering. Scrollbars hide when all results fit, and the grid stays clear of overlaid navigation buttons.

Editing a direct shortcut highlights its key and shows a concise prompt beside Direct Keys, with Cancel at the far right. Recording instructions and feedback are available in all 11 supported languages.

Command Palette searching window actions, settings, and plugins in English

A toolbox for everyday work

Area What you can do
Capture & clipboard Annotate screenshots, use OCR and QR recognition, pin images, capture scrolling content, and record a region. Keep encrypted local clipboard history, snippets, and paste queues, with a default clipboard content limit of 30 MB per item.
Windows & workspace Switch and arrange windows, launch apps, manage Stage Manager, and customize Finder's right-click menu.
Keyboard, mouse & trackpad Remap inputs, assign gestures and app shortcuts, tune scrolling, add middle-click, and type text with Auto Input.
Displays & appearance Adjust brightness and resolution, connect Sidecar, toggle True Tone and Night Shift, hide the notch, and organize menu bar icons and the Dock.
Audio & power Control system, microphone, app, and display volume; keep the Mac awake; manage fans and charging limits; lock, sleep, or shut down.
Monitoring & calendar Follow system performance, device batteries, activity statistics, AI usage, and network status. Check your calendar and upcoming events.
Cleanup & maintenance Explore disk usage visually, review large files and folders before moving them to Trash, clean disk and Xcode files, manage Homebrew and login items, eject disks, empty Trash, quit apps, repair quarantined apps, soft-restart macOS, and use physical Clean Mode.
Utilities & configuration Translate selected text, upload to Cloudflare R2, edit zsh files, open Siri, and save reusable Mac Settings profiles.

Clipboard History moves reused items to the front when you copy or paste them from the plugin, including item shortcuts and snippets. Browsing leaves the order unchanged, and sequential paste queues keep their established order. History expires after the configured period of inactivity, measured from its latest use or capture. Count and storage limits apply separately; Saved items and snippets remain available.

Clipboard history defaults to a 512 MB content capacity, with 64 MB, 256 MB, 512 MB, 1 GB, and 5 GB options. Existing saved capacity settings are preserved.

Clipboard opens on the display under the pointer and remembers each display's window position after dragging the title bar or top handle. Automatic repositioning when displays change preserves those saved positions.

Window Switcher, Command Palette, Clipboard History, and clipboard actions share compact search headers with soft gray fields. Existing close controls use borderless icons; each panel keeps its original controls. Hover and focus feedback stay subtle; Increase Contrast restores visible boundaries.

The clipboard panel and action menu use neutral system gray selections. Native action buttons have matching heights and subtle hover feedback, with an icon-only More button. List titles use regular weight while detail headings remain emphasized.

Clipboard selection and scrolling respond immediately. Rapid navigation skips transient preview requests, and recent image and rich-text previews are reused within bounded caches. Large rich-text items use their saved text summaries for preview.

Screenshots work on macOS 14+; region recording and per-app volume require macOS 15+. Hardware controls depend on device support. See the feature guides for details.

Screenshot selection remains available on each display after switching desktops or entering and leaving full-screen apps.

Take your setup with you: export and import preferences, keep local backups, or sync supported settings through a cloud or shared folder. The app supports 11 languages and follows your system language by default.

mactools in your terminal

Discover actions, check availability, and run supported actions from scripts or local AI agents, with JSON output, timeouts, and cancellation.

The CLI is currently an experimental Nightly feature on Apple silicon. Install it from Settings → General → Command Line in a supported Nightly build, then enable integration. The Nightly command is mactools-nightly; ordinary stable releases do not yet offer managed CLI installation.

mactools-nightly doctor --json
mactools-nightly actions list --json

Use actions describe <id> and actions availability <id> to inspect an ID returned by the list, then actions run <id> to execute it. Execution is limited to eligible, safe, background, automatic, portable, parameterless actions; typed parameters and saved presets are not yet supported.

CLI installation · AI-agent usage · URL API

Contribute

Bug reports, translations, plugin ideas, and pull requests are welcome. Start with CONTRIBUTING.md for the Swift 6 / SwiftUI / AppKit development setup, or the plugin development guide to build a plugin.

MacTools contributors

Privacy & license

Local-first, with no maintainer-operated analytics or advertising. Network-dependent features and system permissions are explained in the Privacy Policy.

GPL-3.0-only. See licensing scope and third-party notices for dependencies, artwork, and acknowledgments.

Featured on HelloGitHub

About

A free and open-source collection of native macOS menu bar tools.

Topics

Resources

Contributing

Stars

1.2k stars

Watchers

6 watching

Forks

Releases

Packages

Contributors

Languages