TotalFinder with System Integrity Protection

TotalFinder has support for macOS 10.11 (El Capitan) and macOS 10.12 (Sierra), but cannot be installed on a normally configured machine due to System Integrity Protection (SIP).

This article will tell you how to configure your machine to allow installation by modifying the SIP setting temporarily.

If you decide to modify the settings, you will be able to install TotalFinder. Just to be clear...

Your machine may be less secure when System Integrity Protection is not running. It is entirely your decision to modify the settings.

How to install TotalFinder by turning off System Integrity Protection

We now recommend turning off SIP to install TotalFinder, and to turn it back on again after it has been installed.

TotalFinder will guide you through the process via notification dialogs. Please check the TotalFinder installation page for general installation steps. This document explains SIP-specific steps.

You must boot into the Recovery OS. You do this by restarting your machine, and holding Command+R until the Apple logo appears. Then select Terminal from the Utilities menu. It looks like this:

In the window that opens, type csrutil disable and press return. This turns off System Integrity Protection so that TotalFinder can be installed.

Reboot your machine and you may install and run the latest version of TotalFinder.

Once TotalFinder is installed and you have run it for the first time (so it has a chance to install its plugin component), then you may turn SIP back on.

To do this, reboot and hold Command+R until the Apple logo appears once more. Go to Utilities->Terminal and type csrutil enable and press return. Reboot, and you are done.

Technical details

TotalFinder works by altering the built-in system application

In order to change some features of Finder, we use a technique called code injection. This means we add some additional code to the Finder program whilst it is running to do what we need. This is relatively safe - in fact we do not change any part of macOS on the disk. You only have to quit Finder via Command+Option+Esc, and the Finder will restart and everything will be as if TotalFinder was never running.

However, in El Capitan and later the macOS developers added a feature that disallows this kind of modification even if you have administrator access. It will also disallow other kinds of modifications (such as replacing parts of the system on disk).

In order for TotalFinder to be installed, this new feature must be disabled. When you disable SIP and run TotalFinder, it installs its plugin component in the location /System/Library/ScriptingAdditions. This component usually does not change between TotalFinder versions, and even when you turn SIP back on it will continue to allow TotalFinder to load.

Uninstallation and SIP

To remove TotalFinder from your system, run the uninstaller found on the [latest dmg download of TotalFinder(/changes-beta).

Note that if you have SIP turned on, then the uninstaller will not be able to remove the file in /System/Library/ScriptingAdditions. This is not harmful (it won't ever be loaded if you do not run TotalFinder), but to be totally clean you should disable SIP and either manually remove it, or run the uninstaller again.

Further information

You can find some further information in our blog post.