{"id":13717617,"url":"https://github.com/ultimate-deej/Sculpt-Comfort-Mission-Control","last_synced_at":"2025-05-07T07:31:48.611Z","repository":{"id":34895395,"uuid":"38925007","full_name":"ultimate-deej/Sculpt-Comfort-Mission-Control","owner":"ultimate-deej","description":"Switch desktops on your Mac with any mouse","archived":false,"fork":false,"pushed_at":"2020-06-03T15:20:55.000Z","size":137,"stargazers_count":116,"open_issues_count":1,"forks_count":8,"subscribers_count":15,"default_branch":"2.x","last_synced_at":"2024-08-04T00:13:45.792Z","etag":null,"topics":["expose","high-sierra","highsierra","macos","macosx","mission-control","mouse","osx","sierra","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/ultimate-deej.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-07-11T12:29:47.000Z","updated_at":"2023-06-10T13:37:04.000Z","dependencies_parsed_at":"2022-08-26T08:01:23.497Z","dependency_job_id":null,"html_url":"https://github.com/ultimate-deej/Sculpt-Comfort-Mission-Control","commit_stats":null,"previous_names":[],"tags_count":10,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ultimate-deej%2FSculpt-Comfort-Mission-Control","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ultimate-deej%2FSculpt-Comfort-Mission-Control/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ultimate-deej%2FSculpt-Comfort-Mission-Control/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ultimate-deej%2FSculpt-Comfort-Mission-Control/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ultimate-deej","download_url":"https://codeload.github.com/ultimate-deej/Sculpt-Comfort-Mission-Control/tar.gz/refs/heads/2.x","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224573503,"owners_count":17333804,"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","high-sierra","highsierra","macos","macosx","mission-control","mouse","osx","sierra","spaces"],"created_at":"2024-08-03T00:01:24.858Z","updated_at":"2024-11-14T05:32:13.697Z","avatar_url":"https://github.com/ultimate-deej.png","language":"Objective-C","funding_links":[],"categories":["Objective-C"],"sub_categories":[],"readme":"# What is it?\nIt's an app that lets you switch between virtual desktops on your Mac. With a mouse! And not only with Sculpt Comfort, any mouse will do. But you really want a mouse with at least two additional buttons.\n\n# Note for Catalina users\nSince SCMC doesn't support Catalina at the moment, you might want to use a solution by [@ephemient](//github.com/ephemient). See [this](//github.com/ultimate-deej/Sculpt-Comfort-Mission-Control/issues/20#issuecomment-638209672) comment.\n\n# Important 10.14 Mojave information\nDue to security enhancements in Mojave, it's not currently possible to use SCMC with SIP enabled. You must keep it disabled to continue using this app.\n\n# Installation\n1. Install Loader. This is probably a one-time setup as this component is unlikely to change soon.\n\t1. Disable SIP\n\t2. Copy `SCMC Loader.osax` to `/System/Library/ScriptingAdditions`\n\t3. *[pre-10.14 only]* Enable SIP\n2. Install a config (see [Configuration folder](/Configuration))\n3. Run `Sculpt Comfort Mission Control.app`\n\n# Contributing\n**Contributions are highly welcomed.** You can help the project by:\n- Adding more details to readme\n- Fixing typos, grammar and spelling mistakes etc.\n- Code contributions. Take a thorough approach here. The best way to make a code contribution is to discuss the idea before actually starting to code.\n- **Tell me if it works with your mouse**. Just:\n  1. Either create a pull request. It should contain a config and an update to the readme.\n  2. Or create an issue. I will then add a config to the repo, and the model name to the readme.\n\nWhile the above are direct contributions, there are other ways to help the project:\n- Star this repo ⭐. It really motivates me to continue improving the app!\n- Tell a friend\n\n# Which macOS versions are supported?\n10.12+. Support for earlier versions is dropped.\n\n# Which mice are supported?\nAs stated earlier, the app should be able to work with any mouse, there are no artificial restrictions to this. However, here's the list of tested models:\n- Microsoft Sculpt Comfort Mouse (of course)\n- Microsoft Sculpt Ergonomic Mouse (a config is missing though, contact me and we'll make one)\n- A 5-button No Name mouse\n\n# What happened here, an update?\nThis is version 2, a complete rewrite of the app.\n\nAlthough it's a minimal working release which lacks some important features, it can already do everything v1 can but better! To be specific, you will benefit from moving to v2 because:\n\n- You don't need `lldb` and developer tools\n- Because of the above, it starts much faster. You won't even notice\n- You only need to disable SIP for an initial installation\n- If the app handles a mouse event, other apps don't receive it anymore (with a proper config). With the previous version, it happened for some button configurations. No more unwanted navigation in browsers or wherever else.\n\n# Have questions?\nRead the issues. Or submit one.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fultimate-deej%2FSculpt-Comfort-Mission-Control","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fultimate-deej%2FSculpt-Comfort-Mission-Control","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fultimate-deej%2FSculpt-Comfort-Mission-Control/lists"}