https://github.com/dado3212/spaces-renamer
💻 Ability to rename desktop spaces on macOS 10.10+
https://github.com/dado3212/spaces-renamer
expose macforge macforge-plugin macos mission-control osx simbl simbl-plugin spaces
Last synced: about 1 month ago
JSON representation
💻 Ability to rename desktop spaces on macOS 10.10+
- Host: GitHub
- URL: https://github.com/dado3212/spaces-renamer
- Owner: dado3212
- License: mit
- Created: 2017-10-17T20:09:16.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2024-08-24T05:38:11.000Z (8 months ago)
- Last Synced: 2024-08-25T03:34:32.870Z (8 months ago)
- Topics: expose, macforge, macforge-plugin, macos, mission-control, osx, simbl, simbl-plugin, spaces
- Language: Objective-C
- Homepage:
- Size: 84.3 MB
- Stars: 1,025
- Watchers: 35
- Forks: 29
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- stars - dado3212/spaces-renamer
- Mac-Menubar-Megalist - Spaces Renamer
README
Spaces Renamer
Spaces Renamer is a combination of an application and SIMBL plugin to allow you to rename your spaces.
The compressed view after pressing F3
The expanded view after hovering
The interface for renaming the spaces
Spaces Renamer supports multiple monitors, and highlights the current space in each monitor with an outline. Here it is [in a video](https://vimeo.com/264878100) if you want to see it in action.
### The Problem
I want to be able to rename my spaces. While TotalSpaces has this functionality, it's not free, and it has a bunch of other features that I'm not really interested in.
### The Solution
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, and may not work for macOS 14.4+. Please scroll down to separate install instructions.
- Download MacForge, the newest incarnation of mySIMBL.
- If it's not compatible, you can download the latest mySIMBL version.
-
Make sure that it's installed, including disabling SIP (use the command csrutil disable in Recovery mode by following this tutorial). 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 csrutil enable --without debug --without fs. If you fully enable SIP, Spaces Renamer won't work.
-
Download Spaces Renamer.
-
Unzip the downloaded .zip file.
-
Open spaces-renamer.bundle with MacForge.app, or simply drag and drop it in to install it.
-
Run killall -9 Dock in Terminal to restart the Dock application.
-
Run the application '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.
-
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!
## 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/user-attachments/files/16735430/spaces-renamer.zip)). It contains the SpacesRenamer app, spaces-renamer.bundle (1.11.1), and MacForge (an unofficial 1.2.0 Beta 2). **If you're on version macOS 14.4+** you should use [spaces-renamer.zip](https://github.com/user-attachments/files/16735431/spaces-renamer.zip)
instead, which has MacForge 1.2.2 (3) and should work. You can also try this on non-M1/M2/Apple Silicon Macs.
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 csrutil disable in Recovery mode by following this tutorial). 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 csrutil enable --without debug --without fs --without nvram --without kext (thanks to @serkanozkul here). 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
```
### Debugging Common Issues
**MacForge is automatically downgrading**
If you are running into issues where MacForge is downgrading, try uninstall MacForge by deleting the app and emptying Trash, running the `purge.sh` file, restarting your computer, and then installing MacForge again. Make sure when you install you disable automatic upgrading and checks.
**I can't see the icon in the menu bar**
Make sure the SpacesRenamer app is actually running (you can check it in Activity Monitor). If it is, it's likely that you just have a lot of icons. See [this comment](https://github.com/dado3212/spaces-renamer/issues/94#issuecomment-2126843231) for some recommendations on how to rearrange your icons to have it be visible.
---
Donations [are always appreciated](https://www.paypal.com/paypalme2/AlexBeals), but in no way expected.