Metadata-Version: 1.0
Name: bleah
Version: 1.0.0
Summary: # BLEAH 

A BLE scanner for "smart" devices hacking based on the `bluepy` library, dead easy to use because retarded devices should be dead easy to hack. Explanatory post and screenshots [can be found here](https://www.evilsocket.net/2017/09/23/This-is-not-a-post-about-BLE-introducing-BLEAH/).

## How to Install

Install building prerequisites:

    sudo apt-get install git build-essential libglib2.0-dev python-setuptools

Install [bluepy](https://github.com/IanHarvey/bluepy) from source:

    git clone https://github.com/IanHarvey/bluepy.git
    cd bluepy
    python setup.py build
    sudo python setup.py install

Then install `bleah`:

    git clone https://github.com/evilsocket/bleah.git
    cd bleah
    python setup.py build
    sudo python setup.py install

## Usage

From the `-h` help menu:

    usage: bleah [-h] [-i HCI] [-t TIMEOUT] [-s SENSITIVITY] [-b MAC] [-f] [-e] [-u UUID] [-d DATA] [-r DATAFILE]

    optional arguments:
      -h, --help            show this help message and exit
      -i HCI, --hci HCI     HCI device index.
      -t TIMEOUT, --timeout TIMEOUT
                            Scan delay, 0 for continuous scanning.
      -s SENSITIVITY, --sensitivity SENSITIVITY
                            dBm threshold.
      -b MAC, --mac MAC     Filter by device address.
      -f, --force           Try to connect even if the device doesn't allow to.
      -e, --enumerate       Connect to available devices and perform services
                            enumeration.
      -u UUID, --uuid UUID  Write data to this characteristic UUID (requires --mac
                            and --data).
      -d DATA, --data DATA  Data to be written.
      -r DATAFILE, --datafile DATAFILE
                            Read data to be written from this file.

**Examples**

Keep scanning for BTLE devices:

    sudo bleah -t0

Connect to a specific device and enumerate all the things:

    sudo bleah -b "aa:bb:cc:dd:ee:ff" -e

Write the bytes `hello world` to a specific characteristic of the device:

    sudo bleah -b "aa:bb:cc:dd:ee:ff" -u "c7d25540-31dd-11e2-81c1-0800200c9a66" -d "hello world"

## License

`bleah` is released under the GPL 3.0 license and it's copyleft of Simone 'evilsocket' Margaritelli

Home-page: http://www.github.com/evilsocket/bleah
Author: Simone Margaritelli
Author-email: evilsocket@protonmail.com
License: GPL
Description: # BLEAH 
        
        A BLE scanner for "smart" devices hacking based on the `bluepy` library, dead easy to use because retarded devices should be dead easy to hack. Explanatory post and screenshots [can be found here](https://www.evilsocket.net/2017/09/23/This-is-not-a-post-about-BLE-introducing-BLEAH/).
        
        ## How to Install
        
        Install building prerequisites:
        
            sudo apt-get install git build-essential libglib2.0-dev python-setuptools
        
        Install [bluepy](https://github.com/IanHarvey/bluepy) from source:
        
            git clone https://github.com/IanHarvey/bluepy.git
            cd bluepy
            python setup.py build
            sudo python setup.py install
        
        Then install `bleah`:
        
            git clone https://github.com/evilsocket/bleah.git
            cd bleah
            python setup.py build
            sudo python setup.py install
        
        ## Usage
        
        From the `-h` help menu:
        
            usage: bleah [-h] [-i HCI] [-t TIMEOUT] [-s SENSITIVITY] [-b MAC] [-f] [-e] [-u UUID] [-d DATA] [-r DATAFILE]
        
            optional arguments:
              -h, --help            show this help message and exit
              -i HCI, --hci HCI     HCI device index.
              -t TIMEOUT, --timeout TIMEOUT
                                    Scan delay, 0 for continuous scanning.
              -s SENSITIVITY, --sensitivity SENSITIVITY
                                    dBm threshold.
              -b MAC, --mac MAC     Filter by device address.
              -f, --force           Try to connect even if the device doesn't allow to.
              -e, --enumerate       Connect to available devices and perform services
                                    enumeration.
              -u UUID, --uuid UUID  Write data to this characteristic UUID (requires --mac
                                    and --data).
              -d DATA, --data DATA  Data to be written.
              -r DATAFILE, --datafile DATAFILE
                                    Read data to be written from this file.
        
        **Examples**
        
        Keep scanning for BTLE devices:
        
            sudo bleah -t0
        
        Connect to a specific device and enumerate all the things:
        
            sudo bleah -b "aa:bb:cc:dd:ee:ff" -e
        
        Write the bytes `hello world` to a specific characteristic of the device:
        
            sudo bleah -b "aa:bb:cc:dd:ee:ff" -u "c7d25540-31dd-11e2-81c1-0800200c9a66" -d "hello world"
        
        ## License
        
        `bleah` is released under the GPL 3.0 license and it's copyleft of Simone 'evilsocket' Margaritelli
        
Platform: UNKNOWN
