Metadata-Version: 2.1
Name: snapper
Version: 0.0.9
Summary: A security tool for grabbing screenshots of many web                      hosts.
Home-page: UNKNOWN
License: UNKNOWN
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Description-Content-Type: text/markdown
Requires-Dist: flask (==1.1.1)
Requires-Dist: flask-restful (==0.3.7)
Requires-Dist: Jinja2 (==2.10.1)
Requires-Dist: pyyaml
Requires-Dist: requests (==2.22.0)
Requires-Dist: selenium (==3.141.0)
Requires-Dist: urllib3 (==1.25.3)

# Snapper
A security tool for grabbing screenshots of many web hosts. This tool is useful after [DNS enumeration](https://github.com/mschwager/fierce) or after enumerating web hosts via nmap or nessus.

## How to install 


- Pypl package
```bash
pip install -i  https://test.pypi.org/simple/ snapper
```

- Install phantomJS (you need to have [npm installed](https://nodejs.org/en/download/package-manager/))
```bash
npm -g install phantomjs
```

## How to use
### On the server side

To start up the application from pypi:

```
snap
```

You can also launch it directly from [github](https://github.com/revisor48/Snapper), make sure requirenment.txt is satisfied:

```
python cli.py
```
### On the user side
POST command populates the data:
```
curl -XPOST -H 'Content-Type: application/json' -d '{"urls": ["google.com", "gmail.google.com", "ads.google.com"]}' http://127.0.0.1:8000/api/v1/submit
```

This kicks off 3 processes, each of which fetch screenshots of the http and https versions of the hosts in question. 
![output results](http://i.imgur.com/OlvyIBp.png)
Each POST request has an id, which you can use to access the data outputted by it. The output is saved on the server side in the "output" folder and the path to it is returned as json by GET command:
```
curl -XGET http://127.0.0.1:8000/api/v1/tasks/164157d3-472d-4e25-8488-389e206d24bb
```

You can view the results [here](https://security.love/Snapper/output). Note in addition to the server, the static files are available in your current working directory as "output"


## More options

```bash
snap --help
```

```
Options:
  -h, --help            show this help message and exit
  -u USER_AGENT, --user-agent=USER_AGENT
                        The user agent used for requests
  -o OUTPUT_DIR, --output=OUTPUT_DIR	
  						Directory for output
  -l LOGS, --log_level=LOGS 
  						Logging facility level
  -t TIMEOUT, --timeout=TIMEOUT
                        Number of seconds to try to resolve
  -p PORT, --port=PORT  Port to run server on
  -H HOST, --host=HOST  Host to run server on  
  -v                    Display console output for fetching each host

```


