README.md

October 24, 2022 · View on GitHub


Logo

A Incredible fast and Powerful HTTP toolkit

License GitHub Repo stars version
downloads Libraries.io SourceRank
Report Bug · Request Feature

Getting Started

Basic

Prerequisites

You need NodeJs 10 or later to run this tool. You can install NodeJs :

  • On Linux
    sudo apt-get install nodejs
    
  • On Termux
    pkg install nodejs-lts
    

Installation

Using npm

npm install -g -s httpfy

Install locally

git clone https://github.com/devXprite/httpfy.git
cd httpfy
npm install
node index.js -h

Uninstall

npm remove httpfy -g

Usage

httpfy -f <filename containing urls>

Options

ShortOptionsTypeDescription
-v--versionprobeoutput the current version
-f--filestringinput file containing list of URLs
-sc--status-codeprobedisplay response status-code
-cl--content-lengthprobedisplay response content-length
-ct--content-typeprobedisplay response content-type
-rt--response-timeprobedisplay response time
-lc--line-countprobedisplay response body line count
-wc--word-countprobedisplay response body word count
-ws--web-serveprobedisplay web server name
-rl--redirect-locationprobedisplay redirect location
-m--methodprobedisplay http request method
-nc--no-colorprobedisable colors in cli output
-ttl--titleprobedisplay page title
-fl--failedprobedisplay failed request's
-nr--no-redirectprobedon't follow redirects
-mr--max-redirectnumbermaximum redirects to follow
-t--threadsnumbermaximum cocurrent requests send (default: 100)
-i--intervalnumberinterval between each thread in seconds
-c--cookiestringsend cookies (--cookie 'login=Yes')
-H--headerstringcustom http headers to send (--header 'X-MyHeader: XYZ')
-x--request-methodsstringset request methods use 'all' to probe all HTTP methods
-pc--protocolstringset request Protocol (default: "https")
-path--request-pathstringpath or list of paths (-path admin,login)
-param--request-paramstringset request parameters (-param id=5)
-ua--user-agentstringset custom useragent
-time--timeoutnumberset request timeout in seconds
-mc--match-codenumbers[]match response with specified status code (-mc 200,404)
-ml--match-lengthnumbers[]match response with specified content length (-ml 800,900)
-mlc--match-line-countnumbers[]match response body with specified line count (-mlc 100,102)
-ms--match-stringstrings[]match response with specified strings (-ms admin)
-o--output-filestringsave results in a single file (-o result.txt)
-of--output-folderstringsave response of url in multiple files (-of result)
-h--helpprobedisplay help for command

Examples

Basic

  • httpfy -f urls.txt -sc -ttl -fl
    
    Basic

Try all Http Methods

  • httpfy -f urls.txt -sc -m -x all
    
    All

File/Path Bruteforce

  • httpfy -f urls.txt -path admin,login -sc
    
    Brute

Run with Gitpod

Click this button to run your project on Gitpod which comes with pre-configured environment you need.

Open in Gitpod

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

  1. Fork the Project
  2. Create your Branch
  3. Commit your Changes
  4. Push to the Branch
  5. Open a Pull Request

Supporters

Stargazers:

Stargazers repo roster for @devXprite/httpfy

Forkers

Forkers repo roster for @devXprite/httpfy

License

Distributed under the GPL-3.0 license. See LICENSE.txt for more information.