PDA

View Full Version : Whiskers


SevenRains
23rd January 2009, 10:28 PM
[Map Overview]

http://www.sevenrains.ro/pub/whiskersMapDisplay.php


Green dots represent Access Points
Blue dots represent Bluetooth Devices

Map updates on page refresh and is based on user uploads.


[About]
Whiskers is an educational PocketPC application under the GNU/GPL license which tries to exploit all the hardware available on most common PDAs providing a link between different features such as GPS-Bluetooth-Wireless. Generally whiskers was built with radio reconnaissance in mind as help for geocachers or wardrivers but also as penetration and audit tool. There is support for in depth device scanning, triggering actions based on filters when certain devices are in range, centralized GPS logging with search functions for private or public databases and much more.

[Requirements]


WM5 onward

Compact Framework 3.5
Microsoft Bluetooth Stack (?unconfirmed?)


[Features]


Continuous scanning for Wireless and Bluetooth
Device logging (open, save etc..)
Bluejacking (two supported methods, more to come soon).
Autojacking
Device scripting, triggering specific actions when a device is in range based on filters such as device name, address, device class (laptop, phone, smartphone whatever...).
GPS logging based on GPX file with centralized database
Ability to contribute to the database: scan and upload to the central database.
Searching for devices in the database by name, address and Wireless or Bluetooth radio.
More to come :-)


[Screenshots]

http://www.sevenrains.ro/cnt/pcs/whiskers_4.jpg


[Download]
Stable releases are those who were thoroughly tested by several people. They don't contain the latest features, modifications or bugfixes but they are bound to work and be compatible. Snapshot releases are development releases with new features and enhancements and are thus prone to not work correctly. In either case, if you've found a bug, please report it and I'll fix it asap! The stable releases also contain the source code. You can find the most recent cab file after you extract the archive at WhiskersCAB/Release/WhiskersCAB.CAB

[Stable]
HERE (http://www.sevenrains.ro/cnt/pak/get_latest.php?&p=Whiskers) or HERE (http://downloads.sourceforge.net/whiskers/Whiskers-0.1.zip)

[Snapshots]
Top most is the most recent version! If you post bug reports please post them for the top most version in the list below. The others below the top most are there just for history purpose. Please download the top most as it contains the recent changes and bugfixes.
http://rapidshare.com/files/203178761/Whiskers-200902272712.CAB
http://rapidshare.com/files/195599015/Whiskers-200908024416.CAB
http://rapidshare.com/files/194612862/Whiskers-200902060010.CAB
http://rapidshare.com/files/193026445/Whiskers-200902024318.CAB
http://rapidshare.com/files/192192948/Whiskers-200901310821.CAB
http://rapidshare.com/files/191631039/Whiskers-200901301416.CAB
http://rapidshare.com/files/190308621/Whiskers-200901273619.CAB
http://rapidshare.com/files/188808467/Whiskers-200901243517.CAB

[ SVN ]
You can always grab the latest SVN version from HERE (http://www.sevenrains.ro/svn/filedetails.php?repname=Whiskers&path=%2FWhiskersCAB%2FRelease%2FWhiskersCAB.CAB). Please note that this will change in time and is considered the most unstable version of Whiskers. If you just want to browse the repository, you can do so HERE (http://www.sevenrains.ro/svn/listing.php?repname=Whiskers&path=%2F&sc=0).



[TODO]
- Add documentation
- Test on different platforms (other than mine)

[Changes]
current:
0.1:


Initial release


[More]
http://www.sourceforge.net/projects/whiskers

[Install]


If you downloaded the CAB file, just copy to your device and install as normal. In case you've downloaded the stable version, you'll find the CAB file in WhiskersCAB/Release and you can copy it to your device and install.

[Uninstall]


Just uninstall from add/remove programs.

[Credits]
My first thanks go to the xda-developers forum for providing continuous support and testing for Sunscape. I am pretty sure no project would have gotten very far without this invaluable input. Secondly, I want to thank the creator of btCrawler for being an inspiration and going down as a true martyr when the eh... "German Law of Cybercrime" got him. I feel you c0rnholio!

-*-

SevenRains
23rd January 2009, 10:28 PM
[Documentation]

In this documentation I will refer to the screenshots in the initial post. If you look at the tabs at the bottom you'll see four of them: "Scan", "Jack", "Script" and "Track". I'll try to walk you through all of those step-by-step since currently there is no documentation.



Scan

This is the main tab of Whiskers. It will not only scan for devices whether Bluetooth or Wireless but you will also be able to do various things with the found devices.



For a quick start, your bluetooth and/or wireless adapter has to be switched on. Whiskers doesn't do this for you and should fail silently if it doesn't find the adapter turned on.



Then you can just hit the Scan button and Whiskers will start to scan for devices or access points around you.



You can press "Clear" to flush current found devices or press "Delete" to remove individual devices from the list. Naturally, if Whiskers is scanning it will probably find the device again.



The input box right next to the Start button is the scanning time interval measured in milliseconds. That is, the time for which Whiskers will pause between scanning. You can set it at your convenience but 1000ms (1s) is quite a good value.



The Open / Save buttons you can use to open a saved list or store a saved list.

Let's move on to the Comm tab.


Comm

This tab is meant for communicating with other users using Whiskers. Although it's only based on bluetooth and hence the short range, it may come in handy when other Whiskers features will be implemented.


To communicate with a device, first make sure you've scanned it using the Scan tab, enter your message in the box below and click Send. If the other device is using Whiskers and is in listening mode, after a couple of tries your message should appear on your screen and on the other device's screen.



To receive messages, you must have clicked the Start Listening button which will make Whiskers listen to all incoming messages.

And now the Jack tab.


Jack

This tab is meant for jacking / autojacking. I have some development ideas which I won't divulge just yet but for the time being only this form of eh... annoyance is possible. The whole concept started from quite an old java applet I used to have on my mobile phone... You could set it to jack a message continuously and you'd just stroll around and it would jack any device which came in range.



To jack a device (only bluetooth devices, of course) you select a device in the Scan tab, then select the Jack method, either pairing or file, enter your message (the shorter the message the better!) and press the Jack button.



To autojack, you enter your message and and select a jacking logic (rotation - Whiskers will rotate in a round-robin fashion going through all devices, first in - Whiskers will jack any "new" device it finds, random - Whiskers will randomly select devices from the Scan tab) and press the Start AutoJack button. If you switch to the Scan tab you will see which device Whiskers is currently jacking. The time to live (TTL) is how much Whiskers will wait for a timeout while jacking a device (10 000ms, 10 seconds should give enough time to properly jack a device).

Please use this feature responsibly :-) Let's move on to the Script tab.



Script

The purpose of this feature is to execute certain commands when a specific device is detected. You can search for a specific address, device name, type of device (the drop down boxes will help you choose), and whether it should be a BT (Bluetooth) device or an AP (access point).



To add a script, you may choose to fill any or none of the filters. You can search for a device name... Or maybe just a device class... Then you write or browse for an executable and fill in any optional parameters and click Add. You can later add the script by just clicking the script in the big box.



The next step is to enable scripts by clicking the Enable Scripts button. The time frequency (in milliseconds) is how often the scripts will trigger on the devices it finds.

That's it for the Script tab.



Track

Uh. This is a difficult one. The Track tab, given you have a GPS device, will log at what latitude and longitude it found a device. It will store this in a GPX file along with the device name and device address. Optionally, of course, once you've gathered some data, you may choose to press the Upload button which will upload the GPX file to a central server [I'll explain this more in the next post]. Given that some user spotted a specific device and has uploaded it to the server, you can search for devices using the search feature. This will place dots on the map [They may be hard to see on the default map, and I'm sorry for this, I'm still searching for solutions] at the respective locations. You can then choose to save the map with the dots using the Save button or you can clear all the dots by pressing the Reset button.

[Considerations]


You can use the program to scan for devices continuously. I used it to track around and discover what devices people are using. Needless to say that some had quite funny names or just adverts. I also picked up a TomTom device from a car. It's quite interesting and does fulfill some voyeuristic pleasure I guess. It's impressive though how many devices I've found... Tons of them, pages and pages of scrolling.



You can use the program to jack devices eh... In an educational manner, of course. Or to autojack while Whiskers discovers new devices. Please don't over-abuse it since it can be pretty annoying. In comparison to btCrawler or Bloover or whatever, Whiskers is meant to be the first tool before you use any of those. Bluesnarfing on newer devices is quite possible IF and only IF the user has accepted to pair with you. From then on, you could use one of those nifty tools which grant you access to all the cool and nasty features. I've seen a lot of discussion about being able to snarf without the user having to accept the pairing and, from what I've seen, sadly there is no such tool. Whiskers will try to get you paired but development in this department is halted for the time being.



The tracking feature currently uses my personal server. In time, when things get more stable I'll also publish the server-side part of Whiskers so you can make your own server (I have to, this is OpenSource). Of course, the search feature is only useful if you have a big enough database. It will also be possible to add your own maps rather than the default map.

SevenRains
23rd January 2009, 10:32 PM
[Pinboard]



The requirements state you need Microsoft Bluetooth Stack however, Whiskers relies on a third party library for Bluetooth management so it's not yet certain if it supports other stacks too.



Bluetooth and/or Wireless must be turned on or Whiskers won't report any device.



Currently I don't have many devices in the database for the Track tab. You are free to upload anything and if you want that file for yourself I'll send it happily. For the time being you can try searching for "khan" and type BT or "Wireless" and type AP. It will place some points in the UK and Romania. Once again, sorry, the dots are really small and hard to spot. What you could do is press the Save button, save the file and then view it on your computer screen. The dots should be light greenish and light blueish...



After using this program, please check in Settings -> System -> Device ID that your device name is still there. On a crash it may just leave the jack message there. Simply rename it back to what it was before.



[ Program may crash if you press the Upload or Search button and don't have an active internet connection. This will be fixed soon, I just wanted it to crash to spot some bugs but I forgot it on. The next unstable CAB will just fail gracefully ] - fixed.



Of course, with scanning on, the Scan tab will clutter up with devices that aren't in range anymore. Just save the log if you like and hit the clear button and it will update with devices currently in range.



There is currently no report whether the upload was successful or not and the same for the search. If you do choose to upload, make sure you search for a device you just uploaded using the search feature. If the upload was successful, it should show up.



The current Track logic is: if we found a new device and if we have a fix, log to GPX file. Best practice is to start tracking and then scanning. Once Whiskers has a satellite fix, it will log new devices to the GPX file. Once you hit the Track button, Whiskers will try to get a lock as fast as it can. Of course, as for any GPS device, it's good to try it while outside.

l3v5y
23rd January 2009, 10:58 PM
Looks interesting!

I feel like some "auditing".

Might it be an idea to have a direct link to the cab, so one doesn't have to download the whole VS solution?

Thanks!

EDIT:
First find:
Needs .Net CF 3.5 I think, not 2.0. Or at least it gave an error that required NETCFv35.Messages.EN.wm.cab to be installed to show the error.

SevenRains
23rd January 2009, 11:02 PM
Looks interesting!

I feel like some "auditing".

Might it be an idea to have a direct link to the cab, so one doesn't have to download the whole VS solution?

Thanks!

Hey l3v5y, nice to see you on a new quest! Yes, everything is a bit shaky at the moment but I'm updating the posts as fast as I can. Also, you may want to wait for some documentation because there is currently NONE. A lot of stuff needs explaining. For a quick start though: you need to turn on your bluetooth and/or your wireless (the program doesn't do this automatically for you). I hope you have a MS stack. I rely on some external libraries and I'm not sure what they have under the hood. Thanks!

EDIT: Bingo, I'll update to 3.5 thanks!

cspannos
24th January 2009, 12:04 AM
I'm getting this:


Whiskers.exe
DirectoryNotFoundException
An error message cannot be displayed because an optional resource assembly containing it cannot be found

at System.IO.__Error.WinIOError()
at System.IO.FileStream..ctor()
at System.IO.FileStream..ctor()
at System.Drawing.Bitmap..ctor()
at Whiskers.Whiskers..ctor()
at Whiskers.Program.Main()


...and I have NETCFv35 and NETCFv35.Messages both installed. How do I tell what bluetooth stack I have? I have a Sprint Touch Pro. Thanks!

SevenRains
24th January 2009, 12:07 AM
I'm getting this:


Whiskers.exe
DirectoryNotFoundException
An error message cannot be displayed because an optional resource assembly containing it cannot be found

at System.IO.__Error.WinIOError()
at System.IO.FileStream..ctor()
at System.IO.FileStream..ctor()
at System.Drawing.Bitmap..ctor()
at Whiskers.Whiskers..ctor()
at Whiskers.Program.Main()
...and I have NETCFv35 and NETCFv35.Messages both installed. How do I tell what bluetooth stack I have? I have a Sprint Touch Pro. Thanks!

You're doing fine, sorry the CAB file is broken: Give me 5 minutes, I'll upload the fix.

EDIT: Ok, fixed and uploaded. Please try again...

circuit breaker
24th January 2009, 02:08 AM
[More]
http://sourceforge.net/projects/whiskers/ (http://sourceforge.net/projects/sunscape/)


That link takes me to http://sourceforge.net/projects/sunscape/

nothin
24th January 2009, 02:53 AM
http://sourceforge.net/project/downloading.php?groupname=whiskers&filename=Whiskers-0.1.zip&use_mirror=surfnet
..bbut archive is broken, idd..or i am broken, lol..

SevenRains
24th January 2009, 12:05 PM
That link takes me to http://sourceforge.net/projects/sunscape/

Fixed now. That was pretty strange...

nothin
24th January 2009, 12:07 PM
Fixed now. That was pretty strange...

hheh, still sunscape site..

SevenRains
24th January 2009, 12:09 PM
http://sourceforge.net/project/downloading.php?groupname=whiskers&filename=Whiskers-0.1.zip&use_mirror=surfnet
..bbut archive is broken, idd..or i am broken, lol..

Yes, it seems that mirror screwed up the archive. You can try the:

http://sourceforge.net/projects/whiskers

and follow the download links. Sourceforge takes a while to replicate the file to all mirrors. It seems that the surfnet mirror broke the file.

EDIT: I'll see if I can re-add the zip file to sourceforge. Don't know what they did with it...

EDIT: Ok, I re-added the file to sourceforge, it should be ok after it replicates. I'll add the source to opening post for convenience.

EDIT: Mirror for source/stable added to opening post.

SevenRains
24th January 2009, 12:10 PM
hheh, still sunscape site..

You're kidding :D Should be fixed now...

EDIT: sourceforge really screwed up my files...

SevenRains
24th January 2009, 05:03 PM
Sorry peeps, I think I'm done with messing around with the release files. It's always like this at the beginning. Sourceforge took an older version (which would crash like the cab file did) and replicated that instead of the proper release.

Please use the CAB file. At the moment the CAB and the stable release are identical. I replaced the CAB with the proper version.

Initial post updated!

SevenRains
24th January 2009, 06:41 PM
Last minute fix for Script handling.

Initial post updated!

SevenRains
27th January 2009, 08:41 PM
And another fix for an occasional NullReferenceException.

Initial post updated!

jab1a
30th January 2009, 02:42 PM
This seems like an excellent sort of application, thank you for all your hard work.

I am just wandering if the latest version works on the Trinity?

I have installed the .CAB from the release folder but when I try the jack or auto jack feature the program crashes. I have turned bluetooth on and also left it off before trying but the same problem, also do i need beam on or off? or am I just not doing something simple.

Thank you for your help in advance

SevenRains
30th January 2009, 03:21 PM
This seems like an excellent sort of application, thank you for all your hard work.

I am just wandering if the latest version works on the Trinity?

I have installed the .CAB from the release folder but when I try the jack or auto jack feature the program crashes. I have turned bluetooth on and also left it off before trying but the same problem, also do i need beam on or off? or am I just not doing something simple.

Thank you for your help in advance

Hello, thanks for taking interest in Whiskers!

If you didn't get a crash when pressing the scan button, then the libraries are working correctly and Whiskers should definitely work on your device.

The release version had some bugs which have been fixed in the new Snapshot releases. Could you please try the latest snapshot release? (Whiskers-200901273619.CAB at the top will do fine!)

If you are still gettting a crash with the latest snapshot, could you please provide a few lines from the crash? (You can access those by pressing Details when the crash screen comes up)

Please tell me if this works for you!

jab1a
30th January 2009, 03:43 PM
Ok I have just installed Whiskers-200901273619.CAB and im getting the same problem. On the first tab (scan) I can hit scan but nothing happens, a few titles at the bottom are greyed out but thats it until I hit hit stop. If I go to the jack tab and hit jack or start autojack then it frezzes for a second and then crashes, here are a few lines from the details section:

Whiskers.exe
ArgumentOutOfRangeException
ArgumentOutOfRangeException
Parameter name: index

at
System.Collections.Array.get_Item(Int32 Index)
at

Does this help or do you need more?

Thank you again for your help

jab1a
30th January 2009, 03:48 PM
I posted too soon, the scan function is working and is picking up access points, but the jack feature is still the same

SevenRains
30th January 2009, 04:36 PM
Great, I was able to replicate the issue.

In order to Jack/Autojack you need to select a bluetooth device from the Scan tab (like the W850i that was detected in the first screenshot) and then press jack or turn on auto jack.

Of course, if there are no bluetooth devices detected in the Scan tab or if no bluetooth device is selected, the program doesn't know what to jack and auto jack fails miserably too.

In oder to jack: you need to select a bluetooth device from the Scan tab and then press the Jack button.

In order to autojack: you need to have at least one bluetooth device in the Scan tab before you press the autojack feature.

In the next release I'll include some checking so it will do nothing instead of crashing if no bluetooth device was selected or, for autojack, if there are no devices in the Scan tab.

Thanks for submitting this! In order to get it to work, please try jacking a bluetooth device or detecting a few devices before you start the autojack feature.

Of course, jacking is intended for bluetooth devices :-)

SevenRains
30th January 2009, 05:19 PM
New snapshot. This one fixes the crash when no device was selected and jack/autojack activated. It adds a proper quit menu item and a minimize menu item in case you don't have a proper task manager running.


Initial post updated!

SevenRains
31st January 2009, 10:14 PM
New snapshot. Implemented the comm function which will allow you to communicate with other Whiskers users through bluetooth. Although only for 10m bluetooth range, it may come in handy sometime. Feature is still being tested so it may take a while till it's fully stable.

Initial post updated!

jab1a
2nd February 2009, 12:33 PM
Excellent, Thank you so much for your time and help, the error is sorted now that I make sure I have something/one in the scan table, thank you for finding that out.

I 100% cant wait for you to fully change the Jack section to do it automaticly, the last software that I found could do this was called 'SMan' and it was for use with my old sony ericsson P800, since then I have tried lots of software that said it could do this but they were all terrible, these include....Smurf......Sniper.....BTCrawler, none of these worked well at all :(

If you manage to make this software as fun and useful as Sman (B'jack wise) then I would donate for your hard work.

SevenRains
2nd February 2009, 02:17 PM
Excellent, Thank you so much for your time and help, the error is sorted now that I make sure I have something/one in the scan table, thank you for finding that out.

I 100% cant wait for you to fully change the Jack section to do it automaticly, the last software that I found could do this was called 'SMan' and it was for use with my old sony ericsson P800, since then I have tried lots of software that said it could do this but they were all terrible, these include....Smurf......Sniper.....BTCrawler, none of these worked well at all :(


Great! Glad to hear it's working... Yes, some of those are outdated or converted to bloatware.

However, BTCrawler works nicely with jacking but... As the [Credits] say it fell apart.

Snarfing is not really possible anymore on newer devices (any connection requires a PIN). And I don't think I'll include any snarfing functionality just to be able to attack cellphones which even our grandmas don't use anymore.

The Autojacking feature is now "patched" so it won't throw an error if there is no initial device.

Just go to Jack tab -> "Start Autojack" then go to Scan tab -> "Start".

Or in reverse order... As soon as Whiskers picks up new devices it will start cycling and jacking them. You can switch to the Scan tab and watch the selection move. The device being jacked is the current selected one.

As a side note, you will see that if you have wifi on, it will skip the access points since they can't be jacked.


If you manage to make this software as fun and useful as Sman (B'jack wise) then I would donate for your hard work.


Thanks a lot! I appreciate that but I don't accept donations primarily because I can't guarantee the quality of the software I produce. I develop for fun and for knowledge. If I would accept donations for my software that would, in my view, oblige me to guarantee some sort of quality. However, the offer is more than enough to get me motivated! Thank you! :D

wilc
2nd February 2009, 04:59 PM
nice program...

it will be usefull to have some sort of feedback directly in the tabs where you do operations...

example.... in the bluejack tab a windows or something similar that shows the phone you are jacking and the result of the jacking....


Mau

SevenRains
2nd February 2009, 07:50 PM
nice program...

it will be usefull to have some sort of feedback directly in the tabs where you do operations...

example.... in the bluejack tab a windows or something similar that shows the phone you are jacking and the result of the jacking....


Mau

Thanks for taking interest in Whiskers!

Yep, some sort of feedback would be nice. I'll see what I can do... I still have to work out the (non-existant) documentation in the program itself.

SevenRains
2nd February 2009, 07:52 PM
New snapshot! This one implements jacking logics (I'll add documentation for them all in the first posts), adds the ability to vibrate the phone on different beacons (bluetooth and wifi), fixes opening log files (given that they're properly formated, it will correctly add the colors).

Initial post updated!

jab1a
3rd February 2009, 02:14 PM
Thank you SevenRains,

I full understand about the donation issue. I just want you know that your hard work is appreciated and brings a huge smile to my face.
I've installed the latest snapshot and have done a quick test and everything seems to be running fine now, I will give your software the ultimate test tonight when I go to the pub for happy hour and I will report back tommorow.

have you got anymore great idea's to add to your software or anything in the pipeline?

Keep up the good work

SevenRains
4th February 2009, 12:51 AM
Thank you SevenRains,

I full understand about the donation issue. I just want you know that your hard work is appreciated and brings a huge smile to my face.
I've installed the latest snapshot and have done a quick test and everything seems to be running fine now, I will give your software the ultimate test tonight when I go to the pub for happy hour and I will report back tommorow.

have you got anymore great idea's to add to your software or anything in the pipeline?

Keep up the good work

Thanks! Hope that fared well... Found some "interesting" devices? Found stuff like ^-Sexylicious-^, TomTom devices from cars, found a headset once in pairing mode hehe...

Currently I have just one more idea before I release 0.2 but I'm always on the lookout for new stuff... I was thinking about including an sdp browser so you can list the services on a device but I wonder whether that's useful since there are many useful utilities out there that can do it for you (even the built-in bluetooth interface can do that actually). So I'm not so sure...

If you have anything to suggest, please go ahead! That's what opensource development is after all... :-)

SevenRains
6th February 2009, 11:11 AM
Quick fix. I noticed that certain uploads didn't show on the map. That's because some devices use a "," for decimal notation and others a ".". This varies with different regions. I have forced all decimal notations to use "." when building the gpx file for upload. I'll keep an eye out for incoming "," decimal uploads and fix them as they come till everybody updates to the new version.

Initial post updated!

SevenRains
8th February 2009, 05:51 PM
nice program...

it will be usefull to have some sort of feedback directly in the tabs where you do operations...



New update. This one implements a global feedback pipe and certain events will report on status.

The map was overhauled. Now, when you search and find a device, the map will zoom. You'll also be able to zoom in and out of the map by clicking it.

Initial post updated!

SevenRains
27th February 2009, 01:36 PM
A new hotfix. This version properly handles the message box so you can input any custom message. It wasn't handled before. Sorry.

This version also allows you to deploy Whiskers to other machines using the Comm tab.

Initial post updated!

KMEKME
10th July 2009, 09:17 PM
[Documentation]

In this documentation I will refer to the screenshots in the initial post. If you look at the tabs at the bottom you'll see four of them: "Scan", "Jack", "Script" and "Track". I'll try to walk you through all of those step-by-step since currently there is no documentation.



Scan

This is the main tab of Whiskers. It will not only scan for devices whether Bluetooth or Wireless but you will also be able to do various things with the found devices.



For a quick start, your bluetooth and/or wireless adapter has to be switched on. Whiskers doesn't do this for you and should fail silently if it doesn't find the adapter turned on.



Then you can just hit the Scan button and Whiskers will start to scan for devices or access points around you.



You can press "Clear" to flush current found devices or press "Delete" to remove individual devices from the list. Naturally, if Whiskers is scanning it will probably find the device again.



The input box right next to the Start button is the scanning time interval measured in milliseconds. That is, the time for which Whiskers will pause between scanning. You can set it at your convenience but 1000ms (1s) is quite a good value.



The Open / Save buttons you can use to open a saved list or store a saved list.

Let's move on to the Comm tab.


Comm

This tab is meant for communicating with other users using Whiskers. Although it's only based on bluetooth and hence the short range, it may come in handy when other Whiskers features will be implemented.


To communicate with a device, first make sure you've scanned it using the Scan tab, enter your message in the box below and click Send. If the other device is using Whiskers and is in listening mode, after a couple of tries your message should appear on your screen and on the other device's screen.



To receive messages, you must have clicked the Start Listening button which will make Whiskers listen to all incoming messages.

And now the Jack tab.


Jack

This tab is meant for jacking / autojacking. I have some development ideas which I won't divulge just yet but for the time being only this form of eh... annoyance is possible. The whole concept started from quite an old java applet I used to have on my mobile phone... You could set it to jack a message continuously and you'd just stroll around and it would jack any device which came in range.



To jack a device (only bluetooth devices, of course) you select a device in the Scan tab, then select the Jack method, either pairing or file, enter your message (the shorter the message the better!) and press the Jack button.



To autojack, you enter your message and and select a jacking logic (rotation - Whiskers will rotate in a round-robin fashion going through all devices, first in - Whiskers will jack any "new" device it finds, random - Whiskers will randomly select devices from the Scan tab) and press the Start AutoJack button. If you switch to the Scan tab you will see which device Whiskers is currently jacking. The time to live (TTL) is how much Whiskers will wait for a timeout while jacking a device (10 000ms, 10 seconds should give enough time to properly jack a device).

Please use this feature responsibly :-) Let's move on to the Script tab.



Script

The purpose of this feature is to execute certain commands when a specific device is detected. You can search for a specific address, device name, type of device (the drop down boxes will help you choose), and whether it should be a BT (Bluetooth) device or an AP (access point).



To add a script, you may choose to fill any or none of the filters. You can search for a device name... Or maybe just a device class... Then you write or browse for an executable and fill in any optional parameters and click Add. You can later add the script by just clicking the script in the big box.



The next step is to enable scripts by clicking the Enable Scripts button. The time frequency (in milliseconds) is how often the scripts will trigger on the devices it finds.

That's it for the Script tab.



Track

Uh. This is a difficult one. The Track tab, given you have a GPS device, will log at what latitude and longitude it found a device. It will store this in a GPX file along with the device name and device address. Optionally, of course, once you've gathered some data, you may choose to press the Upload button which will upload the GPX file to a central server [I'll explain this more in the next post]. Given that some user spotted a specific device and has uploaded it to the server, you can search for devices using the search feature. This will place dots on the map [They may be hard to see on the default map, and I'm sorry for this, I'm still searching for solutions] at the respective locations. You can then choose to save the map with the dots using the Save button or you can clear all the dots by pressing the Reset button.

[Considerations]


You can use the program to scan for devices continuously. I used it to track around and discover what devices people are using. Needless to say that some had quite funny names or just adverts. I also picked up a TomTom device from a car. It's quite interesting and does fulfill some voyeuristic pleasure I guess. It's impressive though how many devices I've found... Tons of them, pages and pages of scrolling.



You can use the program to jack devices eh... In an educational manner, of course. Or to autojack while Whiskers discovers new devices. Please don't over-abuse it since it can be pretty annoying. In comparison to btCrawler or Bloover or whatever, Whiskers is meant to be the first tool before you use any of those. Bluesnarfing on newer devices is quite possible IF and only IF the user has accepted to pair with you. From then on, you could use one of those nifty tools which grant you access to all the cool and nasty features. I've seen a lot of discussion about being able to snarf without the user having to accept the pairing and, from what I've seen, sadly there is no such tool. Whiskers will try to get you paired but development in this department is halted for the time being.



The tracking feature currently uses my personal server. In time, when things get more stable I'll also publish the server-side part of Whiskers so you can make your own server (I have to, this is OpenSource). Of course, the search feature is only useful if you have a big enough database. It will also be possible to add your own maps rather than the default map.



Hi!
Your sw seems great. However, I can't find the comm tab that you mention. Can you pls explain?

Best regards,

KME