Skip to content
wflixuPublic

About

macos finder contextmenu

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

1.2k stars

Watchers

5 watching

Forks

RClick

Swift 6.2 SwiftUI macOS 15.6+ Xcode 26+ License GitHub release GitHub downloads

Enhance your macOS Finder context menu with custom actions. Built with Swift 6.2 and SwiftUI for macOS 15.6+. Full dark mode support with adaptive icons.

πŸš€ Features

  • Open with External App β€” Open files or directories with any installed application, with support for custom arguments and environment variables. Ships with presets for popular editors, terminals and IDEs, per-app visibility for the toolbar and context menus, and none/simple/original icon styles.
  • Copy Path / File Name β€” Copy the full paths or just the file names of all selected items to the clipboard, one per line.
  • Delete Direct β€” Delete files or folders directly, bypassing Trash. RClick asks for confirmation first; hold Option while choosing the action to skip it.
  • Hide / Unhide β€” Toggle file visibility in Finder.
  • AirDrop β€” Share files instantly via AirDrop.
  • Create New Files β€” Generate new files from templates directly in Finder. Supports .txt, .json, .md, .docx, .pptx, .xlsx, as well as Apple iWork formats: .pages, .key, .numbers.
  • Quick Access Folders β€” Pin frequently used directories to the right-click menu.
  • Terminal-aware Opening β€” Terminal presets hand the containing folder to the app by default, with an automatic/on/off override per app.
  • Dark Mode β€” Full light/dark appearance support with adaptive icons and SF Symbols.

πŸ“± More Apps

If RClick is useful to you, here are two other apps I maintain:

App What it does Download
iMonet icon iMonet A mouse-first image viewer for macOS. Zoom follows your cursor, with native animated GIF, APNG and WebP playback. Mac App Store
LiveCam icon LiveCam Show your avatar while recording your screen or live streaming, with configurable size, border and shape. Mac App Store

πŸ— Architecture

RClick uses a dual-process architecture:

Component Description
Main App (RClick/) SwiftUI menu bar app β€” manages settings, state, and file operations
FinderSync Extension (FinderSyncExt/) Injected into Finder β€” renders custom context menu items

Communication between the two processes uses DistributedNotificationCenter. Settings are persisted via SwiftData with a shared App Group container.

πŸ“Έ Screenshots

πŸ“¦ Installation

Download

Get the latest release from the Releases page.

Download the .dmg, open it, and drag RClick to your Applications folder.

Note: On first launch, you may need to enable the Finder extension in System Settings β†’ Privacy & Security β†’ Extensions β†’ Added Extensions.

Build from Source

git clone https://github.com/wflixu/RClick.git
cd RClick
open RClick.xcodeproj
  • Requires Xcode 26+ and macOS 15.6+
  • Select the RClick scheme, then Product β†’ Build (⌘B)
  • The FinderSync extension will be automatically registered

Requirements

Requirement Details
Folder Access Per-folder authorization for file operations (prompted automatically)
Accessibility Required for certain automation features
Finder Extension Must be enabled in System Settings

πŸ”§ Development

# Build
xcodebuild -project RClick.xcodeproj -scheme RClick -destination 'platform=macOS'

# Build for Release
xcodebuild -project RClick.xcodeproj -scheme RClick -configuration Release

Key Technologies

  • Swift 6.2 with full concurrency checking
  • SwiftUI for all UI components
  • AppKit for system integration only (NSWorkspace, NSPasteboard)
  • SwiftData for persistence with shared container
  • FinderSync framework for Finder extension
  • DistributedNotificationCenter for IPC

🌐 Localization

RClick supports five languages with the following priority:

Language Code Notes
English en Default/base language
Simplified Chinese zh-Hans Primary localization target
Japanese ja Activated when system language is Japanese
Spanish es Activated when system language is Spanish
French fr Activated when system language is French

Principles:

  • Default language is English (also the fallback for unsupported system languages)
  • All string keys are in English in the code, localized via Localizable.xcstrings
  • System language is auto-detected β€” no manual language picker in the app
  • To add a new language, add an entry to Localizable.xcstrings and register it in the Xcode project

πŸ‘₯ Contributors

Thanks to all the people who have contributed to RClick!

Recent contributions:

  • @SonneFish β€” built-in app presets, per-app visibility and icon styles (#168); Finder icon-cache and heartbeat performance (#167); permission status refresh (#169); quiet offline relaunch and settings reopen (#170)
  • @Consciencieux β€” confirmation before Direct Delete (#163)
  • @Juns-g β€” watching mounted volumes so external and network drives show the menu (#152)
  • @Dam0rt β€” French localization (#149)
  • @stors789 β€” App Groups provisioning in the release pipeline (#141)
  • @EliasMatDev β€” Latin American Spanish localization (#138)
  • @shoal-rat β€” Finder observation fix, so the menu appears in every folder (#126)
  • @P013onEr β€” string catalogs and trilingual localization (#120), draggable menu ordering (#121)
  • @chunyang-wen β€” removed a needless await (#21)

Similar Projects

🀝 Contributing

We welcome contributions! Here's how you can help:

Please read our Code of Conduct before participating.

About

macos finder contextmenu

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

1.2k stars

Watchers

5 watching

Forks

Releases

Packages

Used by

Contributors

Languages