Skip to content

Commit

Permalink
README — Add macOS Homebrew install instructions
Browse files Browse the repository at this point in the history
  • Loading branch information
devnoname120 committed Sep 6, 2022
1 parent 6829488 commit 23557c1
Showing 1 changed file with 10 additions and 2 deletions.
12 changes: 10 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -58,19 +58,27 @@ Download the [QWERTY-fr layout](https://github.com/qwerty-fr/qwerty-fr/releases/

### Mac

**Using Homebrew (package manager)**

If [homebrew]([url](https://brew.sh/)) is installed on your Mac, you can simply run the following command in the terminal:
```
brew install qwerty-fr
```
Then to `System Preferences``Keyboard`, click `+`, scroll down to `Others` and add `qwerty-fr`. Then restart macOS.

**Automatic install**:

- Download the [QWERTY-fr layout](https://github.com/qwerty-fr/qwerty-fr/releases/latest) PKG.
- Do a right click on it and then click on `Open`. Follow the installation process.
- Go to `System Preferences` > `Keyboard`, click `+`, scroll down to `Others` and add `qwerty-fr`.
- Go to `System Preferences` `Keyboard`, click `+`, scroll down to `Others` and add `qwerty-fr`.
- Restart macOS (if you don't some characters won't work).

**Manual install**:

- Download the [QWERTY-fr layout](https://github.com/qwerty-fr/qwerty-fr/releases/latest) ZIP file and extract **qwerty-fr.bundle** to:
- `/Library/Keyboard Layouts/` to install for all users.
- `~/Library/Keyboard Layouts/` for user-local installation.
- Go to `System Preferences` > `Keyboard`, click `+`, scroll down to `Others` and add `qwerty-fr`.
- Go to `System Preferences` `Keyboard`, click `+`, scroll down to `Others` and add `qwerty-fr`.
- Restart macOS (if you don't some characters won't work).

**✅ Protip**: On Apple keyboards the right <kbd>Option ⌥</kbd> key is often hard to access. You can use [Karabiner-Elements](https://pqrs.org/osx/karabiner/) to swap the right <kbd>Option ⌥</kbd> key with the right <kbd>Command ⌘</kbd> key. [Here is the rule](https://ke-complex-modifications.pqrs.org/#swap_right_cmd_with_right_option) you'll need to import in Karabiner-Elements. This makes it easier to type characters!
Expand Down

0 comments on commit 23557c1

Please sign in to comment.