From 5ddb842269474f93c53547c2e66059f33dc0e1b6 Mon Sep 17 00:00:00 2001
From: bauthard <8293321+bauthard@users.noreply.github.com>
Date: Sat, 4 Apr 2020 22:16:21 +0530
Subject: [PATCH] Update README.md
---
README.md | 139 +++++++++++++++++++++++++++++++++++++++++++++++++++++-
1 file changed, 138 insertions(+), 1 deletion(-)
diff --git a/README.md b/README.md
index b5740d09..3835b2bb 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,140 @@
+
+
+
+
+
+
+[![License](https://img.shields.io/badge/license-MIT-_red.svg)](https://opensource.org/licenses/MIT)
+[![Go Report Card](https://goreportcard.com/badge/github.com/projectdiscovery/nuclei)](https://goreportcard.com/report/github.com/projectdiscovery/nuclei)
+[![contributions welcome](https://img.shields.io/badge/contributions-welcome-brightgreen.svg?style=flat)](https://github.com/projectdiscovery/nuclei/issues)
+
# nuclei
-Nuclei is a fast tool to scan for things using configurable templates
+Nuceli is a fast tool to scan for things using configurable templates
+
+# Resources
+- [Resources](#resources)
+- [Features](#features)
+- [Usage](#usage)
+- [Installation Instructions](#installation-instructions)
+ - [Prerequisite](#prerequisite)
+ - [Direct Installation](#direct-installation)
+ - [From Binary](#from-binary)
+ - [From Source](#from-source)
+- [Running nuclei](#running-nuclei)
+ - [1. Running nuclei with single template](#running-nuclei-with-a-single-template)
+ - [2. Running nuclei with multiple template](#running-nuclei-with-a-multiple-template)
+
+
+
+ - [A note on nuclei](#a-note-on-nuclei)
+- [License](#license)
+
+ # Features
+
+
+
+
+
+
+ - Simple and modular code base making it easy to contribute.
+ - Fast And Simple active subdomain scanning.
+ - Handles wildcard subdomains in a smart manner.
+ - Optimized for **ease of use**
+ - **Stdin** and **stdout** support for integrating in workflows
+
+# Usage
+
+```bash
+nuclei -h
+```
+
+This will display help for the tool. Here are all the switches it supports.
+
+| Flag | Description | Example |
+|----------------|---------------------------------------------------------|--------------------------------------|
+| -c | Number of concurrent requests (default 10) | nuclei -c 100 |
+| -l | List of urls to run templates | nuclei -l urls.txt |
+| -t | Templates input file/files to check across hosts | nuclei -t git-core.yaml |
+| -t | Templates input file/files to check across hosts | nuclei -t templates/*.yaml |
+| -nC | Don't Use colors in output | nuclei -nC |
+| -o | File to save output result (optional) | nuclei -o output.txt |
+| -silent | Show only found results in output | nuclei -silent |
+| -retries | Number of times to retry a failed request (default 1) | nuclei -retries 1 |
+| -t | Seconds to wait before timeout (default 5) | nuclei -t 5 |
+| -v | Show Verbose output | nuclei -v |
+| -version | Show version of nuclei | nuclei -version |
+
+
+# Installation Instructions
+
+
+## Direct Installation
+
+### From Binary
+
+The installation is easy. You can download the pre-built binaries for your platform from the [Releases](https://github.com/projectdiscovery/nuclei/releases/) page. Extract them using tar, move it to your $PATH and you're ready to go.
+
+```bash
+> tar -xzvf nuclei-linux-amd64.tar
+> mv nuclei-linux-amd64 /usr/bin/nuclei
+> nuclei -h
+```
+
+### From Source
+
+nuclei requires go1.13+ to install successfully. Run the following command to get the repo -
+
+```bash
+> GO111MODULE=on go get -u -v github.com/projectdiscovery/nuclei/cmd/nuclei
+```
+
+In order to update the tool, you can use -u flag with `go get` command.
+
+# Running nuclei
+
+nuclei supports two types of input.
+
+### 1. Running nuclei with a single template.
+
+This will run the tool against all the hosts in `urls.txt` and returns the matched results.
+
+```bash
+> nuclei -l urls.txt -t git-core.yaml
+```
+
+
+You can also pass the list of hosts at standard input (STDIN). This allows for easy integration in automation pipelines.
+
+This will run the tool against all the hosts in `urls.txt` and returns the matched results.
+
+
+```bash
+> cat urls.txt | nuclei -t git-core.yaml
+```
+
+### 2. Running nuclei with a multiple template.
+
+This will run the tool against all the hosts in `urls.txt` and returns the matched results.
+
+```bash
+> nuclei -l urls.txt -t "path-to-templates/*.yaml" -o results.txt
+```
+
+
+You can also pass the list of hosts at standard input (STDIN). This allows for easy integration in automation pipelines.
+
+This will run the tool against all the hosts in `urls.txt` and returns the matched results.
+
+
+```bash
+> cat urls.txt | nuclei -t "path-to-templates/*.yaml" -o results.txt
+```
+
+
+### A note on nuclei
+
+
+# License
+
+nuclei is made with 🖤 by the [projectdiscovery](https://projectdiscovery.io) team. Community contributions have made the project what it is. See the **[Thanks.md](https://github.com/projectdiscovery/nuclei/blob/master/THANKS.md)** file for more details.