Skip to content

wflixu/RClick

Repository files navigation

RClick

Swift 6.2 SwiftUI macOS 15.6+ Xcode 16.4+

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.
  • Copy Path — Copy the full path of selected files or folders to clipboard.
  • Delete Directly — Delete files or folders directly, bypassing Trash.
  • 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.
  • Dark Mode — Full light/dark appearance support with adaptive icons and SF Symbols.

🏗 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 16.4+ and macOS 15.6+
  • Select the RClick scheme, then Product → Build (⌘B)
  • The FinderSync extension will be automatically registered

Requirements

Requirement Details
Full Disk Access Required for file operations in protected directories
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

Similar Projects

🤝 Report Issue

Found a bug or have a suggestion? Open an issue.

Packages

 
 
 

Contributors

Languages