GUI HTTP Sniffer

                 *     .--.
                      / /  `
     +               | |
            '         \ \__,
        *          +   '--'  *
          +   /\
+           .'  '.  *    ███████╗        ██╗  ██╗            ███████╗
    *      /======\  +   ██╔════╝        ██║  ██║            ██╔════╝
          ;:.  _   ;     ██║  ███╗       ███████║            ███████╗
          |:. (_)  |     ██║   ██║       ██╔══██║___ ___  __ ╚════██║        ___  ___  ___  __ 
          |:.  _   |     ╚██████╔╝|  | | ██║  ██║ |   |  |__)███████║|\ | | |__  |__  |__  |__)
  +       |:. (_)  |   *  ╚═════╝ \__/ | ╚═╝  ╚═╝ |   |  |   ╚══════╝| \| | |    |    |___ |  \
          ;:.      ;                         🌠 𝖇𝖞 𝕽𝖔𝖘𝖈𝖆 𝕴𝖔𝖓𝖚𝖙
        .' \:.    / `.
       / .-'':._.'`-. \
       |/    /||\    \|
    jgs _..--"""````"""--.._
  _.-'``                    ``'-._
-'                                '-

GUI HTTP Sniffer i.e. GHS, is a layer-7 sniffer, targeting unencrypted HTTP traffic and is capable of reading and analyzing that traffic. It also supports, among others, basic traffic filtering and sniffing specific network interfaces.

Building Documentation

Go to docs/ directory and run make html. A new directory called build/ will be created inside the docs/ directory, and you can open docs/build/html/index.html with a web browser to view the documentation.

Git Branching Model

Starting with v0.1.1, this repository implements the Gitflow model. Note that this repository uses / instead of - for naming branches. e.g.: feature/whatever instead of feature-whatever.

What's important to know:

• If you want to go back in time to a specific version, you can find it's associated branch: release/<version>
• What's in master is "production-ready"

Resources

• RFC 791 - IP Header Format
• RFC 793 - TCP Header Format
• Python struct module
• Python socket module
• rich module's Read The Docs
• rich module's Github Page
• What is the difference between recv and recvfrom? Let's find out
• Value for the protocol argument in socket() call: htons(0x800)
• Linux cooked-mode capture: Wireshark docs
• Socket options list: Shichao's Notes
• Async IO in Python: A Complete Walkthrough: Real Python
• Auto-Documenting a Python Project Using Sphinx: BetterProgramming

Changelog

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning. In order to view the changes for each version, please consult the CHANGELOG file.

License

The GUI HTTP Sniffer project is available under the GNU General Public License v3.0 License. For the full license text please read the LICENSE file.