# Packages
# README
GRBG (Garbage)
GRBG is a Go-based fuzzer designed for CTFs (Capture The Flag competitions). It is a lightweight tool with no external dependencies, making it easy to use and deploy.
Active Development
Currently, GRBG has one exploiter implemented, which is the format string exploiter. This exploiter allows you to perform format string attacks during CTFs. We are actively working on adding more exploiters to enhance the capabilities of GRBG.
Features
- No Dependencies: GRBG does not rely on any external libraries or packages, ensuring a seamless setup process.
- Exploiter Interface: The fuzzer can be easily expanded and customized using the exploiter interface, allowing you to tailor it to your specific needs.
Installation
To install GRBG, follow these steps:
-
Clone the GRBG repository:
git clone https://github.com/your-username/GRBG.git
-
Build the project:
cd GRBG go build
-
Run GRBG:
./GRBG -success=<success_flag> -fail=<fail_flag> -bin=<relative_path_to_executable>
Usage
To use GRBG, simply execute the binary and provide the necessary input flags. For example:
- success flag:
./GRBG -success <success_flag>
- fail flag:
./GRBG -fail <fail_flag>
- binary flag:
./GRBG -bin <relative_path_to_executable>
Contributions
Contributions to GRBG are welcome! If you would like to contribute, please follow these steps:
-
Fork the GRBG repository on GitHub.
-
Clone your forked repository to your local machine:
git clone https://github.com/your-username/GRBG.git
-
Create a new branch for your contribution:
git checkout -b my-contribution
-
Make your changes and commit them:
git commit -m "Add my contribution"
-
Push your changes to your forked repository:
git push origin my-contribution
-
Open a pull request on the original GRBG repository to submit your contribution.