Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/supermarsx/magickeyboard
Apple Magic Keyboard 1, 2 and 3 drivers from Bootcamp, plus Keyboard Layouts
https://github.com/supermarsx/magickeyboard
apple apple-magic-keyboard bootcamp driver keyboard magic magic-keyboard windows
Last synced: about 2 months ago
JSON representation
Apple Magic Keyboard 1, 2 and 3 drivers from Bootcamp, plus Keyboard Layouts
- Host: GitHub
- URL: https://github.com/supermarsx/magickeyboard
- Owner: supermarsx
- Created: 2021-04-21T14:49:18.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2024-09-13T13:52:39.000Z (5 months ago)
- Last Synced: 2024-09-14T04:32:01.493Z (5 months ago)
- Topics: apple, apple-magic-keyboard, bootcamp, driver, keyboard, magic, magic-keyboard, windows
- Language: Batchfile
- Homepage:
- Size: 4.41 MB
- Stars: 32
- Watchers: 4
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: readme.md
Awesome Lists containing this project
README
# magickeyboard
This is an alternative/mirror repository for the **Apple Magic Keyboard** 1 (removable batteries, rounded top), 2 (slim, embedded battery) and 3 (slim, rounded corners and embedded battery) **drivers**, plus all the Apple **keyboard layouts** currently available. Use your magic keyboard on any bluetooth enabled Windows machine.
[](https://www.youtube.com/watch?v=dQw4w9WgXcQ)
[](#)
[](#)
[](#)
[](#)
[](https://codeload.github.com/supermarsx/magickeyboard/zip/refs/heads/main)
[](#)
[**[Download this repository]**](https://codeload.github.com/supermarsx/magickeyboard/zip/refs/heads/main)
[**[Go to 'Quick Start' >>]**](#quick-start)
## Table of Contents
- [**Quick Start**](#quick-start)
- [Driver only](#driver-only)
- [Driver and layouts](#driver-and-layouts)
- [Layouts only](#layouts-only)
- [Other methods/options](#other-methodsoptions)
- [**Whats the purpose?**](#whats-the-purpose)
- [**File table**](#file-table)
- [**Installation instructions**](#installation-instructions)
- [Automatically install driver](#automatically-install-driver)
- [Manually install driver](#manually-install-driver)
- [Automatically install layouts](#automatically-install-layouts)
- [Manually install layouts](#manually-install-layouts)
- [Uninstall layouts](#uninstall-layouts)
- [**Layout topics**](#layout-topics)
- [Layout languages](#layout-languages)
- [Translate layout names](#translate-layout-names)
- [**Questions and problem resolution**](#questions-and-problem-resolution)
- [Layouts don't get installed if i run the batch file as an administrator](#layouts-dont-get-installed-if-i-run-the-batch-file-as-an-administrator)
- [Layout doesn't show up in keyboard layouts](#layout-doesnt-show-up-in-keyboard-layouts)
- [I'm unable to bind, remap or reregister certain keys using x method](#im-unable-to-bind-remap-or-reregister-certain-keys-using-x-method)
- [Are these files legit?](#are-these-files-legit)
- [Screwed up badly?](#screwed-up-badly)
- [**Support, warranty, guarantees**](#support-warranty-guarantees)
## Quick Start
Recommended installation methods are [**Driver only**](#driver-only) or [**Driver and layouts**](#driver-and-layouts).
### Driver only
**Note:** You'll need administrator privileges.
To **install only the driver** follow these steps:
1. **Download** one of the installers for your keyboard version/model:
- **Magic Keyboard 1**: [magickeyboard1_AppleKeyboardInstaller64.exe](https://github.com/supermarsx/magickeyboard/blob/main/magickeyboard1_AppleKeyboardInstaller64.exe?raw=true);
- **Magic Keyboard 2 and 3**: [magickeyboard2_AppleKeyboardInstaller64.exe](https://github.com/supermarsx/magickeyboard/blob/main/magickeyboard2_AppleKeyboardInstaller64.exe?raw=true).
2. **Execute** your chosen installer.
Your keyboard should be working as expected.
### Driver and layouts
**Note:** You'll need administrator privileges.
To **install both driver and layouts** follow these steps:
1. [**Download** drivers and layouts](https://codeload.github.com/supermarsx/magickeyboard/zip/refs/heads/main);
2. **Execute** the appropriate installer for your keyboard version/model:
- `magickeyboard1_AppleKeyboardInstaller64.exe` for Magic Keyboard 1;
- `magickeyboard2_AppleKeyboardInstaller64.exe` for Magic Keyboard 2 and 3.
3. **Translate** keyboard layout names **(optional)**:
- **Read** [Layout languages](#layout-languages);
- **Refer** to [Translate layout names](#translate-layout-names).
4. **Navigate** to `All Keyboard Layouts` folder and run `install_keyboard_layouts.bat` as an **administrator**.
Your keyboard and respective layouts should be working.
### Layouts only
**Note:** You'll need administrator privileges.
To **install keyboard layouts** follow these steps:
1. [**Download** all keyboard layouts folder](https://github.com/supermarsx/magickeyboard/releases/download/1/All.Keyboard.Layouts.1.0.3.40.zip);
2. **Translate** the keyboard layout name **(optional)**:
- **Read** [Layout languages](#layout-languages);
- **Refer** to [Translate layout names](#translate-layout-names).
3. **Run** `install_keyboard_layouts.bat` as an administrator.
Your keyboard layouts should be working as intended.
### Other methods/options
To **install a single keyboard layout**, **use unpacked driver files** or **other different methods, options or combinations** you should refer to the [Table of Contents](#table-of-contents) to find your preferred method and alternative actions.
If can find more **downloadables** in the [**latest release page**](https://github.com/supermarsx/magickeyboard/releases/latest).
**Note:** Don't change files, installers, etc. specially if you don't know what you're doing, check the "[Screwed up badly?](#screwed-up-badly)" topic for more information. For most use cases just use the installers and you'll be fine. Major changes are needed only in specific use case scenarios.
## Whats the purpose?
These packages are not readily available to end users and sometimes you'll not be able to find anywhere without downloading **bootcamp** from MacOS or `brigadier` for example.
These packages **fix issues** such as not being able to **use delete key** (fn + backspace) on the keyboard or not **detecting the device properly**.
Usually changes are **ready and functional** right after install but you may need to restart in some scenarios.
Also **removes the need to fully install/download bootcamp** if you're not actually using an apple machine ...and it's free, no need for paid apps if you just need the damn thing working.
## File table
**Drivers**
| Device | Filename |
| -------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Magic Keyboard 1** | [magickeyboard1_AppleKeyboardInstaller64.exe](https://github.com/supermarsx/magickeyboard/blob/main/magickeyboard1_AppleKeyboardInstaller64.exe?raw=true) |
| **Magic Keyboard 2 and 3** | [magickeyboard2_AppleKeyboardInstaller64.exe](https://github.com/supermarsx/magickeyboard/blob/main/magickeyboard2_AppleKeyboardInstaller64.exe?raw=true) |
**Layouts**
| Languages | Filename |
| --------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| All | [All.Keyboard.Layouts.1.0.3.40.zip](https://github.com/supermarsx/magickeyboard/releases/download/1/All.Keyboard.Layouts.1.0.3.40.zip) |
**Specific layout files, inside `All Keyboard Layouts` folder**
| Filename | Description |
| -------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `install_keyboard_layouts.bat` | **Install** all Magic Keyboard layouts (needs to be ran as an administrator). [[Go to file]](https://github.com/supermarsx/magickeyboard/blob/main/All%20Keyboard%20Layouts%20(1.0.3.40)/install_keyboard_layouts.bat) |
| `uninstall_keyboard_layouts.bat` | **Uninstall** all Magic Keyboard layouts (needs to be ran as an administrator). [[Go to file]](https://github.com/supermarsx/magickeyboard/blob/main/All%20Keyboard%20Layouts%20(1.0.3.40)/uninstall_keyboard_layouts.bat) |
| `install_filelist.txt` | **List** of keyboard layout DLL files to install or uninstall. [[Go to file]](https://github.com/supermarsx/magickeyboard/blob/main/All%20Keyboard%20Layouts%20(1.0.3.40)/install_filelist.txt) |
| `*.dll` | Keyboard layout **DLL file** from Apple, list here: [Layout languages](#layout-languages). |
## Installation instructions
### Automatically install driver
1. **Get** your corresponding **keyboard version installer**;
2. **Run** it, you'll need **administrator privileges**.
### Manually install driver
**Note:** Unless you have a **specific reason** for why you need individual files you should opt for automatic installation.
If you still need to **manually install** the driver for some special reason you can:
1. **Extract** files from the corresponding **keyboard version installer** (with 7-zip for example);
2. Do **one** of three things:
1. **Execute** `DPInst.exe` directly;
2. **Update** the device driver through the device manager and target the extracted folder;
3. Whatever you want.
### Automatically install layouts
To **automatically install** all keyboard layouts you'll need:
1. A **copy** of `All Keyboard Layouts` folder;
2. **Translate** any layout names inside `install_keyboard_layouts.bat` **(optional)**;
3. **Run** `install_keyboard_layouts.bat` as an **administrator**.
Your keyboard layouts will be ready to use.
### Manually install layouts
To **manually install** a keyboard layout using a DLL you'll need:
- **Keyboard** layout DLL file (ex.: `BritishA.dll`);
- **Regedit** add (`reg add`) instructions found inside `install_keyboard_layouts.bat`.
Then you need to follow these steps:
1. **Copy** DLL file to `system32` folder;
2. **Add** the corresponding layout keys to the registry through the registry add (`reg add`) instructions using a an elevated command line (cmd) prompt.
Your layout will be ready for use.
### Uninstall layouts
To **uninstall all keyboard layouts** follow these steps:
1. **Navigate** to `All Keyboard Layouts`;
2. **Run** `uninstall_keyboard_layouts.bat` batch file with **administrator privileges**.
All Apple keyboard layouts should be gone.
## Layout topics
### Layout languages
All keyboard layouts currently available:
- Belgian (Belgian (Apple)) (`BelgiumA.dll`)
- British (British (Apple)) - (`BritishA.dll`)
- Dutch (Dutch (Apple)) - (`DutchA.dll`)
- Finnish (Finnish (Apple)) - (`FinnishA.dll`)
- French (French (Apple)) - (`FrenchA.dll`)
- German (German (Apple)) - (`GermanA.dll`)
- Italian (Italian (Apple)) - (`ItalianA.dll`)
- Norwegian (Norwegian (Apple)) - (`NorwayA.dll`)
- Polish (Polish (Apple)) - (`PolishA.dll`)
- Portuguese (Portuguese (Apple)) - (`PortuguA.dll`)
- Russian (Russian (Apple)) - (`RussianA.dll`)
- Spanish (Spanish (Apple)) - (`SpanishA.dll`)
- Swedish (Swedish (Apple)) - (`SwedishA.dll`)
- Swiss (Swiss (Apple)) - (`SwissA.dll`)
- International English (International English (Apple)) - (`IntlEngA.dll`)
- USA (USA (Apple)) - (`USA.dll`)
- Chinese Traditional (??) - (`ChinaTA.dll`)
- Chinese Simplified (Chinese Simplified (Apple)) - (`ChinaSA.dll`)
- Turkish (Turkish (Apple)) - (`TurkeyA.dll`)
- Turkish Q (Turkish Q (Apple)) - (`TurkeyQA.dll`)
- Czech (Czech (Apple)) - (`CzechA.dll`)
- Hungarian (Hungarian (Apple)) - (`HungaryA.dll`)
**Note:** List schema: `Layout name` (`Layout name shown in Settings`) (`Corresponding DLL file`)
### Translate layout names
**Note:** You should only translate layout names if you're comfortable with **registry key instructions** and **batch files**, meaning you know what they do and/or what you're supposed to edit for them to work correctly.
To **translate layout names** do the following steps:
1. **Navigate** to `All Keyboard Layouts folder`;
2. **Open** `install_keyboard_layouts.bat` with your preferred editor;
3. **Edit** on each **language section** on the line containing `/v "Layout Text"` (usually is the first of the section) the part where you see the **name of the layout** in this format `LANGUAGE NAME (Apple)` (example: `Belgian (Apple)`);
4. **Save**.
When you install/reinstall layout names should be corrected.
## Questions and problem resolution
### Layouts don't get installed if i run the batch file as an administrator
**You could try:**
1. **Launch** a command line as an **administrator**;
2. **Navigate** to the layout folder using `cd` and the respective folder path;
3. **Execute** the batch file `.bat` from the command line.
### Layout doesn't show up in keyboard layouts
**You could try:**
- **Try to look for the english name** of the layout that's how the installation is set above like (**ex. "Belgian (Apple)"**);
- **Change the registry** add (`reg add`) instructions for your keyboard layout to your preferred name in the line where `/v` is "Layout Text", after `/d` should be the layout name like (ex.: `reg add "HKLM\SYSTEM\CurrentControlSet\Control\Keyboard Layouts\a0000809" /v "Layout Text" /t REG_SZ /d "BRI'ISH (Apple)"`);
- **Reinstall your keyboard layout** manually with the available instructions.
### I'm unable to bind, remap or reregister certain keys using x method
If you're trying to somehow **change certain key functions** from your keyboard, binding, rebinding, remapping, whatever and seem unable to, you might be running into the **drivers limitations** of the keyboard on Windows, that means **i don't have a solution**. As far as i've tried in the past i wasn't able to use PowerToys, AutoIt, C++, AutoHotKey, C#, etc to do it successfully. **Some keys don't appear to register** at all even if they work as originally intended, meaning to solve this you'll need to somehow **reverse engineer** and go through all the hoops of that kind of process to maybe find a solution that works. I can't help with this, sorry.
**Reference**, [Issue #1](https://github.com/supermarsx/magickeyboard/issues/1).
### Are these files legit?
They're **officially signed files from Apple** that you can check through the properties of each file, both DLL and executables. The only things that are **not official** are the **keyboard layout installer/uninstaller batch files** as well as the **file list** and the **old layout archive** containing a custom mapped pt-pt layout using the microsoft keyboard mapping tool thing many years ago.
### Screwed up badly?
Screwed up, deleted `system32` or something?
No warranty, **you're on your own**.
Good luck.
## Support, warranty, guarantees
- **Support only through issues** if i feel like it **with limitations**:
- These may be **accepted**:
- Open-source and/or verifiable additions;
- Issues with related functionality;
- Important undocumented issues or caveats;
- Other very high importance issues.
- These will be **rejected**:
- Screw up issues and/or help;
- Custom developments;
- Special requests.
- **No warranties**, explicit and/or implied;
- **No guarantees**, explicit and/or implied.