Popularity
8.7
Growing
Activity
9.3
Declining
4,800
183
1,100

Description

Scapy is a powerful Python-based interactive packet manipulation program and library.

It is able to forge or decode packets of a wide number of protocols, send them on the wire, capture them, match requests and replies, and much more.

It can easily handle most classical tasks like scanning, tracerouting, probing, unit tests, attacks or network discovery (it can replace hping, 85% of nmap, arpspoof, arp-sk, arping, tcpdump, tethereal, p0f, etc.). It also performs very well at a lot of other specific tasks that most other tools can't handle, like sending invalid frames, injecting your own 802.11 frames, combining technics (VLAN hopping+ARP cache poisoning, VOIP decoding on WEP encrypted channel, ...), etc.

See interactive tutorial and the quick demo: an interactive session (some examples may be outdated).

Code Quality Rank: L2
Programming language: Python
License: GNU General Public License v2.0 only
Tags: Networking     Hardware     Security     System     Monitoring    
Latest version: v2.4.3rc4

scapy alternatives and similar packages

Based on the "Hardware" category

Do you think we are missing an alternative of scapy or a related project?

Add another 'Hardware' Package

README

<!-- start_ppi_description -->

Scapy

Travis Build Status <!-- ignore_ppi --> AppVeyor Build status <!-- ignore_ppi --> Codecov Status <!-- ignore_ppi --> Codacy Badge <!-- ignore_ppi --> PyPI Version Python Versions [License: GPL v2](LICENSE) Join the chat at https://gitter.im/secdev/scapy <!-- ignore_ppi -->

Scapy is a powerful Python-based interactive packet manipulation program and library.

It is able to forge or decode packets of a wide number of protocols, send them on the wire, capture them, store or read them using pcap files, match requests and replies, and much more. It is designed to allow fast packet prototyping by using default values that work.

It can easily handle most classical tasks like scanning, tracerouting, probing, unit tests, attacks or network discovery (it can replace hping, 85% of nmap, arpspoof, arp-sk, arping, tcpdump, wireshark, p0f, etc.). It also performs very well at a lot of other specific tasks that most other tools can't handle, like sending invalid frames, injecting your own 802.11 frames, combining techniques (VLAN hopping+ARP cache poisoning, VoIP decoding on WEP protected channel, ...), etc.

Scapy supports Python 2.7 and Python 3 (3.4 to 3.7). It's intended to be cross platform, and runs on many different platforms (Linux, OSX, *BSD, and Windows).

Getting started

Scapy is usable either as a shell or as a library. For further details, please head over to Getting started with Scapy, which is part of the documentation.

Shell demo

Scapy install demo

Scapy can easily be used as an interactive shell to interact with the network. The following example shows how to send an ICMP Echo Request message to github.com, then display the reply source IP address:

sudo ./run_scapy
Welcome to Scapy
>>> p = IP(dst="github.com")/ICMP()
>>> r = sr1(p)
Begin emission:
.Finished to send 1 packets.
*
Received 2 packets, got 1 answers, remaining 0 packets
>>> r[IP].src
'192.30.253.113'

Resources

The documentation contains more advanced use cases, and examples.

Other useful resources:

Installation

Scapy works without any external Python modules on Linux and BSD like operating systems. On Windows, you need to install some mandatory dependencies as described in the documentation.

On most systems, using Scapy is as simple as running the following commands:

git clone https://github.com/secdev/scapy
cd scapy
./run_scapy

To benefit from all Scapy features, such as plotting, you might want to install Python modules, such as matplotlib or cryptography. See the documentation and follow the instructions to install them.

<!-- stop_ppi_description -->

Contributing

Want to contribute? Great! Please take a few minutes to [read this](CONTRIBUTING.md)!


*Note that all licence references and agreements mentioned in the scapy README section above are relevant to that project's source code only.