https://github.com/yuja/hhkb-studio-tools

Linux tool to modify HHKB Studio keymap
https://github.com/yuja/hhkb-studio-tools

hhkb hhkb-studio hidraw keymap linux

Last synced: about 1 month ago
JSON representation

Linux tool to modify HHKB Studio keymap

• Host: GitHub
• URL: https://github.com/yuja/hhkb-studio-tools
• Owner: yuja
• License: mit
• Created: 2024-01-16T15:04:23.000Z (12 months ago)
• Default Branch: master
• Last Pushed: 2024-03-05T13:37:13.000Z (10 months ago)
• Last Synced: 2024-10-20T20:19:34.467Z (2 months ago)
• Topics: hhkb, hhkb-studio, hidraw, keymap, linux
• Language: Rust
• Homepage:
• Size: 54.7 KB
• Stars: 10
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
Linux tool to modify HHKB Studio keymap

=======================================

Usage

-----

1. Find `/dev/hidraw*` device to communicate and adjust permission

```shell

$ sudo setfacl -m u:$USER:rw /dev/hidraw1

```

2. Query the keyboard to see if the communication channel works

```shell

$ hhkb-studio-tools info

Product name: HHKB-Studio

...

```

3. Fetch the current keymap data (of the current profile)

```shell

$ hhkb-studio-tools read-profile > profile.toml

```

4. Show the fetched keymap data and modify it by using text editor

```shell

$ hhkb-studio-tools show-profile < profile.toml

```

- The keymap data consists of four layers (Base, Fn1, Fn2, and Fn3.)

- Each layer is 240 bytes (15 keys x 8 rows with some blank entries.)

5. Load the modified keymap data to the keyboard

```shell

$ hhkb-studio-tools write-profile < profile_new.toml

```