Skip to content

Commit

Permalink
Merge pull request #1 from Bevigil/new_readme
Browse files Browse the repository at this point in the history
New readme and MANIFEST
  • Loading branch information
Bevigil authored May 26, 2022
2 parents 5ee32a1 + cf64173 commit ed95655
Show file tree
Hide file tree
Showing 5 changed files with 25 additions and 7 deletions.
1 change: 1 addition & 0 deletions MANIFEST.in
Original file line number Diff line number Diff line change
@@ -1,2 +1,3 @@
recursive-include bevigil *
recursive-include static *
include requirements.txt
31 changes: 24 additions & 7 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,31 +1,33 @@
bevigil-cli
=================

This package provides a unified command line interface and python library for using BeVigil OSINT API.
![](./static/logo.png)

`bevigil-cli` provides a unified command line interface and python library for using BeVigil OSINT API.

Getting Started
---------------

Installation
------------

The safest way to install the BeVigil OSINT CLI is to use [pip](https://pip.pypa.io/en/stable/):
The easiest way to install the BeVigil OSINT CLI is to use [pip](https://pip.pypa.io/en/stable/):

```bash
$ pip3 install bevigil-cli
$ pip3 install bevigil-cli
```

If you already have the bevigil-cli package installed and want to upgrade to the
latest version, you can run:

```bash
$ pip3 install --upgrade bevigil-cli
$ pip3 install --upgrade bevigil-cli
```

This will install the bevigil-cli package as well as all dependencies.


Usage
## Usage
------------

Initialization
Expand All @@ -35,7 +37,7 @@ Before using the bevigil-cli to extract assets, you need to configure your api k
You can do this using the ``init`` command:

```bash
$ bevigil-cli init --api-key <API_KEY>
$ bevigil-cli init --api-key <API_KEY>
```

To get an API key, you can register at [BeVigil's website](https://bevigil.com/osint-api)
Expand Down Expand Up @@ -267,6 +269,15 @@ $ bevigil-cli enum urls --domain "example.com"
}
```

### Demonstration
---
The following media demonstrates how `bevigil-cli` can be used for:
* Extracting URL parameters associated with an android package ID
* Extracting subdomains associated with a domain

![](./static/cmd_demo.gif)


## Tab Autocompletion
Tab autocompletion of commands can be activated either by adding an entry manually to your shell config file or using bevigil-cli inbuilt option.

Expand Down Expand Up @@ -299,7 +310,7 @@ This command allows bevigil-cli to automatically detect your shell type and writ
Once the entry is added, user needs to restart the terminal for the changes to take effect.


Code Integration
## Code Integration
------------------
To integrate the tool in your project, simply import the `BeVigil` class from `bevigil` package.

Expand All @@ -313,6 +324,12 @@ In [3]: packages = bevigil.getPackagesFromDomain(domain = "netflix.com")
In [4]: wordlist = bevigil.getUrlsFromDomain(domain = "netflix.com")
```

### Demo
---------
The following media demonstrates how BeVigil class can be utilized for extraction of assets.

![](./static/code_demo.gif)

Every asset that can be obtained from CLI is accessible through these functions. Following is the list of available functions that you can use in your project to query BeVigil API to extract data.

* `getHostsFromPackage(package_id)` => Takes package ID of an android application as argument and returns JSON data containing hosts extracted from that pacakge.
Expand Down
Binary file added static/cmd_demo.gif
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/code_demo.gif
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/logo.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit ed95655

Please sign in to comment.