https://github.com/hatashiro/kawa

A macOS input source switcher with user-defined shortcuts.
https://github.com/hatashiro/kawa

input-method macos swift

Last synced: 7 months ago
JSON representation

A macOS input source switcher with user-defined shortcuts.

• Host: GitHub
• URL: https://github.com/hatashiro/kawa
• Owner: hatashiro
• License: mit
• Created: 2015-07-26T16:20:12.000Z (over 10 years ago)
• Default Branch: master
• Last Pushed: 2022-08-20T18:41:17.000Z (over 3 years ago)
• Last Synced: 2024-10-29T19:59:58.513Z (about 1 year ago)
• Topics: input-method, macos, swift
• Language: Swift
• Homepage:
• Size: 1.51 MB
• Stars: 1,414
• Watchers: 32
• Forks: 99
• Open Issues: 6
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

• open-source-mac-os-apps - Kawa - Better input source switcher for macOS. ![swift_icon] (Applications / Keyboard)
• awesome-swift-macos-apps - Kawa - commit/hatashiro/kawa?style=flat&label=" /> - Better input source switcher for macOS. (Keyboard / Text)

README

          
![logo](resource/png/logo.png)

# Kawa [![GitHub license](https://img.shields.io/badge/license-MIT-lightgrey.svg)](https://raw.githubusercontent.com/utatti/kawa/master/LICENSE) [![GitHub release](https://img.shields.io/github/release/utatti/kawa.svg)](https://github.com/utatti/kawa/releases)

A macOS input source switcher with user-defined shortcuts.

## Demo

[![demo](https://cloud.githubusercontent.com/assets/1013641/9109734/d73505e4-3c72-11e5-9c71-49cdf4a484da.gif)](http://vimeo.com/135542587)

## Install

### Using [Homebrew](https://brew.sh/)

```shell

brew update

brew install --cask kawa

```

### Manually

The prebuilt binaries can be found in [Releases](https://github.com/utatti/kawa/releases).

Unzip `Kawa.zip` and move `Kawa.app` to `Applications`.

## Caveats

### CJKV input sources

There is a known bug in the macOS's Carbon library that switching keyboard

layouts using `TISSelectInputSource` doesn't work well with complex input

sources like [CJKV](https://en.wikipedia.org/wiki/CJK_characters).

## Development

We use [Carthage](https://github.com/Carthage/Carthage) as a dependency manager.

You can find the latest releases of Carthage [here](https://github.com/Carthage/Carthage/releases),

or just install it with [Homebrew](http://brew.sh).

```bash

$ brew update

$ brew install carthage

```

To clone the Git repository of Kawa and install dependencies:

```bash

$ git clone git@github.com:utatti/kawa.git

$ carthage bootstrap

```

After dependency installation, open the project with Xcode.

## License

Kawa is released under the [MIT License](LICENSE).