# 使用 Homebrew, Nix, scoop 安装 kanata

查看 kanata 的安装路径、可执行文件、元数据以及面向 AI 代理工作流的安全说明。

## 安装

```sh
sudo av install brew:kanata
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install kanata
```

  证据: local Homebrew formula metadata

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#kanata
```

  证据: nixpkgs package indexes: pkgs/by-name/ka/kanata/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

### Windows

- Scoop (92%):

```sh
scoop install extras/kanata
```

  证据: Scoop official bucket manifest trees: bucket/kanata.json from https://api.github.com/repos/ScoopInstaller/Extras/git/trees/master?recursive=1

## 软件包事实

- **软件包键:** brew:kanata
- **软件包管理器:** Homebrew
- **软件包管理器页面:** <https://formulae.brew.sh/formula/kanata>
- **版本:** 1.12.0
- **来源摘要:** Cross-platform software keyboard remapper for Linux, macOS and Windows
- **主页:** <https://github.com/jtroo/kanata>
- **仓库:** <https://github.com/jtroo/kanata>
- **上游文档:** <https://github.com/jtroo/kanata#readme>
- **许可证:** LGPL-3.0-only
- **源码归档:** <https://github.com/jtroo/kanata/archive/refs/tags/v1.12.0.tar.gz>
- **最后更新:** 2026-07-05T09:17:54Z
- **已生成:** 2026-07-08T18:08:21+00:00

## 可执行文件

- kanata (cli)
- kanata (别名)

## 构建依赖

- rust

## 安装行为

- post-install 钩子: 未定义
- 服务: declared
- Bottle: 可用 于 arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## 版本和新鲜度

- 页面生成时间: 2026-07-08
- 管理器版本: 1.12.0
- 管理器更新时间: 2026-07-05
- 本地数据: OK
- 上游仓库: https://github.com/jtroo/kanata
- 检测到的最新版本: v1.12.0 (当前)
## 项目历史与用法

Kanata is a cross-platform software keyboard remapper for Linux, macOS, and Windows. It brings firmware-style keyboard features such as layers, tap-hold behavior, macros, unicode output, and leader sequences into a user-space program configured with Lisp-like S-expressions.

### 项目历史

The GitHub repository was created on 2022-04-18, and v0.1.1 was published on 2022-04-24. A July 2022 Rust community announcement for v1.0.5 described it as an advanced keyboard remapper for Windows and Linux and explicitly compared its use case to QMK and KMonad.

The README frames the project around keyboard comfort and usability: users can apply the idea of Shift-style alternate layers to arbitrary keys, then customize those layers for personal workflows. The configuration guide documents the S-expression format that defines source keys, aliases, layers, and behavior.

By 2026-07-01, Kanata had grown into a mature workstation utility with prebuilt release binaries, Cargo installation, platform notes, sample configurations, optional TCP server behavior, Interception driver support on Windows, and companion tooling such as Kanata Tray.

### 采用历史

Kanata's adoption is driven by people who want programmable-keyboard behavior on ordinary laptop or desktop keyboards. The README's Repology badge and batch package metadata show distribution through package systems such as Homebrew, Nix, and Scoop, while Cargo remains the native Rust installation path.

Its cross-platform design distinguishes it from platform-specific remappers and from firmware projects that require programmable keyboard hardware. That makes it attractive to users who move layouts between operating systems or who want home-row mods and layers on built-in laptop keyboards.

### 使用方式

Users run `kanata --cfg <configuration-file>` with a `.kbd` configuration. On Linux and macOS, extra privileges or platform drivers may be needed because Kanata intercepts keyboard input; the README points to platform-specific setup discussions and release instructions.

Common configurations define base and alternate layers, tap-hold keys, macros, unicode actions, and leader sequences. The official configuration guide and sample files serve as the main learning path.

### 为什么软件包爱好者会关心

Kanata is package-nerd notable because it packages a hardware-keyboard customization culture as cross-platform user-space software. It sits between firmware projects such as QMK, Linux input-layer tools, macOS keyboard utilities, and Windows interception-driver workflows.

It also carries the operational concerns package maintainers care about: privileged input access, platform-specific drivers, release assets, sample configs, and companion tray wrappers.

### 时间线

- 2022: jtroo/kanata repository created and first GitHub releases published.
- 2022: v1.0.5 announced as an advanced Windows and Linux keyboard remapper in the Rust community.
- 2024: Configuration and platform discussions show active use across macOS, Linux, and Windows.
- 2026: v1.11.0 release published on GitHub.

### Related projects

- QMK and KMonad are related keyboard-customization projects referenced in Kanata community material.
- Kanata Tray is a companion tray wrapper for starting, stopping, and switching Kanata configurations.
- The Karabiner driver and Interception driver are platform-adjacent pieces for macOS and Windows input interception workflows.

### 来源

- <https://api.github.com/repos/jtroo/kanata>
- <https://github.com/jtroo/kanata>
- <https://github.com/jtroo/kanata/blob/main/docs/config.adoc>
- <https://github.com/jtroo/kanata/releases>
- <https://github.com/rszyma/kanata-tray>
- <https://www.reddit.com/r/rust/comments/w0zqk4/kanata_v105_an_advanced_keyboard_remapper_for/>


## 安全说明

formula declares a Homebrew service.

- **Geiger 风险:** orange / 中
- formula declares a Homebrew service

## 源数据库详情

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** kanata
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable

## 其他软件包管理器记录

- Nix - kanata: normalized package name match | nixpkgs package indexes: pkgs/by-name/ka/kanata/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- Scoop - extras/kanata: normalized package name match | Scoop official bucket manifest trees: bucket/kanata.json from https://api.github.com/repos/ScoopInstaller/Extras/git/trees/master?recursive=1


## 相关链接

- [Source-control packages](https://www.automicvault.com/zh-hans/pkg/source-control-tools/) - Belongs to a source-control command family.
- [Secret-risk packages](https://www.automicvault.com/zh-hans/pkg/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals.
- [Terminal utility packages](https://www.automicvault.com/zh-hans/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://www.automicvault.com/zh-hans/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [rust](https://www.automicvault.com/zh-hans/pkg/brew/rust/) - Build dependency declared by Homebrew.
- [kanata-tray](https://www.automicvault.com/zh-hans/pkg/brew/kanata-tray/) - Shares av.db curated category or tags: cli, input, keyboard, system.
- [libxkbcommon](https://www.automicvault.com/zh-hans/pkg/brew/libxkbcommon/) - Shares av.db curated category or tags: cli, input, keyboard, system.
- [kbt](https://www.automicvault.com/zh-hans/pkg/brew/kbt/) - Shares av.db curated category or tags: cli, input, keyboard, system.
- [xmodmap](https://www.automicvault.com/zh-hans/pkg/brew/xmodmap/) - Shares av.db curated category or tags: cli, input, keyboard, system.
- [xkbcomp](https://www.automicvault.com/zh-hans/pkg/brew/xkbcomp/) - Shares av.db curated category or tags: cli, keyboard, system.
- [showkey](https://www.automicvault.com/zh-hans/pkg/brew/showkey/) - Shares av.db curated category or tags: cli, input, keyboard, system.
- [augeas](https://www.automicvault.com/zh-hans/pkg/brew/augeas/) - Shares av.db curated category or tags: cli, configuration, system.
- [borgmatic](https://www.automicvault.com/zh-hans/pkg/brew/borgmatic/) - Shares av.db curated category or tags: cli, configuration, system.
- [keyspy](https://www.automicvault.com/zh-hans/pkg/npm/keyspy/) - Local package facts share a topical domain. Shared terms: cli, cross, cross-platform, input, keyboard.

## Combined YAML source

View the package source record on GitHub. [combined/kanata.yml](https://github.com/automic-vault/db/blob/main/combined/kanata.yml)


## 来源

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph
