gitwtfhub

wtf is maclocksmith?

sidsharths1245/maclocksmith — explained in plain English

Analysis updated 2026-05-18

2SwiftAudience · generalComplexity · 1/5Setup · easy

TL;DR

A macOS Finder extension that finds and force quits whatever process is locking a stuck file, right from the right click menu.

Mindmap

mindmap
  root((MacLocksmith))
    What it does
      Finds locking process
      Force quits it
      Adds Finder menu item
    Tech stack
      Swift
      macOS
    Use cases
      Fix file in use errors
      Identify blocking PID
      Free stuck files
    Audience
      Mac users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Free a file stuck with a file in use error without opening Activity Monitor.

REASON 2

See exactly which process and PID is holding a file lock.

REASON 3

Force quit the blocking app with one click from Finder.

What's in the stack?

SwiftmacOS

How it stacks up

sidsharths1245/maclocksmitharpitbhalla/swift-appjangles-byte/ramble
Stars222
LanguageSwiftSwiftSwift
Last pushed2022-12-19
MaintenanceDormant
Setup difficultyeasyhardeasy
Complexity1/52/52/5
Audiencegeneraldevelopervibe coder

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 5min

Unsigned app, so Gatekeeper requires a manual right click Open the first time.

No license information is given in the README.

Wtf does this do

MacLocksmith is a small macOS Finder extension built to solve the annoying file in use error, where the Finder or an app refuses to open, move, or delete a file because something else is quietly holding a lock on it. Rather than making you hunt through Activity Monitor, MacLocksmith adds an Unlock File option directly to the Finder's right click menu. When you right click a stuck file and choose that option, the tool uses the lsof command under the hood to find exactly which running process is holding the lock, then shows you that process and its ID in a small window. From there, clicking the Force Kill Process button terminates that process immediately, which frees the file so you can finish whatever you were trying to do with it. There is also an optional auto quit setting so the utility closes itself right after a successful kill instead of staying open. Installation means downloading the MacLocksmith disk image from the project's releases page, dragging the app into Applications, launching it once so macOS registers the Finder extension, then turning the extension on in System Settings under Extensions. Because the app is not signed by Apple, Gatekeeper will ask for manual approval the first time you open it, which you do by right clicking the app and choosing Open rather than double clicking it. Developers who want to build it themselves can clone the repository, open the Xcode project, switch the build configuration to Release, and build it directly, with the finished app appearing in the project's build folder. This is a lightweight, single purpose utility rather than a full file management suite.

Yoink these prompts

Prompt 1
Walk me through installing this Finder extension and enabling it in System Settings.
Prompt 2
Explain what lsof is doing behind the scenes when I unlock a file.
Prompt 3
Help me build this project from source in Xcode.
Prompt 4
What should I do if Gatekeeper blocks this unsigned app from opening?

Frequently asked questions

wtf is maclocksmith?

A macOS Finder extension that finds and force quits whatever process is locking a stuck file, right from the right click menu.

What language is maclocksmith written in?

Mainly Swift. The stack also includes Swift, macOS.

What license does maclocksmith use?

No license information is given in the README.

How hard is maclocksmith to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is maclocksmith for?

Mainly general.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.