Skip to main content

A wrapper library for WinIO

Project description


A wrapper library for WinIO

Thanks for the great WinIO library which comes from Yariv Kaplan.

The WinIO library binary distribution will be accessed from winiobinary package.

NOTE: This library has been renamed from ‘rabird.winio’ to ‘pywinio’ after 0.3.0 .

  • License: Apache-2.0


  • Keyboard Emulation

NOTICE: You must have a ps/2 keyboard connected to your PC if you test on win10 or later, otherwise this sample won’t works!

import pywinio
import time
import atexit

# KeyBoard Commands
# Command port
KBC_KEY_CMD = 0x64
# Data port

g_winio = None

def get_winio():
    global g_winio

    if g_winio is None:
            g_winio = pywinio.WinIO()
            def __clear_winio():
                    global g_winio
                    g_winio = None

    return g_winio

def wait_for_buffer_empty():
    Wait keyboard buffer empty

    winio = get_winio()

    dwRegVal = 0x02
    while (dwRegVal & 0x02):
            dwRegVal = winio.get_port_byte(KBC_KEY_CMD)

def key_down(scancode):
    winio = get_winio()

    winio.set_port_byte(KBC_KEY_CMD, 0xd2);
    winio.set_port_byte(KBC_KEY_DATA, scancode)

def key_up(scancode):
    winio = get_winio()

    winio.set_port_byte( KBC_KEY_CMD, 0xd2);
    winio.set_port_byte( KBC_KEY_DATA, scancode | 0x80);

def key_press(scancode, press_time = 0.2):
    key_down( scancode )
    time.sleep( press_time )
    key_up( scancode )

# Press 'A' key
# Scancodes references :

Privilege Requirements

WinIo requires administrative privileges to run properly. This can be achieved by:

  • Using WinIo from a service running as LocalSystem (SE_LOAD_DRIVER_NAME privilege must be explicitly enabled).

  • Embedding a manifest file in the application that requests privilege elevation.

  • Requiring the user to choose the “Run as Administrator” option when launching the application.

The included C# samples demonstrate using an embedded manifest file to request privilege elevation.

Driver Signing Requirements on 64-bit Systems

64-bit versions of Windows only load device drivers that are signed by a code signing certificate issued by a public CA such as Verisign, Thawte, etc. WinIo64.sys must not be deployed on production machines unless a code signing certificate is obtained and used to sign this file. The bundled copy of WinIo64.sys is signed with a self-signed certificate and can only be used on development/test machines with Windows running in a special “test” mode. In order to use the bundled version of WinIo64.sys, you need to take the following steps:

  • Open an elevated command window by right-clicking the icon and clicking “Run as Administrator”.

  • Type the following command to enable test-signing:

bcdedit.exe /set TESTSIGNING ON
  • Reboot the machine

For more information on Windows driver signing requirements, please refer to


This library was licensed under Apache-2.0 which already descripted in LICENSE

WinIO library’s license descripted in LICENSE-WINIO


0.3.0 (2018-07-24)

  • Renamed to pywinio

0.2.6 (2018-07-20)

  • Claim this library renamed to pywinio!

0.2.5 (2018-07-20)

  • Removed support of python 2.x

0.2.4 (2018-06-01)

  • Supported automatic deploy by appveyor

0.2.0 (2018-01-21)

  • Depends on winiobinary project, so we don’t need to download WinIo binaries during

0.1.9 (2015-12-02)

  • Can’t install from packaged zip file due to missing

0.1.8 (2015-09-09)

  • Fixed not working with 64bits os

0.1.0 (2015-08-18)

  • Fixed not working with python3

0.0.9 (2015-08-18)

  • Initial release

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution (26.7 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page