2 unstable releases

0.2.0 Jul 7, 2024
0.1.0 Oct 27, 2019

#51 in Windows APIs

Download history 5/week @ 2024-09-10 2/week @ 2024-09-17 15/week @ 2024-09-24 7/week @ 2024-10-01

76 downloads per month

MIT/Apache

170KB
4.5K SLoC

winapi-easy

An ergonomic and safe interface to some Windows API functionality.

Latest version Documentation License

Design

This is an experimental library designed to explore how the Windows API could look like if it had these properties:

  • Properly typed parameters, making wrong usage of the API difficult
  • No unsafe functionality exposed to the user outside of 'escape hatches'
  • Consistent error handling without special numerical return values

Expect breaking changes between versions. Any kind of feature completeness is also unrealistic given the huge size of the Windows API.

Features

  • Keyboard and mouse control & monitoring (send events, hotkeys, hooking)
  • List threads
  • Set CPU priority for any process / thread
  • Set IO priority for any process
  • Set current process / thread to background processing mode (sets very low IO priority, lowering disk access contention)
  • Get toplevel windows
  • Get windows associated with a thread
  • Window actions like minimize, flash
  • Set taskbar progress animation for a window
  • Turn monitor off
  • COM initialization
  • Get a file list from the Windows clipboard
  • Refresh icon cache
  • Set default audio output device

License

Licensed under either of

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Dependencies

~129MB
~2M SLoC