Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/wilix-team/iohook
Node.js global keyboard and mouse listener.
https://github.com/wilix-team/iohook
electron hacktoberfest iohook keyboard-listeners linux macos mouse-listener nodejs nwjs windows
Last synced: 6 days ago
JSON representation
Node.js global keyboard and mouse listener.
- Host: GitHub
- URL: https://github.com/wilix-team/iohook
- Owner: wilix-team
- License: mit
- Created: 2016-12-10T18:28:53.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2024-05-10T15:31:16.000Z (8 months ago)
- Last Synced: 2024-10-29T15:34:21.464Z (about 2 months ago)
- Topics: electron, hacktoberfest, iohook, keyboard-listeners, linux, macos, mouse-listener, nodejs, nwjs, windows
- Language: C
- Homepage: https://wilix-team.github.io/iohook
- Size: 1.36 MB
- Stars: 1,188
- Watchers: 22
- Forks: 291
- Open Issues: 107
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- awesome-list - iohook - team | 829 | (C)
README
# iohook
[](https://www.npmjs.com/package/iohook)
[](https://github.com/wilix-team/iohook/releases/latest)
[](https://github.com/marketplace/actions/super-linter)
[](https://github.com/wilix-team/iohook/actions/workflows/ci.yml)
[](https://github.com/prettier/prettier)
[](https://gitter.im/iohookjs/Lobby)
[](https://github.com/wilix-team/iohook/issues)
## About
Node.js global native keyboard and mouse listener.
This module can handle keyboard and mouse events via native hooks inside and outside your JavaScript/TypeScript application.
Found a bug? Have an idea? Feel free to post an [issue](https://github.com/wilix-team/iohook/issues) or submit a [PR](https://github.com/wilix-team/iohook/pulls).
**Check out the [documentation](https://wilix-team.github.io/iohook).**
## Platform support
- Versions >= 0.6.0 support only officially supported platforms versions.
- Versions 0.5.X are the last to support Electron < 4.0.0
- Versions 0.4.X are the last to support for Node < 8.0 and Electron < 2.0.0
## Installation
iohook provides prebuilt version for a bunch of OSes and platforms.
### Linux (including WSL)
```bash
# On Linux (including WSL) platform, you will need libxkbcommon-x11 installed
sudo apt-get install -y libxkbcommon-x11-0
```
### All platforms
```bash
npm install iohook --save # or yarn add iohook
```
## FAQ
Q. _Does this module require Java ?_
A. No, this module doesn't require Java (like jnativehook) or any other runtimes.
Q. _Is iohook compatible with Node/Electron version X.Y.Z ?_
A. We try to match the currently supported version of both [Node](https://nodejs.org/en/about/releases/) and [Electron](https://electronjs.org/docs/tutorial/support#currently-supported-versions).
## Apps
Are you using iohook in your project ? Please tell us in a [PR](https://github.com/wilix-team/iohook/pulls) so we an add it to the list !
- [Cortex](https://crtx.gg/)
- [Tracklify](https://tracklify.com/)
- [CrewLink](https://github.com/ottomated/CrewLink)
- [Runtime](https://github.com/yikuansun/desktopspeedruntools#runtime-speedrun-tools)
## Contributors
Thanks to _kwhat_ for the [libuiohook](https://github.com/kwhat/libuiohook) project and [ayoubserti](https://github.com/ayoubserti) for the first iohook prototype.
- [vespakoen](https://github.com/vespakoen) (prebuild system implementation)
- [matthewshirley](https://github.com/matthewshirley) (Windows prebuild fix)
- [djiit](https://github.com/djiit) (project & community help)
- [ezain](https://github.com/eboukamza) (add feature enable/disable mouse click propagation)
- [anoadragon453](https://github.com/anoadragon453) (electron 4+ support)
- [ykhwong](https://github.com/ykhwong) (node-gyp usage, electron 9+ support)
- All the other contributors. Feel free to extend this list !