Cliclick Version History

Back to application description

4.0.1, 04/10/2018

  • Bugfix: in version 4.0, it was not possible to press several keys at once using the kd action.
  • Added missing options to the built-in help (cliclick -h).

4.0, 03/24/2018

  • Cliclick got the ability to right-click, which can be invoked using command “rc” (for instance: cliclick rc:123,456 for clicking at point with x position 123 and y position 456).
  • “Human” mouse movements: Cliclick now has the ability to let mouse movement appear more “human” by setting an easing factor, which is done using the new -e option (example: cliclick -e 100 c:300,200 c:500,400). The higher this value is (default: 0), the more will mouse movements seem “natural” or “human-like”, which also implies: will be slower. If this option is used, the actual speed will also depend on the distance between the start and the end position, i.e. the time needed for moving will be higher if the distance is larger.
  • Cliclick uses appropriate output destinations for error messages, which means they are now written to stderr, and no longer to stdout.
  • Moreover, the destination of output from the “test” or “verbose” mode (option -m) can be sent to stdout (default), to stderr, to the clipboard or a file. The syntax is -m test:stdout (or simply -m test, which is identical to the pre-v4 syntax and behavior), -m test:stderr, -m test:clipboard or -m test:/path/to/file.txt. This all applies to -m verbose, too. Plus, the output destination for informational commands (currently: the “print” and “color picker” commands) can be selected using the -d option: -d stdout (default, if unspecified), -d stderr, -d clipboard or -d /path/to/file.txt.
  • The “print” command no longer outputs something like “Current mouse position: 123,456”, but merely coordinates such as “123,456”.
  • The code for dragging (“dd” and “du” commands) had an issue which could cause it to fail. This is now fixed, so if you tried to emulate dragging with cliclick before, but didn’t succeed, chances are that you will have more success now.
  • When using cliclick, sometimes it is needed to use the “wait” command to slow execution down, as naturally, cliclick can act much faster than a human. To decrease the likeliness of needing the “wait” command, the time between execution of commands and between pressing and releasing the mouse button when using the “click” command was slightly increased. This should not be notable, but (at least theoretically) could break existing scripts.
  • The minimum supported system version is OS X 10.9.

3.3, 11/12/2016

  • Added support for numpad keys when using the “keypress” (kp) action
  • Support reading commands from stdin (use - [a dash] as filename with -f option)
  • Change donation switch from -d to -n to avoid ambiguity
  • Fix handling of absolute negative coordinates

3.2, 02/17/2015

  • Added color picker (“cp”) action: can be used to read the RGB color values at a specific screen coordinate. Example: “cliclick cp:123,456”
  • “Keypress” (“kp”) action now supports the Enter key
  • Improves reliability of doubleclicking on some systems
  • Fixes crashes with non-Western keyboard layouts
  • Fixes potential crashes when arguments are formally invalid
  • Other minor improvements

3.1, 07/18/2015

  • Bugfix: For the “keypress” (“kp”) command, fixed keys “volume-down”, “volume-up” and “mute”.
  • Bugfix: Typing did not work in “verbose” mode
  • Change: For the “keypress” (“kp”) command, removed support for “help” key, which didn’t work anyway.
  • New: “keypress” (“kp”) command supports additional keys: “brightness-up”, “brightness-down”, “play-pause”, “play-previous”, “play-next”, “keys-light-toggle”, “keys-light-up”, “keys-light-down”

3.0.3, 10/29/2014

  • Improves reliability of “drag & drop” operations and reduces the need to add “wait” commands for dragging to work correctly.
  • Fixed a few bugs related to memory management

3.0.2, 10/08/2014

  • Fixed a command-parsing bug that occurred when typing text containing a colon
  • Added support for a few diacritical characters on the US Extended keyboard layout

3.0, 09/15/2014

  • Implemented the most requested feature: typing (almost any) arbitrary text using cliclick. Example:
    cliclick t:'Wow, it works!'

2.4, 04/11/2014

  • Added support for dragging using commands dd (“drag down”) and du (“drag up”). Code contributed by J. Lewis Muir.

2.3.1, 11/07/2013

  • Fix: When using “key down”, “key up” or “key press” with more than one key, the events were often fired too fast, resulting in only the last key being recognized by the OS.

2.3, 11/03/2013

  • Added several new keys that can be used with the “keypress” (“kp”) command.
  • Added several new keys that can be used with the “key down” (“kd”) and “key up” (“ku”) commands.

2.2, 01/31/2013

  • Relative coordinates: Whenever a command expects a pair of coordinates, you may provide relative values by prefixing the number with + or -. For example, “m:+50,+0” will move the mouse 50 pixels to the right. Of course, relative and absolute values can be mixed, and negative values are possible, so “c:100,-20” would be perfectly valid. If you need to specify absolute negative values (in case you have a setup with a second display arranged to the left of your main display), prefix the number with =, for instance “c:100,=-200”.
  • cliclick has been released as Open Source software. The repository can be found at

2.1, 09/26/2012

  • New command: “kp:<key>”, which stands for “key press” and which means a “key down” plus a “key up” event. Other than “kd” and “ku”, which are intended for modifier keys, “kp” is for emulating “regular” keys that do not have to be held down while performing other events. Currently “return” and “esc” are supported as key, which can be handy for confirming or canceling dialogs.
  • Added command-line option “-w” for specifying a default pause (in milliseconds) after each event. This can be used in addition to the wait command and/or may be used to reduce the number of wait commands you need.
  • Added command-line option “-f” for reading commands from a file. Each line in the file is expected to contain a command in the same format/syntax as the commands given as arguments at the shell (for instance: “c:200,300”). Additionally, lines starting with the hash character “#” are regarded as comments, i.e.: ignored. Leading and trailing whitespace is ignored, too.

2.0, 08/17/2012

  • New syntax: more readable, more flexible, more consistent and more open to future additions
  • Added support for triple-clicking
  • Added support for “alt” modifier key
  • Added support for moving the mouse without clicking
  • Added testing mode, which will not perform any actions, but instead print a description of what would have been done to STDOUT
  • Added a means to print arbitrary messages (primarily for debugging purposes) and to print the current mouse location as part of a sequence of clicks/events
  • Code uses a newer API

1.3.1, 04/13/2010

  • Fixed “m” for getting the mouse’s current y location (in 1.3, always returned 0).

1.3, 02/01/2010

  • Added “-r” switch to restore mouse location to the initial position
  • Added switch “-q” to simply print the current mouse location
  • Instead of a number, you may pass “m” as x and / or value to use the current x and / or y position.

1.2, 08/18/2008

  • Added support for doubleclicking and control-clicking (contextual menu clicks)
  • Added support for a series of consecutive clicks

1.0, 05/25/2007

  • Initial release