Skip to content

Finder context menu automation for macOS. Run scripts on selected files with a right-click.

License

Notifications You must be signed in to change notification settings

sane-apps/SaneClick

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

34 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

SaneClick

50+ ready-to-use actions for your Finder right-click menu

SaneClick Main Window

πŸ”’ No spying Β· πŸ’΅ No subscription Β· πŸ› οΈ Actively maintained


The Problem

Every time you right-click in Finder, you're stuck with Apple's limited context menu. Want to convert an image? Open in Terminal? Run a quick script? You have to leave Finder, open another app, navigate back to your file, and do it manually.

Why Can't You Fix It Yourself?

macOS has Services and Folder Actions, but they require Automator knowledge or AppleScript expertise. Most people give up before they start.

Why Alternatives Fail You

The "easy" solutions cost $10-15, require subscriptions, or haven't been updated since 2019. Some are abandonware. Others are overkill.


The Sane Solution

SaneClick gives you 50+ ready-to-use actions β€” no scripting required. Browse by category, toggle on what you need, done.

  • Curated Library: 50+ pre-built actions organized by category
  • One-Click Install: Toggle actions on/off instantly
  • Smart Filtering: Actions appear only for matching file types
  • Custom Scripts: Power users can write Bash, AppleScript, or Automator workflows
  • Categories: Essentials, Files & Folders, Images & Media, Coding, Advanced

$5 for the signed DMG. Build from source for free. 100% local. We never see your data.


Features

Feature Description
50+ Pre-built Actions Copy paths, convert images, open in Terminal, and more
5 Categories Essentials, Files & Folders, Images & Media, Coding, Advanced
Smart Filtering Actions appear only for matching file types
One-Click Install Toggle actions on/off instantly
Custom Scripts Write Bash, AppleScript, or Automator workflows
Test Before Save Run scripts on files before committing
Import/Export Share scripts as JSON files

Requirements

  • macOS 14.0+
  • Apple Silicon (arm64) only
  • Xcode 16.0+ (for building from source)
  • XcodeGen (project generation; SaneMaster runs it for you)

Installation

Buy the DMG ($5)

Buy SaneClick β€” Signed, notarized, ready to use. Supports sustainable open source development. DMGs are hosted on Cloudflare (not attached to GitHub releases).

Build from Source (Free)

# Clone the repository
git clone https://github.com/sane-apps/SaneClick.git
cd SaneClick

# Build + test (preferred)
./scripts/SaneMaster.rb verify

# Launch
./scripts/SaneMaster.rb launch

SaneMaster runs XcodeGen when needed; only run xcodegen generate manually if you add files and want to refresh immediately.

Enable the Extension

  1. Open SaneClick
  2. Go to System Settings > Privacy & Security > Extensions > Finder
  3. Enable SaneClick

Usage

  1. Add Scripts: Click the + button and choose "New Script"
  2. Configure: Set name, type, content, and file filters
  3. Test: Use the Test button to try your script on files
  4. Organize: Create categories and assign scripts
  5. Use: Right-click files in Finder to see your scripts

Script Variables

Type Variables
Bash $1, $2, etc. for file paths, or $@ for all
AppleScript item 1 of argv to access paths
Automator File paths via standard input

Architecture

See ARCHITECTURE.md for the full system overview and state machines.

SaneClick/
β”œβ”€β”€ SaneClick/              # Host app (settings UI)
β”‚   β”œβ”€β”€ Models/              # Script, Category models
β”‚   β”œβ”€β”€ Services/            # ScriptExecutor, ScriptStore
β”‚   β”œβ”€β”€ Views/               # SwiftUI views
β”‚   └── Theme/               # Brand colors
β”œβ”€β”€ SaneClickExtension/     # Finder Sync Extension
β”‚   └── FinderSync.swift     # Context menu provider
β”œβ”€β”€ Tests/                   # Unit tests
└── docs/                    # Website

Our Promise

"For God has not given us a spirit of fear, but of power and of love and of a sound mind." β€” 2 Timothy 1:7

Pillar Meaning
⚑ Power Your data stays on your device. No cloud, no tracking.
❀️ Love Built to serve you. No dark patterns or manipulation.
🧠 Sound Mind Calm, focused design. Does one thing well.

Contributing

  1. Fork the repository
  2. Create a feature branch
  3. Make changes with tests
  4. Submit a pull request

See CONTRIBUTING.md for details.


License

GPL v3 β€” see LICENSE for details.


Part of the Sane Apps family.

About

Finder context menu automation for macOS. Run scripts on selected files with a right-click.

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Sponsor this project

 

Packages

No packages published

Contributors 2

  •  
  •  

Languages