Skip to main content

Scapy: interactive packet manipulation tool

Project description

<p align="center">
<img src="doc/scapy_logo.png" width=200>

# Scapy

[![Travis Build Status](](
[![AppVeyor Build Status](](
[![Codecov Status](](
[![Codacy Badge](](;utm_medium=referral&amp;utm_content=secdev/scapy&amp;utm_campaign=Badge_Grade)
[![PyPI Version](](
[![Python Versions](](
[![License: GPL v2](](LICENSE)
[![Join the chat at](](

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

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).

## 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
``, then display the reply source IP address:

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

### 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

from scapy.all import *
conf.verb = 0

p = IP(dst="")/TCP()
r = sr1(p)

Then, launch the script with:

sudo python
IP / TCP > SA / Padding

### Resources

To begin with Scapy, you should check [the notebook
hands-on](doc/notebooks/Scapy%20in%2015%20minutes.ipynb) and the [interactive
If you want to learn more, see [the quick demo: an interactive
(some examples may be outdated), or play with the
[HTTP/2](doc/notebooks/HTTP_2_Tuto.ipynb) and [TLS](doc/notebooks/tls)

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

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

git clone
cd 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.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

scapy-2.4.1.tar.gz (3.2 MB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page