Skip to content

Mechanical Cherry MX blue keyboard emulator for Mac OS X

Notifications You must be signed in to change notification settings

spajus/keyclacker

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

43 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Mechanical Cherry MX blue keyboard emulator for Mac OS X

keyclacker is a daemon that plays sounds of mechanical keyboard when you press keys on your Mac keyboard. For those occasions when you cannot bring your mechanical friend with you.

WARNING - it is a quick crude implementation, use at your own risk.

See this tweet for a demo video.

Code is forked from and based on this keylogger: caseyscarborough/keylogger

All key logging functionality was removed, your keystrokes are not being recorded.

Alternatives

Usage

Start by cloning the repository and running the proper make commands, shown below. By default, the application installs to /usr/local/bin/keyclacker, which can easily be changed in the Makefile. make install requires root access.

$ git clone https://github.com/spajus/keyclacker && cd keyclacker
$ make && sudo make install
$ sudo keyclacker

If you'd like the application to run on startup, run the startup make target:

$ sudo make startup

Uninstallation

You can completely remove the application from your system (including the startup daemon) by running the following command:

$ sudo make uninstall

Optional Parameters

You can pass the volume value for the program (default volume is 1, which is pretty quiet).

# Be very loud
$ keyclacker 10

TODO / Known Issues / Bugs

  • It's using system call to afplay to play sounds. CoreAudio or OpenAL should be used instead for much better performance.
  • Repeating keys produced by a long key press should not produce any sound.
  • Modifier keys don't produce correct sounds when pressed in bulk.
  • Add more variety and stereo range.

Contributing

Feel free to fork the project and submit a pull request with your changes!

About

Mechanical Cherry MX blue keyboard emulator for Mac OS X

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published