https://github.com/sapphicart/eatshell
Automate the process of extracting, loading and assembling shellcode.
https://github.com/sapphicart/eatshell
python shellcode shellcode-assembler shellcode-extractor
Last synced: 8 months ago
JSON representation
Automate the process of extracting, loading and assembling shellcode.
- Host: GitHub
- URL: https://github.com/sapphicart/eatshell
- Owner: sapphicart
- License: mit
- Created: 2024-11-06T17:11:26.000Z (about 1 year ago)
- Default Branch: master
- Last Pushed: 2024-11-07T16:51:08.000Z (about 1 year ago)
- Last Synced: 2025-04-06T13:04:51.069Z (9 months ago)
- Topics: python, shellcode, shellcode-assembler, shellcode-extractor
- Language: Python
- Homepage:
- Size: 10.7 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
eatshell
Summary •
Requirements •
Installation •
Usage •
License
## Summary
eatshell is a simple command line tool to automate the process of shellcode extraction, loading and assembling. eatshell contains three commands `extract`, `load`, and `assemble`.
>[!NOTE]
**Note: eatshell is meant for small-scale application and primarily created for personal use only.**
## Requirements
- Python 3.xx
## Installation
There are two ways to install `eatshell`:
Install the tool directly with `pip`
```bash
pip install eatshell
```
Or, you can build from source. Download the latest [release](https://github.com/sapphicart/eatshell/releases).
## Usage
Use the `--help` switch to read the `COMMANDS` and `OPTIONS` available.
```bash
$ eatshell --help
Usage: eatshell.py [OPTIONS] COMMAND [ARGS]...
Options:
--hush Suppress Usage and Warning info.
--help Show this message and exit.
Commands:
assemble
extract
load
```
There are three commands available for `eatshell`:
- assemble
- extract
- load
```
$ eatshell assemble --shellcode --file
Use this command to assemble given shellcode
into an ELF file with +rwx permissions for
the owner.
```
```
$ eatshell extract --file --hex
Use this command to extract shellcode
from an existing ELF file.
Turn --hex on for hex encoding.
```
```
$ eatshell load --shellcode
Use this command to run the provided
shellcode interactively.
Use with caution, might not work everytime.
```
>[!WARNING]
Create an `.env` file with the following variables. Otherwise, the program might not work.
`.env` file structure example:
```
OS=linux
ARCH=amd64
LOG_LEVEL=error
```
## License
Distributed under [MIT](LICENSE) License.