Home

Awesome

pwntools logo

Docs latest Travis Twitter MIT License

Unofficial fork for python 3 of pwntools, the CTF framework and exploit development library. It is designed for rapid prototyping and development, and intended to make exploit writing as simple as possible.

The official pwntools project now supports python 3, starting with pwntools 4.0beta0.

Since this repository is not maintained anymore, we recommend to use the official repository.

from pwn import *
context(arch='i386', os='linux')

r = remote('exploitme.example.com', 31337)
# EXPLOIT CODE GOES HERE
r.send(asm(shellcraft.sh()))
r.interactive()

Origin

python3-pwntools is a fork of the pwntools project. I also merged binjitsu into it so you can enjoy all the features of that great fork!

Documentation

Our documentation is available at python3-pwntools.readthedocs.org

To get you started, we've provided some example solutions for past CTF challenges in our write-ups repository.

Installation

python3-pwntools is best supported on 64-bit Ubuntu 12.04 and 14.04, but most functionality should work on any Posix-like distribution (Debian, Arch, FreeBSD, OSX, etc.). Python 3.2 to 3.5 are supported.

Most of the functionality of python3-pwntools is self-contained and Python-only. You should be able to get running quickly with

apt-get update
apt-get install python3 python3-dev python3-pip git
pip3 install --upgrade git+https://github.com/arthaud/python3-pwntools.git

However, some of the features (assembling/disassembling foreign architectures) require non-Python dependencies. For more information, see the complete installation instructions here.

Contribution

See CONTRIBUTING.md

Contact

If you have any questions not worthy of a bug report, feel free to ping at Maxima on Freenode and ask away. Click here to connect.