YSoNet documentation
Browse the documentation site for search, module pages, and light or dark themes. These Markdown files remain the source.
YSoNet builds on ysoserial.net, created by Alvaro Munoz (@pwntester), and the work of its contributors. See Credits for the project history and acknowledgements.
Start with your task
Section titled “Start with your task”| I want to... | Read |
|---|---|
| Download YSoNet and open the wizard | Getting Started |
| Find a module, read help, or save a payload | Quick reference |
| Switch from ysoserial.net | Migration guide |
| Inspect observed runtime results | Release runtime evidence |
| Verify a download and its source | Release verification |
| See why I should update | Upgrade notes |
| Work from Linux, macOS, or WSL | Windows VM and WSL workflow |
| Build or run contributor tests | Building and testing |
| Clone the source without the research archive | Lightweight checkout |
| Search research sources or use them with AI | Research with the archive |
Detailed reference
Section titled “Detailed reference”- Usage and examples: all CLI options and detailed examples.
- JSON catalog: versioned discovery data and its schema for integrations.
- Gadgets and plugins: the full catalog and plugin options.
- Minification savings: measured output sizes.
- PowerShell completion: complete flags and module names.
Catalog and evidence
Section titled “Catalog and evidence”Use the website catalog to compare modules and filter by formatter. Its facts come from the public CLI and describe declarations. Runtime evidence explains observed results and limitations; a catalog entry is not proof that a chain works in your target environment.
Releases
Section titled “Releases”- Release notes: changes and upgrade advice by version.
- Release verification: checksums, source and attestations.
Development
Section titled “Development”- Building and testing: toolchain, build commands and test tiers.
- Contributing: review and contribution workflow.
- Source without the archive: smaller checkouts.
- Dependency security notes: deliberately pinned research libraries.
- Architecture: code map for contributors.
Research and project background
Section titled “Research and project background”- Security guidance: why gadget blocklists are not a fix.
- About the logo: the objects, portals, and deserialization behavior.
- References and .NET deserialization research: reading lists.
- Research with the archive: search English Markdown/PDF copies, use them with AI, and check source coverage and citations.
- Credits, sponsors, and contributing.
The running binary is the source of truth for its catalog. Use -g NAME -h or
-p NAME -h for focused help, --list for names, and --fullhelp for the
exhaustive reference. A page may describe a newer version than your installed copy.