Pythonic aircrack-ng bindings
Python aircrack-ng bindings
PyrCrack is a Python API exposing a common aircrack-ng API. As AircrackNg will run in background processes, and produce parseable output both in files and stdout, the most pythonical approach are context managers, cleaning up after
This library exports a basic aircrack-ng API aiming to keep always a small readable codebase.
This has led to a simple library that executes each of the aircrack-ng's suite commands and auto-detects its usage instructions. Based on that, it dinamically builds classes inheriting that usage as docstring and a run() method that accepts keyword parameters and arguments, and checks them BEFORE trying to run them.
Some classes expose themselves as async iterators, as airodump-ng's wich returns access points with its associated clients.
The documentation is made with Material for MkDocs and is hosted by GitHub Pages.
Be sure to check the python notebook example
You can have also have a look at the examples/ folder for some usage examples, such as the basic "scan for targets", that will list available interfaces, let you choose one, put it in monitor mode, and scan for targets updating results each 2 seconds.
import asyncio import pyrcrack from rich.console import Console from rich.prompt import Prompt async def scan_for_targets(): """Scan for targets, return json.""" console = Console() console.clear() console.show_cursor(False) airmon = pyrcrack.AirmonNg() interface = Prompt.ask( 'Select an interface', choices=[a['interface'] for a in await airmon.interfaces]) async with airmon(interface) as mon: async with pyrcrack.AirodumpNg() as pdump: async for result in pdump(mon.monitor_interface): console.clear() console.print(result.table) await asyncio.sleep(2) asyncio.run(scan_for_targets())
This snippet of code will produce the following results:
Pyrcrack is distributed under the terms of the GPL2+ license.
- Fixed small typing issue
- Fixed CI badge on readme
- Reorganized workflows
- I was re-checking out the repo
- Changed action for softprops/action-gh-release
- Added missing commitizen dep
- Added CI autorelease
- Upgrading workflows
- Migrating to hatch
- :sparkles: Check correct aircrack version and root (#41)
- :sparkles: #29 Improved airmon-ng interface
- :sparkles: #37 Improved aireplay-ng usability (#38)
- Added debug mode. Don't delete tempfiles
- closes: #11 Added pypi to github flow
- :bug: #29 Don't break on exit in most cases
- Added run-as-root message
- Fixed airmon test
- [#10] Using codecov badge
- [#10] Migrating to codecov
Release history Release notifications | RSS feed
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.