Bépo Keyboard

BÉPO

╭────────┬───────┬───────┬───────┬───────┬───────╮ ╭───────┬────────┬───────┬───────┬───────┬───────╮
| TAB    |  b    |  é    |  p    |  o    |  è    | |  ^    |  v     |  d    |  l    |  j    |  z    |
├────────┼───────┼───────┼───────┼───────┼───────┤ ├───────┼────────┼───────┼───────┼───────┼───────┤
|ESC👇SHT|  a    |  u    |  i    |  e    |  ,    | |  c    |  t     |  s    |  r    |  n    |  m    |
├────────┼───────┼───────┼───────┼───────┼───────┤ ├───────┼────────┼───────┼───────┼───────┼───────┤
|CTR🕺SHT|  w    |  y    |  x    |  .    |  k    | |  '    |  q     |  g    |  h    |  f    |SHT🕺CTR|
╰────────┴───────┴───────┼───────┼───────┼───────┤ ├───────┼────────┼───────┼───────┴───────┴───────╯
                         | ALT   | SPC   | BSP   | | RALT  |ENT👇RSE| LWR   |
                         ╰───────┴───────┴───────╯ ╰───────┴────────┴───────╯

LOWER

╭───────┬───────┬───────┬───────┬───────┬───────╮ ╭───────┬───────┬───────┬───────┬───────┬───────╮
| TAB   |  "    |  «    |  »    |  (    |  )    | |  @    |  +    |  -    |  /    |  *    |  =    |
├───────┼───────┼───────┼───────┼───────┼───────┤ ├───────┼───────┼───────┼───────┼───────┼───────┤
| BTCLR |       | HOME  | PGDWN | PGUP  |  END  | |  LEFT |  DOWN |  UP   | RIGHT |       |       |
├───────┼───────┼───────┼───────┼───────┼───────┤ ├───────┼───────┼───────┼───────┼───────┼───────┤
| CTRL  |       |       |       |       |       | |       |       |       |       |       |       |
╰───────┴───────┴───────┼───────┼───────┼───────┤ ├───────┼───────┼───────┼───────┴───────┴───────╯
                        | LWR   |  _    | BSP   | | RALT  | ENT   | LWR   |
                        ╰───────┴───────┴───────╯ ╰───────┴───────┴───────╯

RAISE

╭───────┬───────┬───────┬───────┬───────┬───────╮ ╭───────┬───────┬───────┬───────┬───────┬───────╮
| $     |  1    |  2    |  3    |  4    |  5    | |  6    |  7    |  8    |  9    |  0    |  °    |
├───────┼───────┼───────┼───────┼───────┼───────┤ ├───────┼───────┼───────┼───────┼───────┼───────┤
| ESC   |  à    |       |       |       |       | |  ç    |       |       |       |       |  %    |
├───────┼───────┼───────┼───────┼───────┼───────┤ ├───────┼───────┼───────┼───────┼───────┼───────┤
| CTRL  |  à    |       |       |       |       | |       |       |       |       |       |       |
╰───────┴───────┴───────┼───────┼───────┼───────┤ ├───────┼───────┼───────┼───────┴───────┴───────╯
                        |       |  _    | BSP   | | RALT  | ENT   |       |
                        ╰───────┴───────┴───────╯ ╰───────┴───────┴───────╯

Tap dance

Tap tap hold

├────────────────┼─.─┼─.─┼─.─┼─.─┼─.─┤ ├─────────────┼───────────┼─.─┼─.─┼─.─┼───────────────┤
| LCTRL 🕺 LSHT  | . | . | . | . | . | |  '          |  q        | . | . | . | RSHT 🕺 RCTRL  |
╰────────────────┴─.─┴─.─┼─.─┼─.─┼─.─┤ ├─────────────┼───────────┼─.─┼─.─┴─.─┴───────────────╯
                         | . | . | . | | LALT −> GUI | ENT👇RSE  | . |
                         ╰─.─┴─.─┴─.─╯ ╰─────────────┴───────────┴─.─╯

Combos

╭────┬────┬────┬────┬────┬────╮ ╭────┬────┬────┬────┬────┬────╮
|  0 |  1 |  2 |  3 |  4 |  5 | |  6 |  7 |  8 |  9 | 10 | 11 |
├────┼────┼────┼────┼────┼────┤ ├────┼────┼────┼────┼────┼────┤
| 12 | 13 | 14 | 15 | 16 | 17 | | 18 | 19 | 20 | 21 | 22 | 23 |
├────┼────┼────┼────┼────┼────┤ ├────┼────┼────┼────┼────┼────┤
| 24 | 25 | 26 | 27 | 28 | 29 | | 30 | 31 | 32 | 33 | 34 | 35 |
╰────┴────┴────┼────┼────┼────┤ ├────┼────┼────┼────┴────┴────╯
               | 36 | 37 | 38 | | 39 | 40 | 41 |
               ╰────┴────┴────╯ ╰────┴────┴────╯

Left Combos

╭────┬────╮
| 15 | 16 | -> DELETE
╰────┴────╯
╭────┬────╮
| 13 | 16 | -> RETURN LEFT
╰────┴────╯

Right Combos

╭────┬────╮
|  6 | 22 | -> w
╰────┴────╯
╭────┬────╮
| 30 | 22 | -> LEFT GUI
╰────┴────╯

Left Right Combos

╭────┬────╮           ╭────┬────╮
|  1 | 33 | -> F1 ... | 11 | 33 | -> F11
╰────┴────╯           ╰────┴────╯
╭────┬────╮             ╭────┬────╮
|  1 | 30 | -> BT1 ...  |  4 | 30 | -> BT4
╰────┴────╯             ╰────┴────╯

Instructions

1. Log into, or sign up for, your personal GitHub account.
2. Fork this repository to your local computer, and then push it to your GitHub personal account. (instructions)
3. Edit the keymap file(s) to suit your needs:
   • Change the keymap file to edit keycodes, add new layers etc.
   • Change the conf file to edit configuration settings like changing the deep sleep timeout
4. Commit and push your changes to your personal repo. Upon pushing it, GitHub Actions will start building a new version of your firmware with the updated keymap.

Note

After forking the repo to your own account, you can also edit the files directly using the GitHub web interface via the edit button on the top right (keyboard shortcut e) or via the GitHub Dev interface (keyboard shortcut .) and commit your changes.

Firmware Files

To locate your firmware files...

1. Log into GitHub and navigate to your personal config repository you just uploaded your keymap changes to.
2. Click "Actions" in the main navigation, and in the left navigation click the "Build" link.
3. Select the desired workflow run in the centre area of the page (based on date and time of the build you wish to use). You can also start a new build from this page by clicking the "Run workflow" button.
4. After clicking the desired workflow run, you should be presented with a section at the bottom of the page called "Artifacts". This section contains the results of your build, in a file called "firmware.zip"
5. Download the firmware zip archive and extract the two .uf2 files. They are named according to which side they need to be flashed to.
6. Flash the firmware to your keyboard by double-clicking the reset button to put the it in bootloader mode. A window should pop up showing the contents of the storage on the keyboard. Drag and drop the correct .uf2 file into the window. When the upload is complete the window will close and the keyboard will exit bootloader mode.
   • If you only changed the keymap file you only need to flash the left side firmware to the left side.
   • If you changed the conf file you should flash both sides their respective files.

Your keyboard is now ready to use.