Scapy: the Python-based interactive packet manipulation program & library. Supports Python 2 & Python 3.
Clone or download
Latest commit 4d00d63 Sep 16, 2018
Permalink
Failed to load latest commit information.
.appveyor Tox on Windows Jun 19, 2018
.github Fix PULL_REQUEST_TEMPLATE checklist format Jun 5, 2018
.travis Remove PIP detection Aug 6, 2018
bin fix windows batches errors that causes the wrong python to be run or … Mar 27, 2018
doc Some more documentation on automotive stuff Sep 11, 2018
scapy Merge pull request #1601 from gpotter2/python3.7 Sep 16, 2018
test Merge pull request #1573 from p-l-/fix-linux-no-ip Sep 11, 2018
.appveyor.yml Tox on Windows Jun 19, 2018
.codecov.yml Add a codecov configuration file Jan 2, 2017
.coveragerc Exclude external Python modules Jan 31, 2018
.coveragerc.tox Test TLS automta with tox Apr 24, 2018
.gitattributes Add .gitattributes encoding May 31, 2017
.gitignore Revert "Export-subst util: change format" Aug 16, 2018
.travis.yml Add test to check Garbage disposal Jul 19, 2018
CONTRIBUTING.md A few more notices in CONTRIBUTING.md Sep 15, 2018
LICENSE Add license file May 14, 2015
MANIFEST.in enhance version management Sep 5, 2016
README enhance version management Sep 5, 2016
README.md Add PyPi description May 15, 2018
run_scapy making scapy runnable module Mar 27, 2018
run_scapy.bat New .bat's + disable __pycache__ Oct 8, 2017
run_scapy_py2 Use '.' instead of 'source' Nov 17, 2017
run_scapy_py2.bat making scapy runnable module Mar 27, 2018
run_scapy_py3 Use '.' instead of 'source' Nov 17, 2017
run_scapy_py3.bat making scapy runnable module Mar 27, 2018
setup.cfg Specify the license file in setup.cfg Jun 12, 2018
setup.py Implementation of GMLAN Protocol for Scapy Jun 24, 2018
tox.ini Explicitly ignore E731 Sep 8, 2018

README.md

Scapy

Travis Build Status AppVeyor Build Status Codecov Status PyPI Version Python Versions License: GPL v2 Join the chat at https://gitter.im/secdev/scapy

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.6). It's intended to be cross platform, and runs on many different platforms (Linux, OSX, *BSD, and Windows).

Hands-on

Interactive shell

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'

Python module

It is straightforward to use Scapy as a regular Python module, for example to check if a TCP port is opened. First, save the following code in a file names send_tcp_syn.py

from scapy.all import *
conf.verb = 0

p = IP(dst="github.com")/TCP()
r = sr1(p)
print(r.summary())

Then, launch the script with:

sudo python send_tcp_syn.py
IP / TCP 192.30.253.113:http > 192.168.46.10:ftp_data SA / Padding

Resources

To begin with Scapy, you should check the notebook hands-on and the interactive tutorial. If you want to learn more, see the quick demo: an interactive session (some examples may be outdated), or play with the HTTP/2 and TLS notebooks.

The documentation contains more advanced use cases, and examples.

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.

Contributing

Want to contribute? Great! Please take a few minutes to read this!