How to Control and Monitor Mouse & Keyboard with Python’s pynput Library

This library lets you control and monitor input devices such as mouse, touchpad, and keyboard.

Each device type is provided as a subpackage:

pynput.mouse – classes for controlling and listening to mouse or touchpad events.

pynput.keyboard – classes for controlling and listening to keyboard events.

Import the subpackages directly from pynput: from pynput import mouse, keyboard Controlling the mouse

Use pynput.mouse.Controller to move the cursor, click buttons, or scroll.

Listening to mouse events

Instantiate pynput.mouse.Listener with callbacks for move, click, and scroll; the listener runs in a separate thread. Call .stop(), raise StopException, or return False from a callback to stop listening.

Controlling the keyboard

Use pynput.keyboard.Controller to press and release keys programmatically.

Listening to keyboard events

Instantiate pynput.keyboard.Listener with callbacks for key press and release; it also runs in its own thread. Stopping works the same way as the mouse listener. The callback receives a pynput.keyboard.Key instance for special keys and a pynput.keyboard.KeyCode instance for alphanumeric keys; unknown keys yield None.