Skip to content
D44NFPublic

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

25 Commits

Folders and files

Repository files navigation

MaClick logo

MaClick

The Windows-style right-click menu macOS Finder never had —
fully custom, down to which action shows where.

Install · Features · Customization · How it works · Build it yourself · Privacy · License

macOS 12 and newer Swift 5.9 License GPL 3.0 or later

MaClick's settings window, listing every action with a toggle, drag handle, and per-context chips

Right-click a file, a folder, or empty space in Finder and get a menu built from exactly the actions you picked — classic Finder actions like Get Info, Rename, Duplicate, and Move to Trash, alongside things Finder never offered: Copy Path, checksums, Open Terminal Here, Open in VS Code, and more. Every action can be switched on or off, reordered, and scoped to the contexts where it makes sense — a single file, a folder, multiple items, or empty space — all from one settings window.

Install

Grab the latest .dmg from Releases, open it, and drag MaClick into Applications.

MaClick isn't signed with a paid Apple Developer ID, so macOS will say it "cannot be opened because the developer cannot be verified" the first time you launch it. Right-click (or Control-click) MaClick in Applications, choose Open, then confirm — you only need to do this once per version. After updating to a new release, you'll likely need to repeat this (and re-grant Accessibility access in System Settings), since each build's signature changes without a paid developer account.

Want to build it yourself instead? See Building.

Everything it does

File & folder basics

  • New Text File Here / New Folder Here — create either right where you clicked.
  • New Folder with Selection — bundle the selected items into a new folder next to them.
  • Rename — jumps straight into Finder's own inline rename for the selected item.
  • Duplicate — a copy of the selection, in the same folder.
  • Move to Trash — moves the selection to the Trash.
  • Move to… — pick a destination folder and move the selection there.
  • Copy / Paste Items — copy a selection, paste it into another folder.
  • Make Alias — creates a Finder alias for the selection.

Info & organization

  • Get Info — opens Finder's own info window for the selection, or the current folder.
  • Tags — apply a color tag from a submenu, without leaving the menu.
  • Quick Look — preview the selection without opening it.
  • Share… — share the selection via AirDrop, Mail, Messages, and whatever else macOS offers.
  • Customise Folder… — opens Get Info, where you can drop on a custom folder icon.
  • Quick Actions — run an installed Automator Quick Action workflow on the selection, from its own submenu.

Opening things

  • Open / Open With — open with the default app, or pick one from a submenu of everything that can.
  • Open in New Tab — opens a selected folder in a new tab of the current window.
  • Open Terminal Here — opens Terminal in the clicked (or current) folder.
  • Open in Visual Studio Code — same, for VS Code.
  • Import from iPhone — opens Image Capture to bring in photos from a nearby iPhone or iPad.

Archives & checksums

  • Compress to ZIP / Extract ZIP — zip the selection, or unzip a single .zip.
  • Copy SHA-256 / MD5 Checksum — hashes a single file straight to the clipboard.

Window & view

  • View — switch the current window between icons, list, columns, or gallery.
  • Sort By — rearrange the current window's icons by name, kind, date, size, or label.
  • Clean Up — snap icons back to the grid.
  • Clean Up By — snap icons to the grid, arranged by name, kind, size, or date.
  • Use Groups — toggle grouping the current window's icons on or off.
  • Show View Options — opens Finder's own View Options panel.

Clipboard

  • Copy Path — copies the selection's (or current folder's) full path.

See Shared/Sources/Feature.swift for the definitive, always-current list.

Customize everything

Toggle any action on or off, drag to reorder, and decide exactly where each one shows up: a single file, a single folder, multiple selected items, empty space — any combination. Turn off "Copy Path" for empty-space clicks but keep it for files. Hide checksum actions everywhere except on single files. The defaults match how Finder behaves out of the box; nothing changes until you touch it.

MaClick's custom context menu for a selected file MaClick's custom context menu for an empty-space click

The same menu on a selected file, and on empty space — each action shows only where you told it to.

How it works

There's no public API for adding items to another app's contextual menu, so MaClick intercepts the right-click itself — via a CGEventTap, before Finder ever receives it — and shows its own menu at the same spot instead. If the click lands on an item that isn't already selected, MaClick reproduces Finder's own selection behavior with a synthetic click first (and leaves an existing multi-selection alone, exactly like a real right-click would). It's built the way Apple would build it otherwise: a native SwiftUI settings app, no private APIs, no process injection.

A FIFinderSync Finder Sync extension ships alongside it, ready for the day Apple fixes a platform bug that currently keeps that officially-sanctioned mechanism from running at all; a classic Services-menu fallback also exists for actual selections. Either way, the custom menu above is what you'll actually use day to day.

Building

Prebuilt .dmg downloads are available from Releases — this section is for building from source instead.

MaClick.xcodeproj is generated from project.yml with XcodeGen and isn't committed — a generated project file can bake in locally selected signing settings, which must never end up in this public repo.

Before the first build:

  1. Accept the Xcode license once, if you haven't already: sudo xcodebuild -license
  2. Copy Config/Local.xcconfig.sample to Config/Local.xcconfig and fill in your Apple Developer Team ID (Xcode → Settings → Accounts → your Apple ID → double-click your team; a free personal team works). This file is gitignored and is what makes signing survive regeneration — without it, Xcode resets the team every time and the build fails because the App Group entitlement has no team to provision against.
  3. Generate and open the project:
brew install xcodegen   # once
xcodegen generate
open MaClick.xcodeproj

Run xcodegen generate again any time project.yml or the source file layout changes (for example after pulling new commits).

Enabling the right-click menu

Finder Sync extensions are never launched directly, and the custom menu needs Accessibility access. After building and running MaClick.app once:

  1. Grant Accessibility access when prompted (System Settings → Privacy & Security → Accessibility).
  2. Right-click a file, folder, or empty space in a Finder window to see your enabled actions.

If you also want the dormant Finder Sync extension enabled for when Apple fixes it, turn it on under System Settings → General → Login Items & Extensions → Finder Extensions.

Privacy

MaClick is local-first: no account, no analytics, no telemetry, no network access at all. Reading your selection, moving files, computing a checksum, opening another app — all of it happens on your Mac, through AppleScript calls to Finder or direct file operations.

Accessibility access is what makes the custom menu possible at all (intercepting Finder's right-click requires it), and it's a broad permission: in principle it lets any app watch and simulate input system-wide, not just within Finder. MaClick only uses it the way this README describes, and the app isn't sandboxed — this is a meaningful amount of trust to grant, worth knowing before you flip that switch in System Settings.

License

GPL 3.0 or later, copyright © 2026 Daan Fenske.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages