{"id":23388220,"url":"https://github.com/strong-foundation/karabiner-elements-remapping","last_synced_at":"2026-02-13T02:47:34.749Z","repository":{"id":269108517,"uuid":"906452756","full_name":"Strong-Foundation/Karabiner-Elements-Remapping","owner":"Strong-Foundation","description":"Windows Keyboard Remapping for macOS with Karabiner-Elements","archived":false,"fork":false,"pushed_at":"2024-12-24T08:24:42.000Z","size":79,"stargazers_count":3,"open_issues_count":2,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-08T13:21:54.258Z","etag":null,"topics":["karabiner","karabiner-configurator","karabiner-elements","keyboard-customization","keyboard-remapping","macos","windows-keyboard","windows-to-mac-remap"],"latest_commit_sha":null,"homepage":"","language":"Jsonnet","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/Strong-Foundation.png","metadata":{"files":{"readme":"Readme.md","changelog":null,"contributing":null,"funding":null,"license":"License.md","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-12-21T00:20:35.000Z","updated_at":"2025-03-29T16:41:16.000Z","dependencies_parsed_at":"2024-12-21T01:23:40.191Z","dependency_job_id":"7ecd1efc-1e91-40b6-86a1-1e95215ccfbd","html_url":"https://github.com/Strong-Foundation/Karabiner-Elements-Remapping","commit_stats":null,"previous_names":["strong-foundation/karabiner-elements-remapping"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Strong-Foundation%2FKarabiner-Elements-Remapping","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Strong-Foundation%2FKarabiner-Elements-Remapping/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Strong-Foundation%2FKarabiner-Elements-Remapping/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Strong-Foundation%2FKarabiner-Elements-Remapping/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Strong-Foundation","download_url":"https://codeload.github.com/Strong-Foundation/Karabiner-Elements-Remapping/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247848156,"owners_count":21006202,"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","karabiner-configurator","karabiner-elements","keyboard-customization","keyboard-remapping","macos","windows-keyboard","windows-to-mac-remap"],"created_at":"2024-12-22T02:18:06.739Z","updated_at":"2026-02-13T02:47:34.705Z","avatar_url":"https://github.com/Strong-Foundation.png","language":"Jsonnet","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Karabiner-Elements-Remapping\n\nA collection of configuration files, guides, and resources to help macOS users remap their keyboards using [Karabiner-Elements](https://karabiner-elements.pqrs.org/).\n\n---\n\n## 🌟 Features\n\n- **Windows Keyboard Compatibility**: Seamlessly remap Windows keyboard keys to macOS equivalents (e.g., `Ctrl` → `Command`, `Alt` → `Option`).\n- **Predefined Profiles**: Ready-made configurations for popular keyboard models and layouts.\n- **Custom Keybinding**: Easily create your own key remaps for a more personalized experience.\n- **Advanced Features**: Dual-role keys, app-specific mappings, and conditional remaps for even more customization.\n\n---\n\n## 🛠️ Installation\n\n### Step 1: Install Karabiner-Elements\n\n1. Download and install Karabiner-Elements from the [official website](https://karabiner-elements.pqrs.org/).\n2. Follow the installation prompts provided on the website.\n\n### Step 2: Import the Configuration\n\n1. Open the following URL in your browser to import the configuration directly into Karabiner-Elements:\n\n   ```\n   karabiner://karabiner/assets/complex_modifications/import?url=https://raw.githubusercontent.com/Strong-Foundation/Karabiner-Elements-Remapping/main/config/windows-keyboard.json\n   ```\n\n2. This action will launch Karabiner-Elements and automatically import the configuration file.\n3. Navigate to the **Complex Modifications** tab in Karabiner-Elements, and enable the imported rule(s).\n\n---\n\n## 📂 Repository Structure\n\n```plaintext\nKarabiner-Elements-Remapping/\n│\n├── .github/              # GitHub workflows and CI/CD configuration\n│   └── workflows\n│       └── build-jsonnet.yml # Workflow for automating JSONNET compilation\n├── .gitignore            # Git ignore file\n├── License.md            # License for the repository\n├── Readme.md             # This file\n├── config/               # Compiled JSON configuration files for Karabiner-Elements\n│   └── windows-keyboard.json  # The file imported by Karabiner-Elements\n├── jsonnet/              # JSONNET files used to generate configuration JSON\n│   └── windows-mac-remap.jsonnet  # JSONNET file that generates the `windows-keyboard.json`\n└── scripts/              # Helper scripts for build and automation\n    └── build-jsonnet.sh  # Script to generate the JSON file from the JSONNET source\n```\n\n---\n\n## ⚙️ How It Works\n\nInstead of manually writing complex JSON configuration rules, we use **JSONNET**, a data-templating language, to generate the final configuration file (`windows-keyboard.json`).\n\n### The process is simple:\n\n1. The `windows-mac-remap.jsonnet` file defines the remap rules.\n2. The `build-jsonnet.sh` script compiles this JSONNET file into a final JSON format.\n3. The compiled `windows-keyboard.json` can then be imported into Karabiner-Elements.\n\nTo regenerate the JSON file from the JSONNET template, you can run the `build-jsonnet.sh` script.\n\n---\n\n## 💡 Contribution\n\nContributions are welcome! If you have a custom key remap or improvement, feel free to submit a pull request or open an issue.\n\n### How to Contribute\n\n1. **Fork** this repository.\n2. **Create a new branch** for your changes:\n   ```bash\n   git checkout -b feature/my-custom-remap\n   ```\n3. **Commit** your changes and **push** to your fork:\n   ```bash\n   git commit -m \"Add remap for XYZ keyboard\"\n   git push origin feature/my-custom-remap\n   ```\n4. **Submit a pull request** to merge your changes into the main repository.\n\n---\n\n## 🛡️ License\n\nThis repository is licensed under the [MIT License](LICENSE). You are free to use, modify, and distribute the configurations as needed.\n\n---\n\n## 📬 Support\n\nIf you encounter issues or have questions:\n\n- Open an [Issue](https://github.com/Strong-Foundation/Karabiner-Elements-Remapping/issues).\n- Visit the [Karabiner-Elements discussion forum](https://github.com/pqrs-org/Karabiner-Elements/discussions).\n\nHappy remapping! 🎉\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstrong-foundation%2Fkarabiner-elements-remapping","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstrong-foundation%2Fkarabiner-elements-remapping","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstrong-foundation%2Fkarabiner-elements-remapping/lists"}