{"id":13441387,"url":"https://github.com/dado3212/spaces-renamer","last_synced_at":"2025-03-20T12:30:27.483Z","repository":{"id":43393906,"uuid":"107318499","full_name":"dado3212/spaces-renamer","owner":"dado3212","description":"💻 Ability to rename desktop spaces on macOS 10.10+","archived":false,"fork":false,"pushed_at":"2024-08-24T05:38:11.000Z","size":88348,"stargazers_count":1025,"open_issues_count":4,"forks_count":29,"subscribers_count":35,"default_branch":"master","last_synced_at":"2024-08-25T03:34:32.870Z","etag":null,"topics":["expose","macforge","macforge-plugin","macos","mission-control","osx","simbl","simbl-plugin","spaces"],"latest_commit_sha":null,"homepage":"","language":"Objective-C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dado3212.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"custom":["https://www.paypal.me/AlexBeals"]}},"created_at":"2017-10-17T20:09:16.000Z","updated_at":"2024-08-25T03:23:55.000Z","dependencies_parsed_at":"2023-10-15T17:10:02.732Z","dependency_job_id":"b0af38f2-0265-4243-bdd8-e307aa62f5aa","html_url":"https://github.com/dado3212/spaces-renamer","commit_stats":null,"previous_names":[],"tags_count":16,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dado3212%2Fspaces-renamer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dado3212%2Fspaces-renamer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dado3212%2Fspaces-renamer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dado3212%2Fspaces-renamer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dado3212","download_url":"https://codeload.github.com/dado3212/spaces-renamer/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":221759963,"owners_count":16876325,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["expose","macforge","macforge-plugin","macos","mission-control","osx","simbl","simbl-plugin","spaces"],"created_at":"2024-07-31T03:01:33.369Z","updated_at":"2025-03-20T12:30:27.477Z","avatar_url":"https://github.com/dado3212.png","language":"Objective-C","funding_links":["https://www.paypal.me/AlexBeals","https://www.paypal.com/paypalme2/AlexBeals"],"categories":["HarmonyOS","Objective-C","Utilities"],"sub_categories":["Windows Manager","Settings"],"readme":"\u003ch1 align=\"center\"\u003e\n  \u003cimg src=\"/SpacesRenamer/Assets.xcassets/AppIcon.appiconset/Icon-1.png?raw=true\" width=\"20%\" alt=\"\"/\u003e\n  \u003cp align=\"center\"\u003eSpaces Renamer\u003c/p\u003e\n\u003c/h1\u003e\n\nSpaces Renamer is a combination of an application and SIMBL plugin to allow you to rename your spaces.\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"smallView.jpg\" height=\"45\" \u003e\u003cbr\u003e\n  \u003ci\u003eThe compressed view after pressing F3\u003c/i\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"largeView.jpg\" height=\"80\" \u003e\u003cbr\u003e\n  \u003ci\u003eThe expanded view after hovering\u003c/i\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"renameView.jpg\" height=\"100\" \u003e\u003cbr\u003e\n  \u003ci\u003eThe interface for renaming the spaces\u003c/i\u003e\n\u003c/p\u003e\n\nSpaces 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.\n\n### The Problem\nI 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.\n\n### The Solution\nThis 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.\n\n## Installation:\n\u003e [!WARNING]  \n\u003e 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.\n\n\u003col\u003e\n  \u003cli\u003eDownload \u003ca href=\"https://www.macenhance.com/macforge?macforge://github.com/w0lfschild/macplugins/raw/master/com.alexbeals.SpacesRenamer\"\u003eMacForge\u003c/a\u003e, the newest incarnation of mySIMBL.\n    \u003cul\u003e\u003cli\u003eIf it's not compatible, you can download the \u003ca href=\"https://github.com/w0lfschild/mySIMBL/releases/latest\"\u003elatest mySIMBL version\u003c/a\u003e.\u003c/li\u003e\u003c/ul\u003e\n  \u003c/li\u003e\n  \u003cli\u003e\n    Make sure that it's installed, including disabling SIP (use the command \u003ccode\u003ecsrutil disable\u003c/code\u003e in Recovery mode by \u003ca href=\"https://www.imore.com/how-turn-system-integrity-protection-macos\"\u003efollowing this tutorial\u003c/a\u003e).  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 \u003ccode\u003ecsrutil enable --without debug --without fs\u003c/code\u003e. If you fully enable SIP, Spaces Renamer won't work.\n  \u003c/li\u003e\n  \u003cli\u003e\n    Download \u003ca href=\"https://github.com/dado3212/spaces-renamer/raw/master/build/spaces-renamer.zip\"\u003eSpaces Renamer\u003c/a\u003e.\n  \u003c/li\u003e\n  \u003cli\u003e\n    Unzip the downloaded .zip file.\n  \u003c/li\u003e\n  \u003cli\u003e\n    Open \u003ccode\u003espaces-renamer.bundle\u003c/code\u003e with \u003ccode\u003eMacForge.app\u003c/code\u003e, or simply drag and drop it in to install it.\n  \u003c/li\u003e\n  \u003cli\u003e\n    Run \u003ccode\u003ekillall -9 Dock\u003c/code\u003e in Terminal to restart the Dock application.\n  \u003c/li\u003e\n  \u003cli\u003e\n    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\" \u003e \"Users \u0026 Groups\" \u003e \"Login Items\" and adding it manually if necessary.\n  \u003c/li\u003e\n  \u003cli\u003e\n    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!\n  \u003c/li\u003e\n  \u003c/ol\u003e\n\n## Installation (M1/M2/Apple Silicon)\n\n\u003e [!NOTE]  \n\u003e While this has been stable for months, it relies on a beta version of MacForge, so there may be compatibility issues with other plugins.\n\n1. Fully uninstall any current versions of MacForge. This means making sure that MacForgeHelper is quit, the application is deleted, and the Trash is emptied.\n2. Run some commands to clean up some of the lingering folders. **❗️THIS WILL DELETE ANY INSTALLED PLUGINS❗️**.\n```\nsudo launchctl unload /Library/LaunchDaemons/com.macenhance.MacForge.Injector.plist\nsudo rm -rf \"/Library/Application Support/MacEnhance\"\nsudo rm /Library/LaunchDaemons/com.macenhance.MacForge.Injector.plist\nsudo rm /Library/PrivilegedHelperTools/com.macenhance.MacForge.Injector\n```\n3. 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)\n instead, which has MacForge 1.2.2 (3) and should work. You can also try this on non-M1/M2/Apple Silicon Macs.\n4. 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\" \u003e \"Users \u0026 Groups\" \u003e \"Login Items\" and adding it manually if necessary.\n5. Open MacForge, which will copy itself to /Applications. Go through all the install instructions and permssions around `csrutil` by disabling SIP (use the command \u003ccode\u003ecsrutil disable\u003c/code\u003e in Recovery mode by \u003ca href=\"https://www.imore.com/how-turn-system-integrity-protection-macos\"\u003efollowing this tutorial\u003c/a\u003e).  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 \u003ccode\u003ecsrutil enable --without debug --without fs --without nvram --without kext\u003c/code\u003e (thanks to @serkanozkul \u003ca href=\"https://github.com/dado3212/spaces-renamer/issues/75#issuecomment-1493355618\"\u003ehere\u003c/a\u003e). If you fully enable SIP, Spaces Renamer won't work.\n6. Copy the `spaces-renamer.bundle` version to `/Library/Application Support/MacEnhance/Plugins` and run `killall -9 Dock`.\n7. 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!\n\n## Uninstall\n\nYou 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:\n1. Fully uninstall MacForge. Quit MacForgeHelper in 'Activity Monitor', and delete the application.\n2. Delete the SpacesRenamer app by dragging it to the Trash.\n3. Empty the Trash.\n4. Run the following commands. This will delete all installed plugins.\n```\nsudo launchctl unload /Library/LaunchDaemons/com.macenhance.MacForge.Injector.plist\nsudo rm -rf \"/Library/Application Support/MacEnhance\"\nsudo rm /Library/LaunchDaemons/com.macenhance.MacForge.Injector.plist\nsudo rm /Library/PrivilegedHelperTools/com.macenhance.MacForge.Injector\nsudo rm -rf ~/Library/Containers/com.alexbeals.spacesrenamer\n```\n\n### Debugging Common Issues\n\n**MacForge is automatically downgrading**  \nIf 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.\n\n**I can't see the icon in the menu bar**  \nMake 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.\n\n--- \n\nDonations [are always appreciated](https://www.paypal.com/paypalme2/AlexBeals), but in no way expected.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdado3212%2Fspaces-renamer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdado3212%2Fspaces-renamer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdado3212%2Fspaces-renamer/lists"}