1. Getting Started

Installation

First, ensure you have Homebrew installed. If not, download it from by running the following command in your terminal:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

See https://brew.sh for more information.

With Homebrew installed, proceed to install betterglobekey using the following commands:

brew tap Serpentiel/tools
brew install betterglobekey

Accessibility Permissions

After installing betterglobekey, run it manually once to trigger the request for Accessibility permissions:

betterglobekey

If the utility doesn't exit on its own, press Ctrl+C to quit.

Next, grant the necessary permissions by navigating to System Settings > Privacy & Security > Accessibility, and ensuring that the slider next to betterglobekey is enabled.

Starting the Service

Once the permissions are granted, start the betterglobekey service with Homebrew:

brew services start betterglobekey

Your setup is now complete! betterglobekey will start automatically upon login, enhancing your Globe key experience.

You are now ready to proceed with configuring and using betterglobekey, refer to the Configuration and Usage page for more information.