README

SpeedTouch WEP key finder
===================================

This program computes the default factory WEP key of a SpeedTouch modem based
on the key displayed in the SSID.

Project homepage: http://github.com/potyl/speedkey


Building
========

This project uses autoconf & friends as its build toolchain. Building it should
be trivial once the GNU autoconf toolchain is installed.

In Debian based systems the build dependencies can be easily installed by
doing:

	sudo apt-get install build-essential autoconf libtool libssl-dev


If you have forked the code from github you will need to run the autoconf
programs in order to prepare build toolchain:

	./autogen.sh

Once the toolchain scripts are created simply build the program with:

	./configure --prefix=/usr && make && sudo make install

You should now be able to execute the program speedkey!


Usage
=====

The progam is started from the command line and takes its parameters from the
command line. It expects to receive as input the random part of the SSID that
each SpeedTouch modem has as it's factory default. For instance, if your modem
identifies itselft as "SpeedTouchAABBCC" then simply provide the parameter
"AABBCC" as input.

	speedkey ABBA11

The program can output multiple WEP keys, this is normal as multiple serial
numbers can generate the same SSID value. Rest assured that one of the keys
printed is the one defined as the factory key. It's up to you to find out which
one is the real WEP key.

Option -d outputs the SSID/key in Debian's ifupdown /etc/network/interfaces
format, for ease of pasting.