BitMono.API 0.41.1

<p align="center"> <img src="https://raw.githubusercontent.com/sunnamed434/BitMono/main/resources/logo/BitMonoLogo.png" alt="BitMono logo" width="180" /><br> Free open-source obfuscator that targeting Mono and whole .NET<br> </p>

BitMono

👁 MIT License
👁 Nuget feed
👁 BitMono Discord

BitMono is a free, open-source C# obfuscator that was initially designed and intended mainly for Mono, however, now you're feel free to use it for any .NET app, but, be careful some protections work on .NET Framework, some on .NET, some on Mono, some on Unity Engine only.

BitMono uses AsmResolver instead of dnlib (which we used in the past) for handling assemblies. If you have questions or issues, please let us know here. Download the latest version of BitMono here.

You can also use BitMono as an engine to build custom obfuscators. It is built using dependency injection (DI) with a lightweight custom container based on MinIoC (we used Autofac in the past) and follows the latest C# best practices.

<p align="center"> <img src="https://raw.githubusercontent.com/sunnamed434/BitMono/main/resources/images/preview/before-after.png" alt="Before and after obfuscation preview by BitMono"> </p>

<p align="center"> <img src="https://raw.githubusercontent.com/sunnamed434/BitMono/main/resources/images/preview/before-after-2.png" alt="Before and after obfuscation preview by BitMono 2"> </p>

<p align="center"> <img src="https://raw.githubusercontent.com/sunnamed434/BitMono/main/resources/images/preview/CLI.png" alt="CLI"> </p>

<p align="center"> <img src="https://raw.githubusercontent.com/sunnamed434/BitMono/main/resources/images/preview/configuration.png" alt="Configuration"> </p>

Usability

BitMono breaks the most popular tools using just one packer, such as:

• dnSpy;
• dnlib;
• AsmResolver;
• MonoCecil;
• ILSpy;
• PEBear;
• DetectItEasy;
• CFF Explorer
• Perhaps, some dumpers?
• and many, many more...

So, if you will add more protection to the file, I think it would seem like total magic. 😄

Documentation

The docs cover every protection, configuration option, and more.

How your app will look since BitMono obfuscation - just in a few words

• Looks like C++ application but is an actual C# application;
• Crash of decompilers when analyzing types;
• Broken decompilers;
• Broken IL Code;
• Invisible types;
• No code

Features

• StringsEncryption
• UnmanagedString (based on existing protection)
• BitDotNet (based and improved on existing protection)
• BitMethodDotnet (based and improved on existing protection)
• DotNetHook (based on existing protection)
• CallToCalli
• ObjectReturnType
• NoNamespaces
• FullRenamer
• AntiDebugBreakpoints
• AntiDecompiler
• BitDecompiler (fixed version of BitDotNet for newer Unity Versions)
• BitTimeDateStamp
• BitMono
• BillionNops
• AntiDe4dot
• AntiILdasm
• and you can integrate existing/make own feature 😉
• Plugins - drop your own protections in a plugins folder, no rebuild required (guide)

Getting Started

Full usage and installation guides live in the docs.

Quick Start:

1. Download from releases
2. Run BitMono.CLI and follow the prompts
3. (optional) See the How To Use guide for detailed instructions

Installation Options:

CLI & Global Tool:

• GitHub Releases: Download pre-built executables
• .NET Global Tool: dotnet tool install --global BitMono.GlobalTool

Unity Integration:

• Unity 2018-2019 (Legacy): Download .unitypackage from Releases
  • In Unity: Assets → Import Package → Custom Package
• Unity 2020+ (Recommended): Download .tgz UPM package from Releases
  • In Unity: Window → Package Manager → + → Add package from tarball
• Git URL (Best for Development): https://github.com/sunnamed434/BitMono.git#vX.Y.Z
  • In Unity: Window → Package Manager → + → Add package from git URL

MSBuild Integration (NuGet): Obfuscate automatically on every Release build by adding one package reference to your .csproj — no separate tool run:

• dotnet add package BitMono.Integration (then set <PrivateAssets>all</PrivateAssets> on the reference) and build in Release.
• Configure with the usual protections.json / criticals.json / obfuscation.json next to your .csproj.
• See the MSBuild integration guide.

NuGet Package Users: If you encounter dependency resolution issues when using BitMono as a NuGet package, see the NuGet configuration guide in the documentation.

For detailed installation and usage instructions, see the documentation.

Troubleshooting

Having issues? See the troubleshooting guide in the documentation.

Building

If you want to build BitMono yourself - see the building guide in the documentation.

Supported Frameworks

Feel free to use BitMono on frameworks which described below. Be careful using some protections because some might work on .NET Framework only, some on .NET (Core) only, some on all frameworks, some on Mono only - if the protection is unique to its platform/framework you will get a notification about that.

Credits

JetBrains has kindly provided licenses for their JetBrains Rider IDE to the contributors of BitMono. This top-tier tool greatly facilitates and enhances the process of software development.

0x59R11 for his acquaintance in big part of BitDotNet that breaks files for mono executables!

Gazzi for his help that me asked a lot!

Elliesaur for her acquaintance in DotNetHook that hooks methods.

Weka for his advices, help and motivation.

MrakDev for the acquaintance in UnmanagedString.

ConfuserEx and their Forks for most things that I watched for the architecture of BitMono and the obfuscator engine as an application and solving plenty of User solutions which I would be knew in the very long future after much fail usage of BitMono and reports by other Users. Day-by-day I'm looking for something interesting there to improve myself in knowledge and BitMono also.

OpenMod Definitely, openmod inspired this project a lot with services and clean code, extensive similar things to openmod.

Kao and his blogs thanks a lot of these blogs.

drakonia for her costura decompressor.