#keyboard-input #mouse-input #input #mouse #keyboard

device_query

A basic library for querying keyboard and mouse state on-demand without a window

19 releases (6 stable)

Uses old Rust 2015

2.0.0 Feb 9, 2024
1.1.3 Mar 31, 2023
1.1.2 Jan 14, 2023
1.1.1 May 18, 2022
0.1.0 Apr 3, 2018

#64 in Hardware support

Download history 437/week @ 2023-12-04 565/week @ 2023-12-11 738/week @ 2023-12-18 606/week @ 2023-12-25 436/week @ 2024-01-01 663/week @ 2024-01-08 532/week @ 2024-01-15 461/week @ 2024-01-22 286/week @ 2024-01-29 519/week @ 2024-02-05 577/week @ 2024-02-12 684/week @ 2024-02-19 839/week @ 2024-02-26 744/week @ 2024-03-04 904/week @ 2024-03-11 898/week @ 2024-03-18

3,410 downloads per month
Used in 31 crates (28 directly)

MIT license

55KB
1.5K SLoC

device_query

Build Status

A simple library to query mouse and keyboard inputs on demand without a window. Will work in Windows, Linux on X11, and macOS.

use device_query::{DeviceQuery, DeviceState, MouseState, Keycode};

let device_state = DeviceState::new();
let mouse: MouseState = device_state.get_mouse();
println!("Current Mouse Coordinates: {:?}", mouse.coords);
let keys: Vec<Keycode> = device_state.get_keys();
println!("Is A pressed? {}", keys.contains(Keycode::A));

Dependencies

Windows shouldn't require any special software to be installed for device_query to work properly. On Linux, the X11 development libraries are required for device_query to query state from the OS.

On Ubuntu/Debian:

sudo apt install libx11-dev

On Fedora/RHEL/CentOS:

sudo dnf install xorg-x11-server-devel

On newer versions of MacOS, you may run into issues where you only see meta keys such as shift, backspace, et cetera. This is due to a permission issue. To work around this:

  • open the MacOS system preferences
  • go to Security -> Privacy
  • scroll down to Accessibility and unlock it
  • add the app that is using device_query (such as your terminal) to the list

Dependencies

~0–42MB
~574K SLoC