https://github.com/BlueM/cliclick

macOS CLI tool for emulating mouse and keyboard events
https://github.com/BlueM/cliclick

cli keyboard-events macos mouse-events objective-c terminal

Last synced: about 2 months ago
JSON representation

macOS CLI tool for emulating mouse and keyboard events

• Host: GitHub
• URL: https://github.com/BlueM/cliclick
• Owner: BlueM
• License: other
• Created: 2013-01-31T20:49:12.000Z (almost 12 years ago)
• Default Branch: master
• Last Pushed: 2024-10-16T15:42:24.000Z (2 months ago)
• Last Synced: 2024-10-29T17:40:22.900Z (about 2 months ago)
• Topics: cli, keyboard-events, macos, mouse-events, objective-c, terminal
• Language: Objective-C
• Homepage: https://www.bluem.net
• Size: 310 KB
• Stars: 1,620
• Watchers: 42
• Forks: 121
• Open Issues: 47
• Metadata Files:
  • Readme: README-Characters.md
  • License: LICENSE

Awesome Lists containing this project

README

        
Cliclick can emulate typing any character that can be typed on physical keyboard by hitting a regular key alone or combined with Shift and/or Alt, regardless of the keyboard layout.

In addition, in most keyboards layouts, there are characters which can be entered by typing two characters consecutively, typically with the first one being a so-called “dead” key or “combining character”. For instance, on a German keyboard, there is no key for typing “é”, but you can enter it by first typing a “combining acute accent” (Unicode U+0301) followed by “e”. Below you will find an overview of some keyboard layouts (or rather their English names) and lists of the characters which cliclick is able to type, as well as (very incomplete) lists of the characters which are known to be untypeable for

cliclick. If you find that cliclick cannot type a character you need, you might be interested in either adding code to support the keyboard layout (if cliclick does not know the layout at all) or in adding code on how to type the character using the current keyboard layout. The place to make these additions is method `getReplacementMapForKeyboardLayoutNamed:` in `KeycodeInformer.m`. The code in that method is pretty simple and you do not need to know much Objective-C to add more characters. This method is also the place from which data is read to auto-generate this file, so _do not edit it manually_.

Having said that, here is the list of keyboard layouts with the supported and (some) unsupported characters:

Canadian French - CSA

  * Supported: ÄËÏÖÜŸäëïöüÿÁÉÍÓÚáéíóúÀÈÌÒÙàèìòùÂÊÎÔÛâêîôûÃÑÕãñõ

  * Unsupported: ŇŘŠňřšǸǹŃńÅåŮů (incomplete list)

French

  * Supported: ÄËÏÖÜŸäëïöüÿÁÉÍÓÚáéíóúÀÈÌÒÙàèìòùÂÊÎÔÛâêîôû

  * Unsupported: ÃÑÕãñõŃńǸǹŇňŘřŠšŮů (incomplete list)

German

  * Supported: ÄËÏÖÜŸäëïöüÿÁÉÍÓÚáéíóúÀÈÌÒÙàèìòùÂÊÎÔÛâêîôûÃÕÑãõñ

  * Unsupported: ŃńǸǹŇňŘřŠšŮů (incomplete list)

Italian

  * Supported: ÄËÏÖÜŸäëïöüÿÁÉÍÓÚáéíóúÀÈÌÒÙàèìòùÂÊÎÔÛâêîôûÑñÃÕãõ

  * Unsupported: ŸŇŘŠňřšǸǹŃńŮů (incomplete list)

Polish

  * Supported: ÄÖÜäöüÁÉÍÓÚáéíóúŃńŇňŘřŠš

  * Unsupported: ËÏŸëïÿÀÈÌÒÙàèìòùǸǹÂÊÎÔÛâêîôûÃÕÑãõñŒœÅåØøÆæ (incomplete list)

Portuguese

  * Supported: ÄËÏÖÜäëïöüÿÁÉÍÓÚáéíóúÀÈÌÒÙàèìòùÂÊÎÔÛâêîôûÑñÃÕãõ

  * Unsupported: ŸŇŘŠňřšǸǹŃńŮů (incomplete list)

Spanish

  * Supported: ÄËÏÖÜŸäëïöüÿÁÉÍÓÚáéíóúÀÈÌÒÙàèìòùÂÊÎÔÛâêîôûÑñ

  * Unsupported: ÃÕãõŇŘŠňřšǸǹŃńŮů (incomplete list)

U.S. Extended

  * Supported: ÄËÏÖÜŸäëïöüÿÁÉÍÓÚáéíóúÀÈÌÒÙàèìòùÂÊÎÔÛâêîôûÃÕÑãõñŃńǸǹŇňŘřŠšÅåŮů

  * Unsupported: [nothing]