From caf31a97e934c3191f2867ab6a93ecf4bb8890fe Mon Sep 17 00:00:00 2001 From: makefu Date: Wed, 26 Jun 2013 17:14:18 +0200 Subject: update README --- README.md | 47 +++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 47 insertions(+) create mode 100644 README.md (limited to 'README.md') diff --git a/README.md b/README.md new file mode 100644 index 00000000..62e0083b --- /dev/null +++ b/README.md @@ -0,0 +1,47 @@ +# Autowifi +Author: makefu,lassulus +Status: Pre-Alpha - it will most likely break if you try to use it + +# Contact + +twitter: @krebsbob ,@makefoo +IRC: freenode #krebs + +# Goals +Goal of autowifi is to provide a tool which automatically can connect to +networks in an unknown environment. + +This can either be done by connecting to open networks, known networks +(whitelist) or by calculating weak default wpa keys (for example easybox +default passwords). + +# Audience +Due to the current status of the project the target audience are +linux users with technical background . + +# Usage + + # all as root + # try to find networks to connect to around you + usr/bin/autowifi_dryrun quiet + + # start the autowifi daemon which tries to stay in networks all the time + usr/bin/autowifi + +# Plugins +All tests to open up networks are implemented in plugins in + usr/lib/autowifi/plugins + +## Run a single Plugin +This can be used for testing purposes, e.g. test a single plugin against given networks directly + + # try out the easybox keygen + usr/lib/autowifi/plugins/02easybox SSID MAC CHANNEL ENCRYPTION(wpa_cli style) + + #e.g. + usr/lib/autowifi/plugins/02easybox Easybox-123456 00:11:22:33:44:55 7 "[wpa]" + +# Disclaimer +- use at own risk +- only run in lab environment +- you break it, you buy it -- cgit v1.2.3 From b99bbe256c030cec78b1c96d08eb02860dda911c Mon Sep 17 00:00:00 2001 From: Felix Richter Date: Wed, 26 Jun 2013 17:25:35 +0200 Subject: README.md: fix line breaks --- README.md | 2 ++ 1 file changed, 2 insertions(+) (limited to 'README.md') diff --git a/README.md b/README.md index 62e0083b..3e0d8dce 100644 --- a/README.md +++ b/README.md @@ -1,10 +1,12 @@ # Autowifi Author: makefu,lassulus + Status: Pre-Alpha - it will most likely break if you try to use it # Contact twitter: @krebsbob ,@makefoo + IRC: freenode #krebs # Goals -- cgit v1.2.3