betterglobekey

Make macOS Globe key great again!

Ask a Question • Report a Bug • Request a Feature

Table of Contents

• 1. About this Project
• 2. Getting Started
  • 2.1. Prerequisites
  • 2.2. Setting It Up
• 3. Contributing
• 4. License

About the Project

macOS features a brilliant idea for the way to switch your keyboard's input source—the Globe key. While the idea is brilliant in design, in practice, however, the key is coded in a very intrusive and impractical way, which might prevent some users—especially those who tend to switch their input source often—from enjoying their overall user experience.

This utility completely reworks the way the Globe key functions and provides users with an improved overall user experience, and I sincerely hope that one day Apple is going to make it this way out-of-box.

(back to top)

Getting Started

The utility enhances the functionality of the Globe key by introducing two distinct modes of operation and starting from the currently active input source:

1. Single Press Mode

   Single press mode is activated when the Globe key is pressed once.

   In this mode, the utility cycles through a collection of input sources. Each press of the Globe key switches to the next input source within the current collection.

   The collections of input sources are defined in the configuration under input_sources. Each key-value pair within this map represents a named collection of input sources. For example:

   input_sources:
     foo:
       - com.apple.keylayout.US
       - com.apple.keylayout.Russian
     bar:
       - com.apple.keylayout.Finnish
       - com.apple.keylayout.Ukrainian-PC
       - com.apple.inputmethod.Kotoeri.RomajiTyping.Japanese

   Upon initialization, the utility determines the current active input source and starts from that particular source within its respective collection.

2. Double Press Mode

   Double press mode is activated when the Globe key is double-pressed.

   In this mode, the utility switches between different collections of input sources. Each double press of the Globe key cycles to the next collection in the configuration.

   The maximum time interval between the first and second press that is considered a double press can be configured in the double_press.maximum_delay property. This delay is specified in milliseconds.

These enhancements aim to provide a more versatile and user-friendly experience for managing multiple input sources, especially for users who frequently switch between different languages or keyboard layouts.

See our wiki for more information on how to set up and configure the utility.

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create, so any contributions you make are greatly appreciated.

If you would like to contribute, please make sure to take a look at this guideline beforehand.

Please see our security policy to report any possible vulnerabilities or serious issues.

(back to top)

License

Distributed under the MIT License. See LICENSE.md for more information.

N.B. This project explicitly does not requires its contributors to sign a Contributor License Agreement nor does it posses one.

(back to top)