USBLock 0.2.2

Lock and unlock your desktop using a USB stick as a key.

=======
USBLock
=======

Copyright (C) 2013 Sven Steinbauer http://www.unlogic.co.uk

[](https://travis-ci.org/Svenito/usblock)

USBlock is a Python script that will lock and unlock your linux box using any
old USB storage device as a key.

** NOTE **
V0.1 only works on Linux. OS X and Windows will have to wait a little.

Installation
============

Install with `pip install usblock` or run `sudo python ./setup.py install`
from the directory you downloaded USBLock into.

See `requirements.txt` for a list of required Python modules.

Non Python dependencies
=======================

Linux
-----

You will need `dbus` and `python-dbus` as well as `hal`. These should all be
available via your package manager. See below why `python-dbus` is listed here.

Known Issues
============

* I've had some devices not mount on external USB ports (like on a Mac keyboard
or hub). DBus does not register the device insertion and so USBLock cannot
lock or unlock your machine. Try a different memory stick or USB port.

* On linux you need dbus installed. `pip install dbus-python` doesn't work, so
you may have to install it via your system's package manager or from source.

Thanks for the patches
======================

Joel Semar, Natan L