PiKVM-Lib: A Python library for controlling/automating PiKVM Devices

PiKVM-Lib is a Python library that provides a simple and intuitive API for controlling PiKVM devices. With PiKVM-Lib, you can easily perform various actions on your PiKVM devices, such as:

• Getting system information
• Controlling ATX power
• Managing Mass Storage Device (MSD) images
• Interacting with General-Purpose Input/Output (GPIO) channels
• Taking snapshots and receive image
• Reading snapshots with OCR and receive text representation
• Send keys to the server

With PiKVM-Lib, you can automate tasks, integrate PiKVMs into your existing applications, and extend the capabilities of your PiKVM devices.

Installation

To install PiKVM, simply run the following command in your terminal:

pip install pikvm-lib

PiKVM device control

After installing PiKVM, you can import it into your Python script and create an instance of the PiKVM class. The PiKVM class constructor takes the following parameters:

• hostname: The hostname or IP address of the PiKVM device
• username: The username for authentication
• password: The password for authentication

from pikvm_lib import PiKVM

pikvm_instance = PiKVM(hostname="192.168.1.10", username="admin", password="password")

Once you have created an instance of the PiKVM class, you can use it to interact with your PiKVM device. For example, you can get the system information of the device:

system_info = pikvm_instance.get_system_info()
print(system_info)

You can also control the ATX power of the device:

pikvm_instance.set_atx_power(action="on")

For more information on how to use PiKVM, please refer to the official documentation: PiKVM official web and PiKVM API Reference

Usage examples

Here are some examples of how to use PiKVM to perform common tasks:

• Getting system information:

from pikvm_lib import PiKVM

pikvm_instance = PiKVM(hostname="192.168.1.10", username="admin", password="password")
system_info = pikvm_instance.get_system_info()
print(system_info)

• Turning on the ATX power:

pikvm_instance.set_atx_power(action="on")

• Uploading an MSD image:

pikvm_instance.upload_msd_image(filepath="/path/to/image.iso")

• Connecting the MSD:

pikvm_instance.connect_msd()

• Switching a GPIO channel:

pikvm_instance.switch_gpio_channel(channel=1, state=1)

• Take snapshot and receive OCR text:

pikvm_instance.get_streamer_snapshot(snapshot_path="/home/user/pikvm-snapshots",
                            filename="test.txt", ocr=True)

• Take snapshot and receive PIL image:

pikvm_instance.get_streamer_image()

• Send Key Press:

pikvm_instance.press('a')

• Send Hot Key:

pikvm_instance.hotkey('ctrl', 'alt', 'delete')

• Move Mouse to Location (x,y):

pikvm_instance.send_mouse_move_event(128, 256)

• Click Mouse at Location:

pikvm_instance.send_click("left")

• Drag mouse to Location (x,y):

pikvm_instance.send_mouse_event(button, "true")
pikvm_instance.send_mouse_move_event(128, 256)
pikvm_instance.send_mouse_event(button, "false")