Skip to content

Commit

Permalink
Update README.md with Apple Silicon install instructions and uninstal…
Browse files Browse the repository at this point in the history
…lation instructions.

Adapted from Issue #75 - #75 (comment).
  • Loading branch information
dado3212 authored Oct 14, 2023
1 parent e2aa610 commit 1906a30
Showing 1 changed file with 37 additions and 0 deletions.
37 changes: 37 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,6 +29,9 @@ I want to be able to rename my spaces. While TotalSpaces has this functionality
This is a SIMBL plugin and an application. The SIMBL plugin handles renaming spaces from a saved plist. The application adds an icon to the status bar that allows you to rename the spaces and update the plist.

## Installation:
> [!WARNING]
> This will not work for M1/M2/Apple Silicon Macs. Please scroll down to separate install instructions.
<ol>
<li>Download <a href="https://www.macenhance.com/macforge?macforge://github.com/w0lfschild/macplugins/raw/master/com.alexbeals.SpacesRenamer">MacForge</a>, the newest incarnation of mySIMBL.
<ul><li>If it's not compatible, you can download the <a href="https://github.com/w0lfschild/mySIMBL/releases/latest">latest mySIMBL version</a>.</li></ul>
Expand Down Expand Up @@ -56,6 +59,40 @@ This is a SIMBL plugin and an application. The SIMBL plugin handles renaming sp
</li>
</ol>

## Installation (M1/M2/Apple Silicon)

> [!NOTE]
> While this has been stable for months, it relies on a beta version of MacForge, so there may be compatibility issues with other plugins.
1. Fully uninstall any current versions of MacForge. This means making sure that MacForgeHelper is quit, the application is deleted, and the Trash is emptied.
2. Run some commands to clean up some of the lingering folders. **❗️THIS WILL DELETE ANY INSTALLED PLUGINS❗️**.
```
sudo launchctl unload /Library/LaunchDaemons/com.macenhance.MacForge.Injector.plist
sudo rm -rf "/Library/Application Support/MacEnhance"
sudo rm /Library/LaunchDaemons/com.macenhance.MacForge.Injector.plist
sudo rm /Library/PrivilegedHelperTools/com.macenhance.MacForge.Injector
```
3. Download this zip file ([spaces-renamer.zip](https://github.com/dado3212/spaces-renamer/files/9235969/spaces-renamer.zip)). It contains the SpacesRenamer app, spaces-renamer.bundle (1.10.4), and MacForge (a *very* unofficial 1.2.0 Beta 2).
4. Open SpacesRenamer. Accept the option to move it to /Applications. It should be automatically added to your Login Items, but you can check to confirm by going to "System Preferences" > "Users & Groups" > "Login Items" and adding it manually if necessary.
5. Open MacForge, which will copy itself to /Applications. Go through all the install instructions and permssions around `csrutil` by disabling SIP (use the command <code>csrutil disable</code> in Recovery mode by <a href="https://www.imore.com/how-turn-system-integrity-protection-macos">following this tutorial</a>). There are additional commands for macOS Catalina, with details under the 'System' tab of MacForge. After it's installed you can partially re-enable SIP using <code>csrutil enable --without debug --without fs --without nvram --without kext</code> (thanks to @serkanozkul <a href="https://github.com/dado3212/spaces-renamer/issues/75#issuecomment-1493355618">here</a>). If you fully enable SIP, Spaces Renamer won't work.
6. Copy the `spaces-renamer.bundle` version to `/Library/Application Support/MacEnhance/Plugins` and run `killall -9 Dock`.
7. Open the 'Spaces Renamer' icon in the top bar and click 'Update Names' (doesn't matter what's in there). Otherwise the top bar may not appear!

## Uninstall

You can trivially uninstall SpacesRenamer by using MacForge to delete the plugin and dragging the app to the Trash. If you want to fully remove MacForge and SpacesRenamer you can do the following:
1. Fully uninstall MacForge. Quit MacForgeHelper in 'Activity Monitor', and delete the application.
2. Delete the SpacesRenamer app by dragging it to the Trash.
3. Empty the Trash.
4. Run the following commands. This will delete all installed plugins.
```
sudo launchctl unload /Library/LaunchDaemons/com.macenhance.MacForge.Injector.plist
sudo rm -rf "/Library/Application Support/MacEnhance"
sudo rm /Library/LaunchDaemons/com.macenhance.MacForge.Injector.plist
sudo rm /Library/PrivilegedHelperTools/com.macenhance.MacForge.Injector
sudo rm -rf ~/Library/Containers/com.alexbeals.spacesrenamer
```

---

Donations [are always appreciated](https://www.paypal.com/paypalme2/AlexBeals), but in no way expected.

2 comments on commit 1906a30

@trentbrew
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you for adding apple silicon support ❤️

@zs153fd
Copy link

@zs153fd zs153fd commented on 1906a30 Apr 7, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hi there, this has been working perfectly for me on Sonoma 14.3.1 on Apple M3 Pro, but since I updated the system to Sonoma 14.4.1, it is no longer working. I tried to uninstall everything completely and reinstall, but it is still not working. Everything looks fine in MacForge, but Space Renamer is not working properly. Any advice? See the attached screenshots.
Space Renamer not working on Sonoma 14 4 1_Apple M3 Pro

Please sign in to comment.