Skip to content

Releases: higor-prado/keyrs

v0.2.1

14 Feb 00:14

Choose a tag to compare

keyrs 0.2.1

First public release of keyrs - a pure Rust keyboard remapper for Wayland.

What is keyrs?

keyrs lets you remap keyboard shortcuts on Wayland compositors. It's designed for users who want consistent shortcuts across applications, especially those with macOS/Command-key muscle memory.

Features

  • Pure Rust - Single binary, no Python or heavy dependencies
  • Wayland native - Works with evdev and uinput
  • Application-aware - Different keymaps per application (requires compositor support)
  • Profile system - Pre-built profiles for common use cases (VS Code, terminal, etc.)
  • Interactive install/uninstall - Guided setup with optional component removal
  • Systemd integration - Runs as a user service
  • TUI included - Terminal UI for monitoring and control

Installation

# Build from source
cargo install --path .

# Install service
~/.local/bin/keyrs-service install
~/.local/bin/keyrs-service start

Configuration

Config lives at ~/.config/keyrs/config.toml . See the docs /docs/ for syntax reference and examples.

What's Changed

• Interactive uninstall with optional removal prompts
• Use CARGO_PKG_VERSION for automatic version sync
• Documentation improvements

Full Changelog: https://github.com/higorprado/keyrs/commits/v0.2.1

v0.2.0

13 Feb 23:07

Choose a tag to compare

v0.2.0 Pre-release
Pre-release

New Features

Profile System

11 pre-made configuration profiles for different use cases:

Profile Description
mac-standard macOS migrants - Super key behaves like Cmd
mac-power Full macOS experience with app-specific optimizations
developer IDE and terminal optimized, vim-friendly
gamer Minimal remapping to avoid game conflicts
ergonomic Reduce finger strain - Caps→Esc/Ctrl
minimal Essential shortcuts only
windows-standard Windows migrants - familiar Ctrl behavior
chromebook Chrome OS style keyboard layout
accessibility Simplified keyboard with sticky keys support
writer Content creation focus
none Empty slate - no remapping

Service Management

New keyrs-service commands:

keyrs-service list-profiles          # List available profiles
keyrs-service show-profile <name>    # Show profile details
keyrs-service profile-set <name>     # Set active profile
keyrs-service profile-select         # Interactive selection
keyrs-service apply-config           # Compose and validate config

## Improvements

• Colorized output with  --color  option (auto/always/never)
• Respects  NO_COLOR  environment variable
• Profiles work after installation (runtime mode)
• Confirmation prompts with  --yes  to skip
•  --dry-run  mode for testing

## Installation

# Install service with profile selection
keyrs-service install

# Or specify a profile
keyrs-service install --profile mac-standard