Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/borekb/macos-keyboards
Custom keyboards for macOS
https://github.com/borekb/macos-keyboards
Last synced: 29 days ago
JSON representation
Custom keyboards for macOS
- Host: GitHub
- URL: https://github.com/borekb/macos-keyboards
- Owner: borekb
- Created: 2019-09-21T19:58:47.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2021-11-17T18:11:07.000Z (almost 3 years ago)
- Last Synced: 2024-10-03T06:42:11.256Z (about 2 months ago)
- Size: 41 KB
- Stars: 4
- Watchers: 2
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# My macOS keyboard layouts
This repo contains two keyboard layouts, "Czech BB" and "English BB", created with [Ukelele](https://scripts.sil.org/ukelele).
## How to install
1. Copy the keyboard layouts to `/Library/Keyboard Layouts` (not `~/Library/Keyboard Layouts` since that would not allow them on the login screen and in password dialogs):
```
sudo cp -r Czech\ BB.bundle /Library/Keyboard\ Layouts
sudo cp -r English\ BB.bundle /Library/Keyboard\ Layouts
```
2. Add as Input Sources.
## 'English BB' customizations
- Moves ` (backtick) to the top left corner. The overwritten `§` symbol can be written with Alt.
- Moves `\` and `|` to the key next to the left Shift (where backtick originally was).
- `\` and `|` are still at their original location next to Enter.
- ❗️ `Cmd-\` shortcut doesn't work in [in VSCode](https://github.com/microsoft/vscode/issues/80697) or in Google Sheets, see this [Ukelele support thread](https://groups.google.com/forum/#!topic/ukelele-users/28lJPjzbpTQ) and [its conclusion](https://groups.google.com/d/msg/ukelele-users/28lJPjzbpTQ/w9sS_UolAgAJ). It only works with the original key (next to Enter).
| | U.S. | English BB |
| -- | -- | -- |
| | 
| 
|
| ⌥ | 
| 
|
| ⇧ | 
| 
|
> **Note**: this layout could also be built from 'British – PC', and you can find an attempt called 'English BB 2' in the repo history. The only change that needed to be done is to fix some Shift combinations: swap `@` and `"` and restore `#` to `Shift+3`.
## 'Czech BB' customizations
The general idea is to bring it closer to English U.S., incl. the two keys left to the backspace that are often used for zooming etc. This creates a "problem" for Czech accents, e.g., `mód` is now written as `m Alt- o d`.
Details:
- Moves ` to the top left corner. The overwritten `<` is near the right Shift (with Shift).
- Puts `/` to bottom right corner where `-` normally is. Many apps use `Cmd-/`.
- Moves `-` and `=` to their EN locations. This makes zooming in Chrome etc. work.
- The new location of `=` overwrites a "dead key comma", e.g. for writing `mód`. This now works with an Alt key (`Alt-=`).
- Accent for `ť` is at its original Czech location, i.e., `Shift-`, but it also works with Alt.
- Also moves `Alt--` (n-dash) so that it's at the same location as on the U.S. keyboard. This rewrites `°` dead key for which there's no new location (`ů` is still available at its normal location which is good enough).
| | Czech QWERTY | Czech BB |
| -- | -- | -- |
| | 
| 
| ⌥ | 
| 
|
| ⇧ | 
| 
|
### Chrome zooming with the Czech keyboard
According to Chrome's menu and documentation, it zooms via `Cmd-+`. However, that's not entirely true – on an U.S. keyboard, the key between backspace and `-` is not `+` but `=` so actually, `Cmd-=` is being pressed. Chrome somehow makes this work but it's undocumented (at least I couldn't find anything) and it doesn't work for the Czech BB layout even if the key next to backspace is the same `=` as on the U.S. layout.
(Maybe if I also re-mapped `+` to be above `=` as on US keyboard, that would work but I didn't try that.)
A way to fix this is to create a custom shortcut via system Keyboard preferences:
### Czech keyboard when Cmd is pressed
_(Under investigation.)_
U.S. keyboard is the same whether I have or haven't Cmd pressed:
However, Czech keyboard changes:
vs.
The goal is to modify Czech BB so that when Cmd is pressed, it looks exactly like U.S. It could solve a couple of issues with Chrome zoom, GDocs shortcuts and similar.
## How to make customizations
Get [Ukelele](https://scripts.sil.org/ukelele): `brew cask install ukelele`. Then:
1. Open an existing bundle or create a new one via **File** > **New From Current Input Source**.
2. Double-click the keyboard layout.
3. On the virtual keyboard, double-click a key you want to remap and enter a character.
4. Give it a name via **Set Keyboard Name and Script...** (this is a different thing than a filename!)
5. [Install](#how-to-install) the keyboard and test it.
6. Update this README – screenshots and [changelog](#changelog).
## Changelog
### 17 Jul 2018
Initial work on "U.S. - PC".
- Move ` (backtick) to the top left corner.
- The overwritten `§` symbol can be written with Alt.
- Move `\` and `|` to the key next to the left Shift (where backtick originally was).
- The keys are still at their original location next to Enter.
### 22 Feb 2019
Added "Czech - BB" layout.
- Move ` to the top left corner. The overwritten `<` is near the right Shift.
- Put `/` to bottom right corner where `-` normally is. Many apps use `Cmd-/`.
- Move `-` and `=` to their EN locations. This makes e.g. zooming in Chrome work.
- Move the dead key comma (e.g. for writing `mód`) to Alt+= (next to backspace)
- The new location of `=` overwrites a "dead key comma", e.g. for writing `mód`. This now works with an `Alt` key (`Alt-=`).
- Accent for `ť` is at its original Czech location, i.e., Shift+, but it also works with `Alt`.
- Also move `Alt--` (n-dash) so that it's on the same key. This rewrites `°` dead key for which I didn't bother to find a new location yet (`ů` is still on its normal location).
### 22 Sep 2019
- Create a Git repo, deprecate the original Google Drive folder.
- Try to make the `Cmd-\` keyboard shortcut work.
- It's not possible, a note with explanation has been added [above](#english-bb-customizations).
- Cleanup and rename the keyboards to 'Czech BB' and 'English BB'.
- Heavily update README.
## Other topics
Various notes gathered as I was working on the layouts.
### Resources
- [Awesome overview of Mac keyboard layouts](https://keyshorts.com/blogs/blog/37615873-how-to-identify-macbook-keyboard-localization)
- [A similar one from Apple](https://support.apple.com/en-us/HT201794)
### Dead keys
Each dead key has a "state" (which is just its name) and a terminator – a character that is either added to an applicable character (like `á`) or written before, like `'1` (numbers can't have accents). The terminator is also committed to the text when a Spacebar is pressed after it.
For Czech BB keyboard, which is a copy of Czech QWERTY, the dead keys are there but they need to be re-mapped. The following cheat sheet is useful for that (the state name / number is visible after double-clicking the key, for example, for `´`, Ukelele tells _Currently, it goes to state "1", which has terminator "'"_):
- 1: `´` ([acute](https://en.wikipedia.org/wiki/Acute_accent)) – next to backspace
- 2: `¨` ([umlaut](https://en.wikipedia.org/wiki/Diaeresis_(diacritic))) – next to enter
- 3: `ˇ` ([caron](https://en.wikipedia.org/wiki/Caron)) – `Shift+'`
- 4: `^` ([circumflex](https://en.wikipedia.org/wiki/Circumflex)) – `Alt+'`
- 5: `˚` ([overing](https://en.wikipedia.org/wiki/Ring_(diacritic))) – `Alt+-` (two keys next to backspace)
There are also some other ones with Alt+Shift but I never used them.
Now, for example, to move an acute to `Alt+`, it's important to honor the original state / name. So for example, in Ukelele:
1. Press the modified (Alt) and double click the key
2. On the Change State tab, enter 1.
3. Click OK. The key should automatically update to acute (remember that the dead key definition already exists, we're only assigning it to a specific key and a modifier) and when you open the dialog again, it should say _Currently, it goes to state "1", which has terminator "'"_.
### U.S. vs British - PC
| | U.S. | British - PC |
| -- | -- | -- |
| | | 
|
| ⌥ | | 
|
| ⇧ | | 
|