sherlockzh / usblock

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

======= USBLock

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

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