Scapy: the Python-based interactive packet manipulation program & library. Supports Python 2 & Python 3.
Go to file
Guillaume Valadon f07cdad31a Merge pull request #789 from p-l-/fix-module-import
Fix layers import
2017-09-01 14:23:25 +02:00
.appveyor Add Npcap installer 2017-05-31 21:08:59 +02:00
.travis Six import error in mock 2017-07-31 14:49:41 +02:00
bin Change line ending of unix to dos files 2017-05-31 17:05:39 +02:00
dev/scripts Auto-Fix: refactor print() function 2017-06-28 15:55:40 +02:00
doc Add JCSA17 TLS notebooks 2017-08-22 11:37:07 +02:00
scapy Merge pull request #789 from p-l-/fix-module-import 2017-09-01 14:23:25 +02:00
test New sys.stdout contextmanager + dadict tests 2017-09-01 01:25:47 +02:00
.appveyor.yml [coverage] Several tests + coverage stability (#637) 2017-06-22 10:19:02 +02:00
.codecov.yml Add a codecov configuration file 2017-01-02 18:21:29 +01:00
.coveragerc [Python 2 to 3] Main six fixes (#630) 2017-06-27 18:31:14 +02:00
.gitattributes Add .gitattributes encoding 2017-05-31 17:04:19 +02:00
.gitignore Modified windows links/doc 2017-01-15 02:46:09 +01:00
.travis.yml Exclude directories from coverage reports 2017-04-12 13:16:50 +02:00
CONTRIBUTING.md Contributing notes 2017-06-29 16:03:44 +02:00
LICENSE Add license file 2015-05-13 18:31:50 -07:00
MANIFEST.in enhance version management 2016-09-05 13:38:41 +02:00
README enhance version management 2016-09-05 13:38:41 +02:00
README.md Update README.md 2017-08-02 10:53:41 +02:00
run_scapy run_scapy: allow arguments 2017-06-26 12:33:45 +02:00
run_scapy.bat run_scapy: allow arguments 2017-06-26 12:33:45 +02:00
setup.cfg enhance version management 2016-09-05 13:38:41 +02:00
setup.py Remove longs and fix octals 2017-04-25 20:29:20 +02:00

README.md

Scapy

Travis Build Status AppVeyor Build Status Codecov Status 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, 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.

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.

To benefit from all Scapy features, you might want to install Python modules, such as matplotlib or cryptography.

See the tutorial and follow the instructions to install scapy.

Tutorial

To begin with scapy, see the interactive tutorial and the quick demo: an interactive session (some examples may be outdated).

Contributing

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

License

Scapy is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, version 2.

Scapy is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with Scapy. If not, see the gnu.org web site.