===============
 python-uinput
===============

Python API to the Linux uinput-system.

Description
===========

Uinput allows attaching user-space device drivers into the Linux kernel.
Python-uinput provides a simple and easy to use API to the Linux uinput-system.

General information
===================

- **Author**: Tuomas Räsänen (tuos) <tuos@codegrove.org>
- **Homepage**: http://codegrove.org/projects/python-uinput/
- **License**: GPLv3+ (see COPYING for details)
- **Version**: 0.4

Build requirements
==================

- Python 2.5 or 2.6.
- Python development files.
- Libsuinput development files.

Runtime requirements
====================

- Libsuinput.
- Uinput-module installed::

    # For the current run:
    sudo modprobe -i uinput
    # To load uinput at boot time:
    grep -q ^uinput /etc/modules || sudo sh -c 'echo uinput >> /etc/modules'

- Write permissions to /dev/uinput. Normally only root is permitted to
  write.

Downloading
===========

- Ubuntu package: https://launchpad.net/~tuos/+archive/codegrove
- Tarball: http://pypi.python.org/packages/source/p/python-uinput/python-uinput-0.4.tar.gz
- Development: http://code.launchpad.net/python-uinput ::

    bzr branch lp:python-uinput

Installing
==========

Ubuntu
------

Ubuntu
------

Add `Codegrove PPA`_ to your system and install using standard tools. For
example with apt-get::

  sudo apt-get install python-uinput

.. _Codegrove PPA: https://launchpad.net/~tuos/+archive/codegrove

Other systems
-------------

Satisfy the requirements listed above and then build and install normally::

  python setup build && sudo python setup install

Bug reporting
=============

Please report bugs at http://bugs.launchpad.net/python-uinput .
