README.md

# Ryūjin Protector

**Ryūjin Protector** is an open-source **Bin2Bin** obfuscation, protection, and DRM tool for **Windows PE** binaries targeting the **Intel x64 architecture(Only)**.

<p align="center">
  <img src="imgs/ryujinreadme.png" alt="Ryūjin Protector Banner" width="80%">
</p>

---

## Features

- Junk Code Insertion + Code Mutation (Fully randomic without breaking the original logic)
- IAT Call Access Obfuscation(With obfuscated handlers access)
- Random Section naming(Default name: Ryujin)
- Mathematical Operators Virtualization(aka: Ryūjin MiniVM)
- Obfuscated code Encryption(Using TeaDelKew Algorithm)
- Anti-Debug User + Kernel
- Troll Reversers(Exclusive)
- Anti-Dump
- Anti-Disassembly + Anti-Decompiler
- Memory Protection(CRC32)
- Custom Passes

---

## Demos and Presentations

Ryūjin was designed and developed for the study of obfuscators with Bin2Bin capabilities, making it a viable project for use by third parties as well as serious information security students. This includes: Commercial Developers, Indie Developers/Cheat Developers, Anti-Cheat Developers, Malware Developers, Malware Analysts, and Security Researchers.

**A Simple Comparison on a "main" function. before and after applying Ryūjin:**

![Ryūjin Protector Demo](imgs/demo.png)

This is only a small demo with only one Ryūjin feature, others feature together produce a better result.

**Really Easy to Use:**

**Ryūjin** is extremely easy to use — you can choose between the GUI mode or the CLI mode. Both will produce the same result in a precise, functional, and stable way.

GUI Mode Demonstration:
![Ryūjin Protector Demo GUI](imgs/demo1.png)

CLI Mode Demonstration:
![Ryūjin Protector Demo Console](imgs/demo2.png)

For both options, you will need exclusively a PE file (Apanas, executable, for now) along with a PDB file containing the symbols for that PE file, so that you can protect and generate a new binary. Additionally, you can consult the WIKI at any time to discover other options and possibilities, such as custom passes.

---

## Getting Started

GITHUB_WIKI_URL
feat: Begin writing README.md - Create the Ryujin README.md with current features, planned features, demos, and more. 2025-07-03 20:55:55 -03:00			`# Ryūjin Protector`

			`Ryūjin Protector is an open-source Bin2Bin obfuscation, protection, and DRM tool for Windows PE binaries targeting the Intel x64 architecture(Only).`

feat: Add stub code comments for "AntiDump" feature and enhance README.md - Added the shellcode generation code as comments within the "AntiDump" stub for better context and understanding. - Enhanced README.md with more detailed descriptions and an outline of planned future features. 2025-07-13 20:05:55 -03:00			`<p align="center">`
			`<img src="imgs/ryujinreadme.png" alt="Ryūjin Protector Banner" width="80%">`
			`</p>`
feat: Begin writing README.md - Create the Ryujin README.md with current features, planned features, demos, and more. 2025-07-03 20:55:55 -03:00
			`---`

			`## Features`

feat: Fixing typos on README.md - Fixing some typos on README.md 2025-07-04 09:33:11 -03:00			`- Junk Code Insertion + Code Mutation (Fully randomic without breaking the original logic)`
			`- IAT Call Access Obfuscation(With obfuscated handlers access)`
			`- Random Section naming(Default name: Ryujin)`
			`- Mathematical Operators Virtualization(aka: Ryūjin MiniVM)`
			`- Obfuscated code Encryption(Using TeaDelKew Algorithm)`
feat: Start implementing the base for the "AntiDump" feature - Begin work on the foundational structure for the "AntiDump" feature - Introduced a new capability in Ryujin called "RyujinRunOncePass", which runs only on the first obfuscated function — ideal for volatile features - Updated "RyujinCoreConfiguration" structures - Updated "RyujinGUI" to include the "AntiDump" option - Updated "RyujinConsole" to display the "AntiDump" feature - Updated "README.md" accordingly 2025-07-12 21:26:12 -03:00			`- Anti-Debug User + Kernel`
			`- Troll Reversers(Exclusive)`
feat: Add stub code comments for "AntiDump" feature and enhance README.md - Added the shellcode generation code as comments within the "AntiDump" stub for better context and understanding. - Enhanced README.md with more detailed descriptions and an outline of planned future features. 2025-07-13 20:05:55 -03:00			`- Anti-Dump`
feat: Break Decompilers and Disassemblers feature - Ryujin can now break decompilers and disassemblers using a simple technique. This feature was inspired by a talk from BinjaDev at Off by One Conf. It will definitely be improved in the near future with more techniques. 2025-07-16 21:09:22 -03:00			`- Anti-Disassembly + Anti-Decompiler`
feat: Finalize memory protection logic, add GUI/CLI options, and fix README typos - Added the original source code that generates the memory protection stub as a comment in the stub. - Added a memory protection flag to the CLI and an option to the GUI. - Improved CLI help text to be more detailed and explanatory. - Updated README.md. 2025-07-25 20:30:20 -03:00			`- Memory Protection(CRC32)`
feat: Add custom pass support for Ryujin users via callback - Ryujin users can now register their own callbacks following the standard interface to create custom passes and extend Ryujin’s behavior. - Updated configuration files to support safe usage. - Adjusted README.md. 2025-07-27 09:12:11 -03:00			`- Custom Passes`
feat: Begin writing README.md - Create the Ryujin README.md with current features, planned features, demos, and more. 2025-07-03 20:55:55 -03:00
			`---`

feat: Add stub code comments for "AntiDump" feature and enhance README.md - Added the shellcode generation code as comments within the "AntiDump" stub for better context and understanding. - Enhanced README.md with more detailed descriptions and an outline of planned future features. 2025-07-13 20:05:55 -03:00			`## Demos and Presentations`
feat: Begin writing README.md - Create the Ryujin README.md with current features, planned features, demos, and more. 2025-07-03 20:55:55 -03:00
			`Ryūjin was designed and developed for the study of obfuscators with Bin2Bin capabilities, making it a viable project for use by third parties as well as serious information security students. This includes: Commercial Developers, Indie Developers/Cheat Developers, Anti-Cheat Developers, Malware Developers, Malware Analysts, and Security Researchers.`

feat: Fixing typos on README.md - Fixing some typos on README.md 2025-07-04 09:33:11 -03:00			`A Simple Comparison on a "main" function. before and after applying Ryūjin:`
feat: Begin writing README.md - Create the Ryujin README.md with current features, planned features, demos, and more. 2025-07-03 20:55:55 -03:00
			`![Ryūjin Protector Demo](imgs/demo.png)`

			`This is only a small demo with only one Ryūjin feature, others feature together produce a better result.`

feat: Add stub code comments for "AntiDump" feature and enhance README.md - Added the shellcode generation code as comments within the "AntiDump" stub for better context and understanding. - Enhanced README.md with more detailed descriptions and an outline of planned future features. 2025-07-13 20:05:55 -03:00			`Really Easy to Use:`

			`Ryūjin is extremely easy to use — you can choose between the GUI mode or the CLI mode. Both will produce the same result in a precise, functional, and stable way.`

			`GUI Mode Demonstration:`
			`![Ryūjin Protector Demo GUI](imgs/demo1.png)`

			`CLI Mode Demonstration:`
			`![Ryūjin Protector Demo Console](imgs/demo2.png)`

			`For both options, you will need exclusively a PE file (Apanas, executable, for now) along with a PDB file containing the symbols for that PE file, so that you can protect and generate a new binary. Additionally, you can consult the WIKI at any time to discover other options and possibilities, such as custom passes.`

feat: Begin writing README.md - Create the Ryujin README.md with current features, planned features, demos, and more. 2025-07-03 20:55:55 -03:00			`---`

			`## Getting Started`

			`GITHUB_WIKI_URL`