scapy

Scapy: the Python-based interactive packet manipulation program & library.

https://github.com/secdev/scapy

Science Score: 36.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
  • Academic publication links
  • Committers with academic emails
    10 of 487 committers (2.1%) from academic institutions
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (16.0%) to scientific vocabulary

Keywords

hacktoberfest network network-analysis network-discovery network-security network-visualization packet-analyser packet-capture packet-crafting packet-sniffer pcap python scapy security security-tools

Keywords from Contributors

fuzzing system fuzz-testing distributed oss-fuzz stability vulnerabilities systemd services closember
Last synced: 6 months ago · JSON representation

Repository

Scapy: the Python-based interactive packet manipulation program & library.

Basic Info
  • Host: GitHub
  • Owner: secdev
  • License: gpl-2.0
  • Language: Python
  • Default Branch: master
  • Homepage: https://scapy.net
  • Size: 84.9 MB
Statistics
  • Stars: 11,664
  • Watchers: 232
  • Forks: 2,138
  • Open Issues: 126
  • Releases: 15
Topics
hacktoberfest network network-analysis network-discovery network-security network-visualization packet-analyser packet-capture packet-crafting packet-sniffer pcap python scapy security security-tools
Created over 10 years ago · Last pushed 6 months ago
Metadata Files
Readme Contributing Funding License

README.md

Scapy   Scapy

Scapy unit tests <!-- ignoreppi --> Codecov Status <!-- ignoreppi --> Codacy Badge <!-- ignoreppi --> PyPI Version License: GPL v2 Join the chat at https://gitter.im/secdev/scapy <!-- ignoreppi -->

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

```python 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:

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

License

Scapy's code, tests and tools are licensed under GPL v2. The documentation (everything unless marked otherwise in doc/, and except the logo) is licensed under CC BY-NC-SA 2.5.

Contributing

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

Owner

  • Name: SecDev
  • Login: secdev
  • Kind: organization

The organization supporting Scapy

Committers

Last synced: 9 months ago

All Time
  • Total Commits: 5,309
  • Total Committers: 487
  • Avg Commits per committer: 10.901
  • Development Distribution Score (DDS): 0.736
Past Year
  • Commits: 191
  • Committers: 36
  • Avg Commits per committer: 5.306
  • Development Distribution Score (DDS): 0.492
Top Committers
Name Email Commits
gpotter2 g****l@p****r 1,402
Phil p****l@s****g 708
pbi n****e@n****e 504
Pierre LALET p****t@c****r 467
Guillaume Valadon g****e@v****t 385
Nils Weiss n****s@w****e 349
Guillaume Valadon g****n@n****m 83
Guillaume Valadon g****n@s****r 76
Evgeny Vereshchagin e****s@y****u 63
Dirk Loss m****l@d****e 58
mtu m****y@s****r 46
Umakant Kulkarni U****i 39
andi a****b@g****m 26
Antonio Vazquez a****z@t****m 24
FlUxIuS f****s@g****m 22
Pierre Lorinquer p****r@s****r 22
Enrico Pozzobon e****n@g****m 21
KeksMassacre x****0@g****m 20
speakinghedge h****e@n****e 20
Michael Farrell m****t@g****m 20
Guillaume Valadon g****n@q****m 18
Robin Jarry r****y@6****m 17
Adam Karpierz a****z@g****m 15
Steven Van Acker s****n@s****e 15
sebastien mainand s****d@s****r 14
Thomas Faivre t****e@6****m 14
Brian Bienvenu b****n@b****u 14
rperez r****z@d****n 13
Matthias St. Pierre m****e@n****m 13
Jan Sebechlebsky s****n@g****m 12
and 457 more...

Issues and Pull Requests

Last synced: 6 months ago

All Time
  • Total issues: 349
  • Total pull requests: 991
  • Average time to close issues: 5 months
  • Average time to close pull requests: about 2 months
  • Total issue authors: 259
  • Total pull request authors: 176
  • Average comments per issue: 2.47
  • Average comments per pull request: 2.34
  • Merged pull requests: 771
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 97
  • Pull requests: 305
  • Average time to close issues: 19 days
  • Average time to close pull requests: 14 days
  • Issue authors: 75
  • Pull request authors: 57
  • Average comments per issue: 1.51
  • Average comments per pull request: 1.63
  • Merged pull requests: 220
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
  • evverx (19)
  • alxroyer-thales (11)
  • gpotter2 (8)
  • guedou (7)
  • douniwan5788 (5)
  • wasmachensachen98 (5)
  • jingfeihu (4)
  • rkinder2023 (4)
  • LRGH (4)
  • bsullivan19 (3)
  • ventaquil (3)
  • sa-isd (3)
  • charles2910 (3)
  • giovanni-bellini-argo (3)
  • Abbath (2)
Pull Request Authors
  • gpotter2 (375)
  • polybassa (90)
  • evverx (86)
  • antoniovazquezblanco (52)
  • guedou (39)
  • satveerbrar (10)
  • p-l- (9)
  • rkinder2023 (8)
  • jingfeihu (7)
  • Shu-xueyuan (6)
  • mspncp (6)
  • holesch (6)
  • cdleonard (6)
  • squizz617 (4)
  • ElKobano (4)
Top Labels
Issue Labels
bug (46) enhancement (7) discussion (6) major (5) tls (5) dependency-related (5) cleanup (4) needs additional info (4) platform-specific (3) tests (2) contributions wanted (1) wontfix (1) Hinty (1) needs rework/cleanup (1) doc (1) invalid (1) on hold (1) PEPin (1)
Pull Request Labels
bug (83) enhancement (81) convergence (20) new layer (19) needs rework/cleanup (17) cleanup (17) platform-specific (15) tls (14) tests (11) dependency-related (11) major (9) needs testing (9) doc (8) needs additional info (7) discussion (5) on hold (4) invalid (2) broken (2) Hinty (2) ci/bsd (2)

Packages

  • Total packages: 4
  • Total downloads:
    • pypi 2,061,626 last-month
  • Total docker downloads: 863,572,095
  • Total dependent packages: 112
    (may contain duplicates)
  • Total dependent repositories: 3,397
    (may contain duplicates)
  • Total versions: 55
  • Total maintainers: 4
  • Total advisories: 1
pypi.org: scapy

Scapy: interactive packet manipulation tool

  • Versions: 29
  • Dependent Packages: 112
  • Dependent Repositories: 3,395
  • Downloads: 2,061,626 Last month
  • Docker Downloads: 863,572,095
Rankings
Docker downloads count: 0.1%
Dependent repos count: 0.2%
Dependent packages count: 0.2%
Average: 0.2%
Downloads: 0.2%
Stargazers count: 0.3%
Forks count: 0.3%
Maintainers (4)
Advisories (1)
Last synced: 6 months ago
proxy.golang.org: github.com/secdev/scapy
  • Versions: 20
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Forks count: 0.5%
Stargazers count: 0.7%
Average: 5.4%
Dependent packages count: 9.6%
Dependent repos count: 10.8%
Last synced: 6 months ago
conda-forge.org: scapy

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

  • Homepage: https://scapy.net
  • License: GPL-2.0-only
  • Latest release: 2.4.5
    published almost 5 years ago
  • Versions: 4
  • Dependent Packages: 0
  • Dependent Repositories: 1
Rankings
Forks count: 2.9%
Stargazers count: 3.2%
Average: 20.4%
Dependent repos count: 24.1%
Dependent packages count: 51.5%
Last synced: 6 months ago
anaconda.org: scapy

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

  • Homepage: https://scapy.net
  • License: GPL-2.0-only
  • Latest release: 2.6.1
    published 9 months ago
  • Versions: 2
  • Dependent Packages: 0
  • Dependent Repositories: 1
Rankings
Forks count: 7.9%
Stargazers count: 8.7%
Average: 27.1%
Dependent packages count: 41.0%
Dependent repos count: 50.6%
Last synced: 6 months ago

Dependencies

.github/workflows/unittests.yml actions
  • actions/checkout v3 composite
  • actions/setup-python v4 composite
  • codecov/codecov-action v2 composite
  • github/codeql-action/analyze v2 composite
  • github/codeql-action/init v2 composite
pyproject.toml pypi
setup.py pypi