macOS
Homebrewverified · 100%
brew install kanata-traylocal Homebrew formula metadata
brew / rank 7477
Install kanata-tray with Homebrew
System tray for kanata keyboard remapper. Version 0.8.0 via Homebrew; verified 2026-10-31.
install
Additional install commands
overview
Package summary
System tray for kanata keyboard remapper
Project links
Commands and aliases
- kanata-tray
history
Project history and usage
Kanata Tray is a desktop tray wrapper for the Kanata keyboard remapper. It gives Kanata users start, stop, pause, preset switching, layer icons, hooks, and multi-instance control from a tray icon instead of a terminal process.
Project history
The repository was created on 2024-02-07 and v0.1.0 was published on 2024-02-09. The README describes it as a simple wrapper for Kanata that works on Windows, Linux, and macOS.
The project exists because Kanata itself is primarily a keyboard-remapping engine and CLI. Kanata Tray fills the desktop-control gap, while its README notes that Kanata later gained Windows-only native tray-app support and links to a comparison issue.
Adoption history
Adoption is tied directly to Kanata users who want visible runtime state, quick profile switching, or a friendlier way to start and stop remapping. Homebrew packaging makes the wrapper installable on macOS alongside the `kanata` package.
How it is used
Kanata Tray can run without initial configuration and can generate a TOML configuration file on first run. Users define presets that point at Kanata executables and configuration files, then switch or autorun those presets from the tray.
Why package nerds care
Kanata Tray is a small example of a companion GUI-ish package around a lower-level CLI daemon. The package is not historically broad, but it matters to desktop package catalogs because it turns a powerful keyboard remapper into something a normal workstation session can supervise.
Timeline
- 2024: rszyma/kanata-tray repository created and v0.1.0 released.
- 2025: v0.8.0 release added hook-related changes and shutdown fixes.
- 2025: README documented Kanata v1.6.0 as the minimum supported Kanata version.
Related projects
- Kanata is the keyboard remapper that Kanata Tray controls.
- Kanata's Windows-only tray support is adjacent but does not replace Kanata Tray's cross-platform wrapper role.
Sources
security posture
Risk level: green
narrow executable package without higher-risk signals.
Risk classifier
green risk · low confidence · appliance
Why
- narrow executable package without higher-risk signals
Signals
- metadata:no-higher-risk-signals
Install behavior
- No Homebrew post-install hook is recorded in formula metadata.
- Homebrew bottle metadata is available for 7 platform targets.
- Build metadata lists 2 build dependencies.
Recommended review
Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.
local files
Configuration and credential file locations
These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.
Configuration files
Config paths the tool may read or write during local use.
- Linux
~/.config/kanata-tray/kanata-tray.toml<kanata-tray executable directory>/kanata-tray.toml$KANATA_TRAY_CONFIG_DIR/kanata-tray.toml- macOS
~/Library/Application Support/kanata-tray/kanata-tray.toml<kanata-tray executable directory>/kanata-tray.toml$KANATA_TRAY_CONFIG_DIR/kanata-tray.toml- Windows
C:\Users\<YourUsername>\AppData\Roaming\kanata-tray\kanata-tray.toml<kanata-tray executable directory>\kanata-tray.toml%KANATA_TRAY_CONFIG_DIR%\kanata-tray.toml
executables
Installed executables
| Command | Kind | Exposure | Note |
|---|---|---|---|
kanata-tray | cli | global executable |
freshness
Version and freshness
These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.
page generated2026-11-04
manager version0.8.0
manager updated2026-10-31
local dataok
upstreamcurrent
latest detectedv0.8.0
https://github.com/rszyma/kanata-tray
- okNo freshness warnings were generated.
install metadata
Package metadata
| Package key | brew:kanata-tray |
|---|---|
| Version | 0.8.0 |
| Package manager | Homebrew |
| Package manager page | https://formulae.brew.sh/formula/kanata-tray |
| Homepage | https://github.com/rszyma/kanata-tray |
| Repository | https://github.com/rszyma/kanata-tray |
| License | GPL-3.0-or-later |
| Source archive | https://github.com/rszyma/kanata-tray/archive/refs/tags/v0.8.0.tar.gz |
| Last updated | 2026-10-31T16:06:08+09:00 |
| Pulse | updated |
| Build dependencies | go, pkgconf |
| Bottle | available (on arm64_golden_gate, arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux) |
| Homebrew post-install | not defined |
| Service | none declared |
registry facts
Source database details
| Source Database | Homebrew formula API |
|---|---|
| Tap | homebrew/core |
| Full Name | kanata-tray |
| 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 |
|
source trail
Generated from repository data
This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.
Combined YAML source
View the package source record on GitHub.
Used sources
- Geiger risk classifier
- cross-ecosystem install command graph
- curated configuration and credential file locations
- curated package history
- package relationship graph
- package version freshness
- package-page enrichment
- pkg.so package database
- pkgdb category and tag curation