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: 28 days 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 (almost 9 years ago)
• Default Branch: master
• Last Pushed: 2022-08-20T18:41:17.000Z (almost 2 years ago)
• Last Synced: 2024-04-24T05:12:26.933Z (29 days ago)
• Topics: input-method, macos, swift
• Language: Swift
• Homepage:
• Size: 1.51 MB
• Stars: 1,339
• Watchers: 29
• Forks: 99
• Open Issues: 6
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Lists

• open-source-mac-os-apps - Kawa - Better input source switcher for macOS. ![swift_icon] (Applications / Keyboard)
• awesome-stars - hatashiro/kawa - A macOS input source switcher with user-defined shortcuts. (Swift)
• awesome-stars - hatashiro/kawa - A macOS input source switcher with user-defined shortcuts. (Swift)
• awesome-stars - hatashiro/kawa - A macOS input source switcher with user-defined shortcuts. (Swift)
• awesome-stars - hatashiro/kawa - `★1344` A macOS input source switcher with user-defined shortcuts. (Swift)

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 [email protected]:utatti/kawa.git

$ carthage bootstrap

```

After dependency installation, open the project with Xcode.

## License

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