Trên GitHub, jtroo/kanata đã đạt 8.1k sao, nhóm Backend, ngôn ngữ Rust. Improve keyboard comfort and usability with advanced customization
Tóm tắt dựng từ metadata GitHub của chính dự án — chưa có bài review TopGit. Trang sẽ tự động cập nhật khi bài review đầy đủ được xuất bản.
VÌ SAO CHƯA CÓ REVIEW
TopGit viết bài đầy đủ cho repo có nhiều sao nhất và được yêu cầu nhiều nhất. Trang này là snapshot trong thời gian chờ — xem README gốc ở tab READ ME.
To see all of the features, see the configuration guide.
You can find pre-built binaries in the releases page
or read on for build instructions.
You can see a list of known issues here.
Demo
Demo video
Showcase of multi-layer functionality (30s, 1.7 MB).
Online simulator
You can check out the online simulator
to test configuration validity and test input simulation.
Why is this useful?
Imagine if, instead of pressing Shift to type uppercase letters, we had giant
keyboards with separate keys for lowercase and uppercase letters. I hope we can
all agree: that would be a terrible user experience!
A way to think of how Shift keys work is that they switch your input to another
layer of functionality where you now type uppercase letters and symbols
instead of lowercase letters and numbers.
What kanata allows you to do is take this alternate layer concept that Shift
keys have and apply it to any key. You can then customize what those layers do
to suit your exact needs and workflows.
Usage
Running kanata currently does not start it in a background process.
You will need to keep the window that starts kanata running to keep kanata active.
Some tips for running kanata in the background:
See the
releases page
for executables and instructions.
Build it yourself
This project uses the latest Rust stable toolchain. If you installed the
Rust toolchain using rustup, e.g. by using the instructions from the
official website,
you can get the latest stable toolchain with rustup update stable.
Instructions
Using cargo install:
cargo install kanata
# On Linux and macOS, this may not work without `sudo`, see below
kanata --cfg <your_configuration_file>
Build and run yourself in Linux:
git clone https://github.com/jtroo/kanata && cd kanata
cargo build # --release optional, not really perf sensitive
# sudo is used because kanata opens /dev/ files
#
# See below if you want to avoid needing sudo:
# https://github.com/jtroo/kanata/wiki/Avoid-using-sudo-on-Linux
sudo target/debug/kanata --cfg <your_configuration_file>
Build and run yourself in Windows.
git clone https://github.com/jtroo/kanata; cd kanata
cargo build # --release optional, not really perf sensitive
target\debug\kanata --cfg <your_configuration_file>
Build and run yourself in macOS:
First install the Karabiner driver by following the macOS documentation
in the releases page.
Then you can compile and run with the instructions below:
git clone https://github.com/jtroo/kanata && cd kanata
cargo build # --release optional, not really perf sensitive
# sudo is needed to gain permission to intercept the keyboard
sudo target/debug/kanata --cfg <your_configuration_file>
The full configuration guide is found here.
Sample configuration files are found in cfg_samples. The
simple.kbd file contains a basic configuration file
that is hopefully easy to understand but does not contain all features. The
kanata.kbd contains an example of all features with documentation. The
release assets also have a kanata.kbd file that is tested to work with that
release. All key names can be found in the keys module,
and you can also define your own key names.
Feature flags
When either building yourself or using cargo install,
you can add feature flags that
enable functionality that is turned off by default.
Instructions
If you want to enable the cmd actions,
add the flag --features cmd.
For example:
Live reloading of the configuration for easy testing of your changes.
Multiple layers of key functionality
Advanced actions such as tap-hold, unicode output, dynamic and static macros
Vim-like leader sequences to execute other actions
Optionally run a TCP server to interact with other programs
Other programs can respond to layer changes or trigger layer changes
Interception driver support (use kanata_wintercept.exe)
Note that this issue exists, which is outside the control of this project:
https://github.com/oblitum/Interception/issues/25
Contributing
Contributions are welcome!
Unless explicitly stated otherwise, your contributions to kanata will be made
under the LGPL-3.0-only* license.
Some directories are exceptions:
keyberon: MIT License
interception: MIT or Apache-2.0 Licenses
Here's a basic low-effort design doc of kanata
How you can help
Try it out and let me know what you think. Feel free to file an issue or
start a discussion.
Usability issues and unhelpful error messages are considered bugs that should
be fixed. If you encounter any, I would be thankful if you file an issue.
Browse the open issues and help out if you are able and/or would like to. If
you want to try contributing, feel free to ping jtroo for some pointers.
If you know anything about writing a keyboard driver for Windows, starting an
open-source alternative to the Interception driver would be lovely.
Community projects related to kanata
vscode-kanata: Language support for kanata configuration files in VS Code
komokana: Automatic application-aware layer switching for komorebi (Windows)
kanata-tray: Control kanata from a tray icon
OverKeys: Visual layer display for kanata - see your active layers and keymaps in real-time (Windows)
Glide: detect touchpad gestures to integrate with Kanata virtual keys (Linux)
Application-aware layer switching:
qanata (Linux)
kanawin (Windows)
window_tools (Windows)
nata (Linux)
kanata-vk-agent (macOS)
hyprkan (Linux)
kanata-switcher (Linux, all DEs)
kwanata (Linux-KDE): A KDE Plasma companion for Kanata - Automatically activates Kanata's layers/virtualkeys and launches or raises apps.
What does the name mean?
I wanted a "k" word since this relates to keyboards. According to Wikipedia,
kanata is an indigenous Iroquoian word meaning "village" or "settlement" and is
the origin of Canada's name.
There's also PPT✧.
Motivation
TLDR: QMK features but for any keyboard, not just fancy mechanical ones.
Long version
I have a few keyboards that run QMK. QMK allows the
user to customize the functionality of their keyboard to their heart's content.
One great use case of QMK is its ability map keys so that they overlap with the
home row keys but are accessible on another layer. I won't comment on
productivity, but I find this greatly helps with my keyboard comfort.
For example, these keys are on the right side of the keyboard:
7 8 9
u i o
j k l
m , .
On one layer I have arrow keys in the same position, and on another layer I
have a numpad.
One could add as many customizations as one likes to improve comfort, speed,
etc. Personally my main motivator is comfort due to a repetitive strain injury
in the past.
However, QMK doesn't run everywhere. In fact, it doesn't run on most
hardware you can get. You can't get it to run on a laptop keyboard or any
mainstream office keyboard. I believe that the comfort and empowerment QMK
provides should be available to anyone with a computer on their existing
hardware, instead of having to purchase an enthusiast mechanical keyboard
(which are admittedly very nice — I own a few — but can be costly).
The best alternative solution that I found for keyboards that don't run QMK was
kmonad. This is an excellent project
and I recommend it if you want to try something similar.
The reason for this project's existence is that kmonad is written in Haskell
and I have no idea how to begin contributing to a Haskell project. From an
outsider's perspective I think Haskell is a great language but I really can't
wrap my head around it. And there are a few outstanding issues
at the time of writing that make kmonad suboptimal for my personal workflows.
This project is written in Rust because Rust is my favourite programming
language and the prior work of the awesome keyberon crate
exists.
Similar Projects
The most similar project is kmonad,
which served as the inspiration for kanata. Here's a comparison document.
Other similar projects:
QMK: Open source keyboard firmware
keyberon: Rust #[no_std] library intended for keyboard firmware
ktrl: Linux-only keyboard customizer with layers, a TCP server, and audio support
kbremap: Windows-only keyboard customizer with layers and unicode
karabiner-elements: Mac-only keyboard customizer
capsicain: Windows-only key remapper with driver-level key interception
keyd: Linux-only key remapper very similar to QMK, kmonad, and kanata
xremap: Linux-only application-aware key remapper inspired more by Emacs key sequences vs. QMK layers/Vim modes
keymapper: Context-aware cross-platform key remapper with a different transformation model (Linux, Windows, Mac)
mouseless: Linux-only mouse-focused key remapper that also has layers, key combo and tap-hold capabilities
Why the list?
While kanata is the best tool for some, it may not be the best tool for
you. I'm happy to introduce you to tools that may better suit your needs. This
list is also useful as reference/inspiration for functionality that could be
added to kanata.
Donations/Support?
The author (jtroo) will not accept monetary donations for work on kanata.
Please instead donate your time and/or money to charity.
Some links are below. These links are provided for learning and as interesting
reads. They are not an endorsement.
Trang TopGit này là một snapshot — tab "Readme" hiển thị nguyên văn README của repo (đã bỏ link, giữ ảnh). Repo GitHub ở github.com/jtroo/kanata là nguồn chính thức.
jtroo/kanata có bao nhiêu sao?
jtroo/kanata có 8.1k sao GitHub — tải lại trang để xem số mới nhất, hoặc xem trực tiếp github.com/jtroo/kanata. TopGit phản chiếu số sao của GitHub nhưng không cam kết đến từng phút.
jtroo/kanata có những chủ đề gì?
GitHub topics của jtroo/kanata: "cross-platform", "interception-driver", "keyboard", "keyboard-layout", "linux", "macos", "mouse", "mouse-emulation", "rust", "windows". TopGit xếp repo vào nhóm Backend.
jtroo/kanata có website riêng không?
TopGit chưa ghi nhận URL trang chủ cho jtroo/kanata. Phần README ở tab phía trên thường có link demo, hoặc xem mô tả GitHub của repo.
jtroo/kanata còn đang phát triển không?
Commit gần nhất trên jtroo/kanata là 3 tháng trước (theo timestamp GitHub). Repo có 314 fork — một chỉ báo về mức độ quan tâm của cộng đồng.
jtroo/kanata dùng license gì?
jtroo/kanata phát hành theo license LGPL-3.0. Nên mở file LICENSE trên GitHub để xác nhận — license metadata đôi khi lệch với thực tế dự án.
jtroo/kanata viết bằng ngôn ngữ gì?
jtroo/kanata chủ yếu viết bằng Rust. Trường "language" của GitHub dựa trên phần lớn byte ở nhánh mặc định.
Đọc đầy đủ README ở tab phía trên.
Chưa chắc kanata có hợp với bạn?
Để ChatGPT, Claude hoặc Perplexity tìm hiểu giúp — bấm bên dưới và xem AI nói gì về kanata.