rami3l / claveilleur

An input source switching daemon for macOS.

Claveilleur

Claveilleur /kla.vɛ.jœʁ/ is a simple input source switching daemon for macOS.

Inspired by a native Windows functionality, it can automatically switch the current input source for you according to the current application (rather than the current document).

WARNING: This is still a work in progress. Use it with care!

Building & Installation

Installing with brew

brew install rami3l/tap/claveilleur

Building from source

# The recommended way is to use `mint`, so we will install it first:
brew install mint

# To live on the bleeding edge:
mint install rami3l/Claveilleur@master

Usage

Getting started is as simple as:

# Installs the launch agent under `~/Library/LaunchAgents`
claveilleur --install-service

# Starts the service through launchd
claveilleur --start-service

If this is your first time using Claveilleur, please note that you might need to grant necessary privileges through System Settings > Privacy & Security > Accessibility. After doing so, you might need to stop the service and start it again for those changes to take effect:

# Restarts the service through launchd
claveilleur --stop-service && claveilleur --start-service

To uninstall the service, you just need to run the following:

# Stops the service through launchd
claveilleur --stop-service

# Removes the launch agent from `~/Library/LaunchAgents`
claveilleur --uninstall-service

claveilleur's Issues

[Bug] Switching away from certain apps is not detected

For several apps, Claveilleur can use AXFocusedWindowChanged to see if they are switched to, but it doesn't seem to know when they are switched away from.

Some examples include:

• com.apple.notificationcenterui
• com.apple.controlcenter

---

The current workaround is simply to first switch to another app that doesn't have this issue, and after that everything will work as intended again.

[Dist] Support dogfooding via `brew`

Adding a head section in the manifest won't work out of the box, we still have to manually build the binary and install it on build.head?.

See: https://docs.brew.sh/Formula-Cookbook#unstable-versions-head

[Bug] Prebuilt binary not working on `arm64`

@wtdcode: The Accessibility API prompt persists even if the permissions have been successfully granted in System Settings.

This is an issue unique to running a CI-built binary on arm64. Neither x64 machines nor self-built binaries is affected.