# TheWover/donut

Generates x86, x64, or AMD64+x86 position-independent shellcode that loads .NET Assemblies, PE files, and other Windows payloads from memory and runs them with parameters

Repository: https://github.com/TheWover/donut
Canonical: https://ross.abutalabs.com/products/thewover-donut
Language: C
License: BSD-3-Clause
License Family: permissive
Last push: 2025-07-08T17:27:50+00:00

## Health v2 (maintenance only)
Score: 36/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 30, release rhythm 8, longevity 100
- inputs: {"age_days": 2716, "days_push": 421, "days_rel": 679, "gap_med": null, "n_releases_24m": 1}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 4689, forks 755 (observed 2026-08-28T04:08:57.034925+00:00)

## What it is
Donut is a shellcode generator that converts VBScript, JScript, EXE, DLL files, and .NET assemblies into x86, x64, or AMD64+x86 position-independent code for in-memory execution on Windows. Payloads can be staged over HTTP or embedded in the loader, with optional Chaskey encryption, compression, and AMSI/WLDP/ETW patching.

## Use cases
- generate shellcode from a .NET assembly for in-memory execution
- convert an EXE or DLL into position-independent code
- run a script payload entirely from memory without touching disk
- encrypt and compress a payload for a red team engagement
- embed a payload directly into a loader stub
- bypass AMSI and WLDP when executing managed payloads

## When to choose
- you need to execute Windows payloads from memory as shellcode
- you are doing authorized penetration testing or red team research
- you need a mature, well-documented PIC generator with encryption and staging options

## When to avoid
- you need a defensive or detection tool rather than an offensive one
- your target platform is not Windows
- you cannot legally use offensive security tooling in your jurisdiction

## Facets
- artifact type: cli-tool
- maturity: stable
- function: security, cryptography, compiler
- domain: security, penetration-testing, windows
- platform: windows, cross-platform, cli
- tags: shellcode, position-independent-code, in-memory-execution, red-team, offensive-security, dotnet, amsi-bypass, payload-generation

## Member repositories
- TheWover/donut (main) score 36

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:08:57.034925+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:19:16.236874+00:00, confidence not recorded.
  - readme: https://github.com/TheWover/donut (fetched 2026-08-28T04:08:57.034925+00:00, sha 733edb3e6ded)
- Data as of 2026-08-30T08:39:29.467469+00:00.