{"id":25830338,"url":"https://github.com/tzxhy/mac-switch-workspace-by-mouse","last_synced_at":"2026-04-24T21:32:39.846Z","repository":{"id":279938657,"uuid":"940509203","full_name":"Tzxhy/mac-switch-workspace-by-mouse","owner":"Tzxhy","description":"just use a normal mouse to switch workspace on mac","archived":false,"fork":false,"pushed_at":"2025-02-28T10:09:00.000Z","size":11,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-28T16:44:43.824Z","etag":null,"topics":["macos","mouse","move","move-left","move-right","space","switch-workspace"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Tzxhy.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":null,"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}},"created_at":"2025-02-28T09:53:40.000Z","updated_at":"2025-02-28T10:09:03.000Z","dependencies_parsed_at":"2025-02-28T16:48:19.523Z","dependency_job_id":"4ee896f4-a753-43a5-9903-84a9d55f1c87","html_url":"https://github.com/Tzxhy/mac-switch-workspace-by-mouse","commit_stats":null,"previous_names":["tzxhy/mac-switch-workspace-by-mouse"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Tzxhy%2Fmac-switch-workspace-by-mouse","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Tzxhy%2Fmac-switch-workspace-by-mouse/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Tzxhy%2Fmac-switch-workspace-by-mouse/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Tzxhy%2Fmac-switch-workspace-by-mouse/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Tzxhy","download_url":"https://codeload.github.com/Tzxhy/mac-switch-workspace-by-mouse/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241209527,"owners_count":19927734,"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":["macos","mouse","move","move-left","move-right","space","switch-workspace"],"created_at":"2025-02-28T19:14:25.497Z","updated_at":"2026-04-24T21:32:39.809Z","avatar_url":"https://github.com/Tzxhy.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"English version see below after Chinese version.\n\nIf you are looking for Windows software, go to [windows-shortcut](https://github.com/Tzxhy/windows-shortcut).\n\n\n# MacOS上鼠标翻页软件\n在mac上，如果有触摸板，可以很容易多指切换屏幕窗口。但对于Mac Mini，或者使用鼠标的用户，如果你的鼠标没有额外的功能键，或者无法装对应的驱动，那么你只能通过键盘：Ctrl + Left/Right 来切换窗口了。通过本工具，可以直接用鼠标中键来切换窗口：\n\n在按下了鼠标中键后的2000ms内：\n1. 如果鼠标向左移动超过屏幕宽度的1/20，那么发送按键：`Ctrl+Left`；\n2. 如果鼠标向右移动超过屏幕宽度的1/20，那么发送按键：`Ctrl+Right`；\n3. 果鼠标向上移动超过屏幕宽度的1/20，那么发送按键：`Ctrl+Up`；\n4. 果鼠标向下移动超过屏幕宽度的1/20，那么发送按键：`Ctrl+Down`；\n\n如果超出了2000ms，那么再移动时，也无效。\n\n你需要配置成这样，或者你修改源码，自己编译：\n![image](https://github.com/user-attachments/assets/a6209ad7-698b-4f2b-9b39-82a370d304dd)\n\n# Switch-WorkSpace-On-Mac\nThis software can use the middle button of the mouse to switch workspace on Mac for those mouse not having extra functional button.\n\nAfter pressed the middle button of the mouse, within 2000ms:\n1. If your mouse move left exceeds ${screen width / 20}, then trigger `Ctrl + Left`, which will move one workspace towards left by default;\n2. If your mouse move right exceeds ${screen width / 20}, then trigger `Ctrl + Right`, which will move one workspace towards right by default;\n3. If your mouse move up exceeds ${screen height / 20}, then trigger `Ctrl + Up` ,which will open Scheduler by default;\n4. If your mouse move down exceeds ${screen height / 20}, then trigger `Ctrl + Down`.\n\nBe sure, this software uses AppleScript to finish those tasks above, so needs your permission when first executing it.\n\n# Other\nIf you need it start up after login, just add start-mouse.sh to your login startup items.\n\n# Help\nYou may need to configurate your keyboard shortcurs like this(if you want to switch workspace):\n![image](https://github.com/user-attachments/assets/a6209ad7-698b-4f2b-9b39-82a370d304dd)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftzxhy%2Fmac-switch-workspace-by-mouse","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftzxhy%2Fmac-switch-workspace-by-mouse","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftzxhy%2Fmac-switch-workspace-by-mouse/lists"}