{"id":16447262,"url":"https://github.com/junekelly/carpalx-macos","last_synced_at":"2026-06-12T12:31:46.826Z","repository":{"id":229318439,"uuid":"775658999","full_name":"JuneKelly/carpalx-macos","owner":"JuneKelly","description":"Carpalx keyboard layouts for macos, including \"option keys\" supporting the full range of special characters on macOS.","archived":false,"fork":false,"pushed_at":"2024-03-24T18:59:43.000Z","size":12523,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-26T11:44:17.548Z","etag":null,"topics":["carpalx","carpalx-keyboard-layouts","keyboard-layout","mac","macos","osx"],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/JuneKelly.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-03-21T19:54:47.000Z","updated_at":"2024-09-04T02:52:52.000Z","dependencies_parsed_at":"2024-11-11T07:00:43.815Z","dependency_job_id":null,"html_url":"https://github.com/JuneKelly/carpalx-macos","commit_stats":null,"previous_names":["junekelly/carpalx-macos"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/JuneKelly/carpalx-macos","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JuneKelly%2Fcarpalx-macos","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JuneKelly%2Fcarpalx-macos/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JuneKelly%2Fcarpalx-macos/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JuneKelly%2Fcarpalx-macos/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/JuneKelly","download_url":"https://codeload.github.com/JuneKelly/carpalx-macos/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JuneKelly%2Fcarpalx-macos/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34245217,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-12T02:00:06.859Z","response_time":109,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["carpalx","carpalx-keyboard-layouts","keyboard-layout","mac","macos","osx"],"created_at":"2024-10-11T09:50:14.108Z","updated_at":"2026-06-12T12:31:46.809Z","avatar_url":"https://github.com/JuneKelly.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# Carpalx MacOS\n\n[Carpalx](https://mk.bcgsc.ca/carpalx/) keyboard layouts for macOS, including\n\"option keys\" supporting the full range of special characters on macOS.\n\n![Screenshot of the QGMLWY layout](_assets/lead-screenshot.png)\n\n## Layouts\n\n- [Fully Optimised](https://mk.bcgsc.ca/carpalx/?full_optimization)\n  - (C1) **QFMLWY**\n  - (C2) **QGMLWB**\n  - (C3) **QGMLWY**\n- [Partially Optimised](https://mk.bcgsc.ca/carpalx/?partial_optimization)\n  - (C4) **QWKRFY**\n  - (C5) **QWYRFM**\n- [Community\nLayouts](https://mk.bcgsc.ca/carpalx/?partial_optimization#carpalxq_user_contribution)\n  - (C6) **CarpalxQ** (by [Jay\n  Walker](http://jumpedthesynapse.blogspot.com/2007/07/carpalxq.html))\n  - (C7) **QGPR** (by [Jameson\n  Quinn](https://sourceforge.net/p/qwpr/wiki/Home/))\n\n## Installation Instructions\n\n1. Download this repository, by clicking the green \"Code\" button above and\n   choosing either a `git`-based option, or choosing the zip file.\n\n![Download the repository](_assets/install-download.png)\n\n2. Copy the `Carpalx.bundle` file to either `~/Library/Keyboard Layouts/`, or\nto `/Library/Keyboard Layouts/`\n\n![Copy the bundle](_assets/install-copy-bundle.png)\n\n3. (You may need to restart your computer at this point)\n\n4. Open the System Settings app\n\n5. Open \"Keyboard\" settings\n\n6. Under the \"Text Input\" heading, click \"Edit\"\n\n![Edit button under Text Input](_assets/install-text-input-edit.png)\n\n7. Click the \"+\" button in the lower-left\n\n![Plus button](_assets/install-plus-button.png)\n\n8. (At this point, the Carpalx bundle should have been loaded) Select the\n   Carpalx layout you'd like to add (All layouts in this bundle start with\n\"CX\"), and click \"Add\"\n\n![Layout list](_assets/install-layout-list.png)\n\n9. Click \"Done\"\n\n10. In the menu bar, you should see the input source menu, where you can select the\nkeyboard layout you'd like to use.\n\n![Input source menu](_assets/install-input-source-menu.png)\n\n(Caveat: I personally use QGMLWY, so the other layouts are a blind-spot for me.\nIf you have any problems with the layouts, please open an issue on this\nrepository!)\n\n## Why?\n\nI've been using the [Carpalx layouts from\ndeekan](https://github.com/deekayen/carpalx_mac) for a long time, but I noticed\nthat those layouts don't have \"option keys\", the special characters that are\navailable on macOS keyboard layouts by holding the Option key. Because of this,\nit's not possible to type special characters or access the \"dead keys\" required\nto add accented characters like you can on a normal keyboard layout.\n\n## How These Layouts Were Made\n\nI made these layouts with the [Ukelele](https://software.sil.org/ukelele/)\nkeyboard editor app, starting from the default Colemak layout and then swapping\nkeys until I had the desired layouts. By doing it this way, all the \"special\nstuff\" was preserved, and the resulting keyboard layouts fit in nicely with the\nrest of macOS.\n\n## The Layouts\n\n### Fully Optimised\n\n#### (C1) QFMLWY\n\nDefault:\n![C1 QFMLWY Screenshot](_assets/c1-screenshot.png)\n\nHolding \"Option\":\n![C1 QFMLWY Screenshot, holding \"Option\"](_assets/c1-opt-screenshot.png)\n\n#### (C2) QGMLWB\n\nDefault:\n![C2 QGMLWB Screenshot](_assets/c2-screenshot.png)\n\nHolding \"Option\":\n![C2 QGMLWB Screenshot, holding \"Option\"](_assets/c2-opt-screenshot.png)\n\n#### (C3) QGMLWY\n\nDefault:\n![C3 QGMLWY Screenshot](_assets/c3-screenshot.png)\n\nHolding \"Option\":\n![C3 QGMLWY Screenshot, holding \"Option\"](_assets/c3-opt-screenshot.png)\n\n### Partially Optimised\n\n#### (C4) QWKRFY\n\nDefault:\n![C4 QWKRFY Screenshot](_assets/c4-screenshot.png)\n\nHolding \"Option\":\n![C4 QWKRFY Screenshot, holding \"Option\"](_assets/c4-opt-screenshot.png)\n\n#### (C5) QWYRFM\n\nDefault:\n![C5 QWYRFM Screenshot](_assets/c5-screenshot.png)\n\nHolding \"Option\":\n![C5 QWYRFM Screenshot, holding \"Option\"](_assets/c5-opt-screenshot.png)\n\n### Community-Contributed Layouts\n\n#### (C6) CarpalxQ\n\nDefault:\n![C6 CarpalxQ Screenshot](_assets/c6-screenshot.png)\n\nHolding \"Option\":\n![C6 CarpalxQ Screenshot, holding \"Option\"](_assets/c6-opt-screenshot.png)\n\n#### (C7) QWPR\n\nDefault:\n![C7 QWPR Screenshot](_assets/c7-screenshot.png)\n\nHolding \"Option\":\n![C7 QWPR Screenshot, holding \"Option\"](_assets/c7-opt-screenshot.png)\n\n## License\n\nSee [LICENSE](./LICENSE)\n\n## Guest Book\n\nIf you like this project, consider opening a pull request to add your name to\nthis list!\n\n### Users, Fans, and Guests\n\n- June Kelly ([@JuneKelly](https://github.com/JuneKelly)), original author of\n  Carpalx MacOS\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjunekelly%2Fcarpalx-macos","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjunekelly%2Fcarpalx-macos","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjunekelly%2Fcarpalx-macos/lists"}