{"id":13594355,"url":"https://github.com/kiswitch/kiswitch","last_synced_at":"2025-04-09T07:32:00.462Z","repository":{"id":39335908,"uuid":"295138656","full_name":"kiswitch/kiswitch","owner":"kiswitch","description":"Footprints for popular keyboard switches","archived":false,"fork":false,"pushed_at":"2023-12-06T22:43:32.000Z","size":9060,"stargazers_count":508,"open_issues_count":17,"forks_count":63,"subscribers_count":6,"default_branch":"main","last_synced_at":"2024-08-02T16:51:54.674Z","etag":null,"topics":["cherry-mx","cherrymx","footprint","footprint-libraries","hacktoberfest","hotswap","hotswappable","kailh","kailh-hotswap","keyboard","keyswitch","kicad","kicad-footprints","kicad-library","pcb","switches"],"latest_commit_sha":null,"homepage":"","language":"Python","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/kiswitch.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE-CC-BY-SA","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null},"funding":{"ko_fi":"perigoso"}},"created_at":"2020-09-13T11:39:11.000Z","updated_at":"2024-08-01T21:10:54.000Z","dependencies_parsed_at":"2023-01-21T23:00:30.326Z","dependency_job_id":null,"html_url":"https://github.com/kiswitch/kiswitch","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kiswitch%2Fkiswitch","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kiswitch%2Fkiswitch/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kiswitch%2Fkiswitch/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kiswitch%2Fkiswitch/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kiswitch","download_url":"https://codeload.github.com/kiswitch/kiswitch/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223375313,"owners_count":17135347,"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":["cherry-mx","cherrymx","footprint","footprint-libraries","hacktoberfest","hotswap","hotswappable","kailh","kailh-hotswap","keyboard","keyswitch","kicad","kicad-footprints","kicad-library","pcb","switches"],"created_at":"2024-08-01T16:01:32.221Z","updated_at":"2025-04-09T07:32:00.446Z","avatar_url":"https://github.com/kiswitch.png","language":"Python","funding_links":["https://ko-fi.com/perigoso"],"categories":["Python"],"sub_categories":[],"readme":"# Keyswitch Kicad Library\n\n![views](https://views.whatilearened.today/views/github/perigoso/Switch_Keyboard.svg)\n\nThis is a footprint library for [KiCad](https://www.kicad.org), a Cross Platform and Open Source EDA.\n\nIt has footprints for most popular keyboard switches.\n\n![Banner](assets/banner.png)\n\n```\nWarning!\n\nVersions prior to v2.1.2 have incorrect dimensions for Kailh choc V1 switches (as well as wrong name as it's actually V1 and V2 compatible), so please use the latest version if you want to use these. see issue #26.\n```\n\n## Supported footprints\n\n|                                                                 |\n|-----------------------------------------------------------------|\n| Cherry MX and equivalent, Plate and PCB mount.                  |\n| Alps/Matias or equivalent.                                      |\n| Hybrid footprints for Cherry MX and Alps/Matias (accepts both). |\n| Kailh Choc low profile switches V1 (CPG1350).                   |\n| Kailh Choc low profile switches V2 (CPG1353).                   |\n| Kailh Hotswap sockets for Cherry MX equivalent switches.        |\n| Kailh Hotswap sockets for Choc low profile switches             |\n| Kailh KH CPG1280                                                |\n| Kailh CPG1425                                                   |\n| Kailh Choc Mini CPG1232                                         |\n\nIf you find any issues, missing footprints or want another family of switches supported please [open an issue](https://github.com/perigoso/keyswitch-kicad-library/issues/new) about it!\n\n## Stabilizers\n\nStabilizers are provided as seperate footprints in order to offer more flexibility and reduce the total number of switch footprint variants.\n\nCurrently there are footprints for Cherry MX PCB mount equivalent stabilizers in 2u 6u 6.25u 7u and 8u.\n\n## 3D Models\n\nThe library includes the following 3d models:\n\n|                          |\n|--------------------------|\n| SW_Cherry_MX_PCB         |\n| SW_Cherry_MX_Plate       |\n| Stabilizer_Cherry_MX     |\n| SW_Hotswap_Kailh (MX)    |\n| SW_Hotswap_Kailh_Choc_v1 |\n| SW_Kailh_Choc_V1         |\n\nWe are looking for contributors for the missing 3d models.\n\n## Scripts\n\nThese footprints are generated with [kicad-footprint-generator](https://gitlab.com/kicad/libraries/kicad-footprint-generator.git) with the scripts located in [scripts](scripts/).\n\n## Using the library\n\nAs of v2.0  the library is meant to be installed via KiCad's `Plugin and Content Manager`, this is available in KiCad v6 and newer, as part of the KiCad official repository. It can be found under the \"Libraries\" tab (under the name \"Keyswitch Kicad Library\"). If you are using kicad v5, please head to the [old version of this library (v1.0.0)](https://github.com/perigoso/keyswitch-kicad-library/tree/e56f74e93c850e60e04023563835b5fe031fd638)\n\nIf you want to use git simply clone this repo to the directory where you want your library stored and include them manually on your footprints table `Preferences -\u003e Manage Footprint Libraries...` (Note: with this method the 3d models will not be linked automatically/correctly)\n\nIf you want to use the RECOMMENDED method, open the content manager, where you will find this library in the libraries tab (you can also download the archive from the [releases (on the original repo)](https://github.com/perigoso/keyswitch-kicad-library/releases) and `install from file...`) Note that you need to add the libraries to the library table manually.\n\nThe following entries needs to be added:\n\nName | Location\n---|---\nMounting_Keyboard_Stabilizer | ${KICAD6_3RD_PARTY}/footprints/com_github_perigoso_keyswitch-kicad-library/Mounting_Keyboard_Stabilizer.pretty\nSwitch_Keyboard_Alps_Matias | ${KICAD6_3RD_PARTY}/footprints/com_github_perigoso_keyswitch-kicad-library/Switch_Keyboard_Alps_Matias.pretty\nSwitch_Keyboard_Cherry_MX | ${KICAD6_3RD_PARTY}/footprints/com_github_perigoso_keyswitch-kicad-library/Switch_Keyboard_Cherry_MX.pretty\nSwitch_Keyboard_Hotswap_Kailh | ${KICAD6_3RD_PARTY}/footprints/com_github_perigoso_keyswitch-kicad-library/Switch_Keyboard_Hotswap_Kailh.pretty\nSwitch_Keyboard_Hybrid | ${KICAD6_3RD_PARTY}/footprints/com_github_perigoso_keyswitch-kicad-library/Switch_Keyboard_Hybrid.pretty\nSwitch_Keyboard_Kailh | ${KICAD6_3RD_PARTY}/footprints/com_github_perigoso_keyswitch-kicad-library/Switch_Keyboard_Kailh.pretty\n\n## Screenshots\n\nAll screenshots are of the 1u keycap switch.\n\n`Warning: some footprints are missing or may have changed, this is out of date`\n\n![cherrymx_plate](https://user-images.githubusercontent.com/39195157/93152763-7811aa00-f6f7-11ea-83d1-0b2d516927cc.png)\n![cherrymx_pcb](https://user-images.githubusercontent.com/39195157/93150026-f66a4e00-f6ef-11ea-809f-2e3a8dbe188a.png)\n![alps_matias](https://user-images.githubusercontent.com/39195157/93150084-1c8fee00-f6f0-11ea-97b3-24e5e425479f.png)\n![hybrids](https://user-images.githubusercontent.com/39195157/93150167-55c85e00-f6f0-11ea-9cce-6adc237570d0.png)\n![kailh_Choc](https://user-images.githubusercontent.com/39195157/93150222-72649600-f6f0-11ea-8a22-b62f093f4c2d.png)\n![kailh_hotswap](https://user-images.githubusercontent.com/39195157/93150276-8f996480-f6f0-11ea-9919-c952159f183f.png)\n\nDemo board for real life testing\n\n![demo](https://user-images.githubusercontent.com/39195157/158739962-f45acbd3-4a3d-4613-8eca-4cfa36f55d0c.png)\n\n## Source\n\nIf you're reading this from outside GitHub, you can find the source for this library [here](https://github.com/perigoso/keyswitch-kicad-library):\n\n`https://github.com/perigoso/keyswitch-kicad-library`\n\n## Contribuitors and Acknowledgements\n\n- [Rafael Silva (perigoso)](https://github.com/perigoso) - Author and maintainer\n- [Jesse Vincent (obra)](https://github.com/obra) - Production tested footprints and others from [keyboardio](https://github.com/keyboardio)\n- [Ryan Rotter (rrotter)](https://github.com/rrotter) - Improved the Kailh Choc silkscreen outline\n- [Lotier](https://github.com/Lotier) - Wrote the script for automating the generation of stabilizers\n- [ai03](https://github.com/ai03-2725) - Original library that served as motivation and baseline\n\n## License\n\nThe library is dual licensed under [MIT](LICENSE-MIT) and [CC-BY-SA 4.0](LICENSE-CC-BY-SA).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkiswitch%2Fkiswitch","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkiswitch%2Fkiswitch","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkiswitch%2Fkiswitch/lists"}