{"id":15134546,"url":"https://github.com/raxigan/pcfy-my-mac","last_synced_at":"2025-10-23T11:30:32.987Z","repository":{"id":42720377,"uuid":"471771868","full_name":"raxigan/pcfy-my-mac","owner":"raxigan","description":"Get a PC-like experience on macOS - keyboard shortcuts \u0026 windows management","archived":false,"fork":false,"pushed_at":"2025-01-11T17:59:48.000Z","size":4924,"stargazers_count":18,"open_issues_count":5,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-02-06T19:13:07.056Z","etag":null,"topics":["karabiner","keyboard","linux","mac","macos","productivity","windows"],"latest_commit_sha":null,"homepage":"","language":"Go","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/raxigan.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":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-03-19T17:52:42.000Z","updated_at":"2025-01-12T16:20:43.000Z","dependencies_parsed_at":"2024-06-15T08:43:06.191Z","dependency_job_id":"7ffed5cf-1a1c-43e0-9d67-f88d6ace99b3","html_url":"https://github.com/raxigan/pcfy-my-mac","commit_stats":null,"previous_names":["raxigan/pcfy-my-mac"],"tags_count":11,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raxigan%2Fpcfy-my-mac","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raxigan%2Fpcfy-my-mac/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raxigan%2Fpcfy-my-mac/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raxigan%2Fpcfy-my-mac/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/raxigan","download_url":"https://codeload.github.com/raxigan/pcfy-my-mac/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":237811548,"owners_count":19370146,"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":["karabiner","keyboard","linux","mac","macos","productivity","windows"],"created_at":"2024-09-26T05:22:45.902Z","updated_at":"2025-10-23T11:30:32.980Z","avatar_url":"https://github.com/raxigan.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003cdiv align=\"center\" style=\"width: 50%; padding: 5px; margin: auto;\"\u003e\n\n# PC'fy my Mac\n\n\u003cp\u003e\n\u003ca href=\"https://github.com/raxigan/pcfy-my-mac/actions\"\u003e\u003cimg src=\"https://github.com/raxigan/pcfy-my-mac/actions/workflows/build.yml/badge.svg\" alt=\"Build Status\"\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/raxigan/pcfy-my-mac/releases\"\u003e\u003cimg src=\"https://img.shields.io/github/release/raxigan/pcfy-my-mac.svg\" alt=\"Latest Release\"\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/raxigan/pcfy-my-mac/releases\"\u003e\u003cimg src=\"https://img.shields.io/github/downloads/raxigan/pcfy-my-mac/total?color=orange\" alt=\"Downloads\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\nAll-in-one project to help you get a **PC**-like experience (known from **Windows** or **Linux** systems) on your **macOS**\n\n  \u003c/div\u003e\n\u003c/div\u003e\n\n---\n\nThis is a set of configuration files for open source applications\nlike [Karabiner-Elements](https://karabiner-elements.pqrs.org/), [AltTab](https://alt-tab-macos.netlify.app/)\nand [Rectangle](https://rectangleapp.com/)\nwrapped into an easy-to-use CLI tool that automates the whole setup process. It’s an ideal solution for\nthose who are new to macOS and for users who frequently switch between macOS and Windows or Linux.\nThis is also perfect for you if the macOS out-of-the-box workspace management isn’t really your thing.\n\nYou can think of this project as [Kinto](https://github.com/rbreaves/kinto), but in reverse and with more features.\n\n## Features\n\n- **Keyboard shortcuts** for system and browser (Chromium-based) actions\n- Battle-tested **JetBrains tools keymaps**\n- **Quick application launching** with the Win/Opt key - just like on PC (Menu Start)\n- **Snapping windows** using Win/Opt + ←/→/↑/↓ shortcut\n- **Better window switcher** - move between windows with Alt + Tab shortcut\n- **Everything works on any keyboard layout out of the box - you can use both the built-in Mac and external PC keyboards at the same\n  time**\n\n\u003cimg src=\".docs/demo.gif\" alt=\"demo\" width=\"100%\"/\u003e\n\n## Installation\n\n### [Homebrew](https://brew.sh/)\n\n```shell\nbrew install raxigan/tap/pcfy-my-mac\npcfy-my-mac\n```\n\n\u003e Remember about executing the binary after every **_brew upgrade_** in order to apply the changes from new release.\n\n### Script\n\nMay require [special terminal permissions](#Terminal-dev-permissions)\n\n```shell\n/bin/bash -c \"$(curl -fsSL https://raw.githubusercontent.com/raxigan/pcfy-my-mac/main/pcfy.sh)\"\n```\n\n### Go binary\n\n```shell\ngo install github.com/raxigan/pcfy-my-mac@latest\npcfy-my-mac\n```\n\n### From source\n\n```shell\ngit clone https://github.com/raxigan/pcfy-my-mac\ncd pcfy-my-mac\ngo run pcfy.go\n```\n\n## Options\n\n| Flag                      | Description                                                                                                                                        |\n|---------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------|\n| **--help**                | Show usage                                                                                                                                         |\n| **--params** \u003cparams.yml\u003e | Path to your YAML file containing installation parameters. Allows to run the tool in non-interactive mode. Use below option to see the file format |\n| **--show-sample-yaml**    | Show sample YAML config which can be used as the input for above flag                                                                              |\n| **--verbose**             | Enable verbose mode. All performed operations will be logged out to console                                                                        |\n| **--version**             | Show version information                                                                                                                           |\n\n## Shortcut list\n\nThe following shortcuts are available right after installation. Note that shortcuts from the tools' keymaps are not\nlisted here.\n\nFor Mac keyboard layout:\n\n- The **Win** key corresponds to **Opt**\n- The **Alt** key corresponds to **Cmd**\n\n\u003cdetails\u003e\n  \u003csummary\u003e\u003cb\u003eShortcut list - click to expand\u003c/b\u003e\u003c/summary\u003e\n\n  ```txt\n  Alt + Tab                   # Switch to next window\n  Alt + Shift                 # Switch to previous window (only when switcher is opened)\n  Win + Left/Right            # Snap window to left/right\n  Win + Up/Down               # Maximixe/almost maximize window\n  Ctrl + Left/Right           # Move to previous/next word\n  Ctrl + Shift + Left/Right   # Select previous/next word\n  Home/End                    # Move to beginning/end of line\n  Ctrl + Home/End             # Move to beginning/end of document\n  Shift + Home/End            # Move to beginning/end of line with selection\n  Ctrl + Shift + Home/End     # Move to beginning/end of document with selection\n  Ctrl + LMB                  # Select item\n  Ctrl + Shift + LMB          # Select multiple items\n  Ctrl + +/-                  # Zoom in/out in browser, Slack, Teams\n  Ctrl + A                    # Select all\n  Ctrl + B                    # Bold\n  Ctrl + C                    # Copy item, interrupt current process in terminal\n  Ctrl + F                    # Find\n  Ctrl + I                    # Italic\n  Ctrl + N                    # New...\n  Ctrl + L                    # Open location in browser\n  Ctrl + O                    # Open...\n  Ctrl + R                    # Replace/Reload\n  Ctrl + S                    # Save\n  Ctrl + T                    # New browser/terminal tab\n  Ctrl + Shift + T            # Reopen last closed browser/terminal tab\n  Ctrl + U                    # Underline\n  Ctrl + V                    # Paste item\n  Ctrl + W                    # Close browser tab\n  Ctrl + X                    # Cut\n  Ctrl + Y                    # Redo\n  Ctrl + Z                    # Undo\n  Ctrl + Tab                  # Move to next browser/terminal tab\n  Ctrl + Shift + Tab          # Move to previous browser/terminal tab\n  Ctrl + Shift + Z            # Redo\n  Win + L                     # Lock screen\n  F2                          # Rename file in Finder\n  F3/Shift + F3               # Move to next/previous ocurrence in text\n  Alt + F4                    # Quit application\n  F5                          # Reload page in browser\n  Win                         # Open preferred application launcher\n  Ctrl + Alt + T              # Open preferred terminal\n  ```\n\n\u003c/details\u003e\n\n## Version compatibility\n- Fleet 1.39.118+\n\n## Additional notes\n\n- Only tools that have been installed via the JetBrains Toolbox are supported **[JetBrains keymaps only]**\n- Ensure your modifier keys are set to default in _System Settings \u003e Keyboard \u003e Keyboard Shortcuts... \u003e Modifier Keys_\n- Ensure the function keys are enabled in the system settings in order to use shortcuts based on them:\n- There is 1 alternative shortcut provided for Mac keyboard layout (as there is no **Insert** key):\n    - **Alt/Cmd + Insert** (New file in JB tools) → **Alt/Cmd + Enter**\n\n![function-keys.png](.docs/resources/f-keys.png)\n\n### Terminal dev permissions\n\n**Necessary only if you install it by shell script**. The binary is not signed, so macOS may not let you run it without\nthe following permissions for your terminal. Just go to *System Settings* \u003e *Privacy \u0026 Security* \u003e *Developer Tools*\nand enable it:\n\n![terminal_permissions.png](.docs/terminal-permissions.png)\n\n## Troubleshooting\n\n- **Problem**: Shortcuts from [the list](#shortcut-list) do not work\n\n**Solution**: Verify the **PCfy** profile is selected in Karabiner-Elements:\n\n![karabiner-profile.png](.docs/karabiner-profile.png)\n\nAlso check if **Modify events** option for your keyboard is enabled in *Karabiner-Elements* \u003e *Settings* \u003e *Devices*:\n\n![device-enabled.png](.docs/device-enabled.png)\n\n- **Problem**: On pressing '~' (tilde), § (section sign) is entered instead. This might happen if your external keyboard and the built-in one are of different types: ANSI/ISO/JIS\n\n**Solution**: Ensure **ANSI** keyboard type is selected in `Karabiner Elements` → `Virtual Keyboard`\n\n![karabiner-virtual-kb.png](.docs/karabiner-virtual-kb.png)\n\n## Contributing\n- Ask a question or share your ideas in [Discussions](https://github.com/raxigan/pcfy-my-mac/discussions)\n- Create \u0026 comment issues in [Issues](https://github.com/raxigan/pcfy-my-mac/issues)\n\n## Acknowledgments\n\n- [@tezeko](https://github.com/tekezo) for [Karabiner-Elements](https://karabiner-elements.pqrs.org/)\n- [@lwouis](https://github.com/lwouis) for [AltTab](https://alt-tab-macos.netlify.app/)\n- [@rxhanson](https://github.com/rxhanson) for [Rectangle](https://rectangleapp.com/)\n- [@rux616](https://github.com/rux616) for [karabiner-windows-mode](https://github.com/rux616/karabiner-windows-mode)\n- [@serhii-londar](https://github.com/serhii-londar)\n  for [open-source-mac-os-apps](https://github.com/serhii-londar/open-source-mac-os-apps)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fraxigan%2Fpcfy-my-mac","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fraxigan%2Fpcfy-my-mac","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fraxigan%2Fpcfy-my-mac/lists"}