Pervert

GUI for viewing MacOS service details
Explore the docs »

Report Bug · Request Feature

A GUI to explore MacOS processes and their configuration; largely a front-end for the built-in MacOS sfltool.

The motivation arose when I was troubleshooting an issue on my Mac caused by an errant 3rd-party application.

The application tended to corrupt the network stack, leaving my computer largely inoperable. Worse still, uninstalling the application didn't solve the problem: the application had installed a kernel network extension, and a persistent service which kept re-corrupting the network config.

Trying to figure this all out, and then fix it, was a nightmare. It turns out there are so many places and applications on a Mac where the configuration for such items reside:

• launchctl
• configd (scutil)
• Shared-File Lists (sfltool)
• homebrew
• /etc/
• ifconfig , route
• ...

The goal of this project is to (eventually) be:

(back to top)

(back to top)

1. Clone the repo

   git clone https://github.com/cunneen/pervert.git

2. Install NPM packages

   npm install

3. Run the app

   npm run start dev

In the future you'll be able to install and run the app:

• from the command line, e.g.:

  npx pervert

• from homebrew e.g.:

  brew install pervert

(back to top)

Coming soon...

(back to top)

• Nice display of sfltool dumpbtm output -- 80% complete
• UI to backup config
  • Automatically store incremental backups (optionally)
• UI to restore config
• UI to remove a configured service
• Nice top-level display of active services ( / agents / daemons etc)
  • as per Lingon Pro and LaunchControl
• Display cross-referenced service config with active services
• "Drill-down" into active service details
  • again, as per Lingon Pro and LaunchControl
• UI to display open files, ports and sockets
  • as per Sloth
• UI to display running processes
  • as per MacOS built-in Activity Monitor
• UI to Add / Load / Enable / Disable / Unload / Remove services via launchctl
• UI to create a new service
  • write a plist to ${HOME}/Library/LaunchAgents and load it via launchctl
• Nice display of configd state (via sctool)
• Manipulation of configd state (via sctool)
• UI display of installed packages
  • as per Cork, Applite
• UI front-end to install / update / remove Homebrew and App Store packages
  • as per Cork, Applite

See the open issues for a full list of proposed features (and known issues).

(back to top)

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

(back to top)

Distributed under the MPL-2.0 License. See LICENSE.md for more information.

(back to top)

These modules are used directly. Many thanks to the creators and maintainers:

• @vscode/sudo-prompt
• tanstack table

These applications are genuinely useful, and have inspired various aspects:

• Cork
• LaunchControl
• Lingon Pro
• Sloth

(back to top)