Free open-source obfuscator that targetting Mono, and maybe whole .NET

## BitMono [![Build status][image_appveyor_main]][appveyor_main_build] [![Test status][image_test]][test] [![Codefactor][image_codefactor]][codefactor] [![DeepSource][image_deepsource]][deepsource] [![Gitter Chat][image_gitter]][gitter] [![MIT License][image_license]][license] [![BitMono Discord][image_bitmono_discord]][bitmono_discord] BitMono is a free open-source C# obfuscator that in most cases works **only** with Mono - well known as a fork of .NET framework (which runs popular platforms such as Unity, etc), you can still use this for a whole .NET, but be careful that something working not as intentional, because the main target of the this project is Mono (actually some protections don't work with Mono but work with .NET Core). Which uses **[AsmResolver][asmresolver]** for assembly manipulation (not a dnlib as you might already think). If you have any questions/issues please let me know **[there][bitmono_issues]**. You can install the latest version of BitMono **[here][bitmono_releases]**.

Before and after obfuscation preview by BitMono

Before and after obfuscation preview by BitMono 2

CLI

Configuration

## 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. :D ## Documentation Read the **[docs][bitmono_docs]** to read protection, functionality, 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][unmanagedstring_source]** (based on existing protection) * **[BitDotNet][bitdotnet_source]** (based and improved on existing protection) * **[BitMethodDotnet][bitmethoddotnet_source]** (based and improved on existing protection) * **[DotNetHook][dotnethook_source]** (based on existing protection) * CallToCalli * ObjectReturnType * NoNamespaces * FullRenamer * AntiDebugBreakpoints * AntiDecompiler * BitDateTimeStamp * BitMono * BillionNops ## Usage ### Using CLI `BitMono.CLI /drag-and-drop` Always drop dependencies in `libs` directory in the same path where `file` for obfuscation is located Your obfuscation directory structure will look something like this: ``` specially_created_folder_for_obfuscation/ ├─ your_app.exe └─ libs/ ├─ ImportantLibrary.dll ├─ SuperImportantLibrary.dll └─ ... ``` Copy all libraries (.dll) from the building application folder and paste them into the `libs` directory (if it doesn't exist yet create it), or even create the libs directory yourself with a custom name for example - `myLibs`, and then specify it in BitMono, however, if you will use `libs` then by default BitMono looking for a `libs` directory, so it will save your time. ### Using CLI Commands ```console -f, --file Required. Set file path. -l, --libraries Set libraries path. -o, --output Set output path. --help Display this help screen. --version Display version information. ``` Basic example ```console $ BitMono.CLI -f C:\specially_created_folder_for_obfuscation/your_app.exe -l specially_created_folder_for_obfuscation/libs ``` In case when you already have a directory with the name `libs` (specially_created_folder_for_obfuscation\libs) BitMono will catch it automatically, so, you don't need to specify it anymore, but you can in case if you made another directory with `libs` somewhere on the disk or even just for "visibility". ```console $ BitMono.CLI -f C:\specially_created_folder_for_obfuscation/your_app.exe ``` Specify custom `libs` directory ```console $ BitMono.CLI -f C:\specially_created_folder_for_obfuscation/your_app.exe -l C:\mythings\obfuscation\superLibsDirectory ``` Specify file, libs and output. If output directory doesn't exist BitMono will create it automatically and even open it on the top of the screen, if you want you can disable opening of the directory on the of top of the screen in `obfuscation.json` - and set `OpenFileDestinationInFileExplorer` to false. ```console $ BitMono.CLI -f C:\specially_created_folder_for_obfuscation/your_app.exe -l C:\mythings\obfuscation\superLibsDirectory -o C:\specially_created_folder_for_obfuscation/output ``` Want more? Simply read the **[docs][bitmono_docs]**. ### Detailed build status If you want to build the BitMono by your own - [click here for detailed info][build_info] | Branch | AppVeyor | |--------|-------------------------------------------------------------| | main | [![Build status][image_appveyor_main]][appveyor_main_build] | | dev | [![Build status][image_appveyor_dev]][appveyor_dev_build] | ### Supported Frameworks Mono is supported obviously (some protections don't support Mono), however if you use BitMono for .NET (Core) or higher versions be careful because some protections won't work - you will be notified about that by BitMono when using not supported protections for yours running target framework. | Framework | Version | |----------------|---------| | .NET (Core) | 6.0 | | .NET Framework | 462 | | netstandard | 2.0 | | netstandard | 2.1 | Credits ------- **[0x59R11][author_0x59r11]** for his acquaintance in big part of **[BitDotNet][bitdotnet_source]** that breaks files for mono executables! **[Gazzi][author_gazzi]** for his help that [me][author_sunnamed434] asked a lot! **[Elliesaur][author_ellisaur]** for her acquaintance in **[DotNetHook][dotnethook_source]** that hooks methods. **[Weka][author_naweka]** for his advices, help and motivation. **[MrakDev][author_mrakdev]** for the acquaintance in **[UnmanagedString][unmanagedstring_source]**. **[ConfuserEx and their Forks][confuserex_source]** 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][openmod_source]** Definitely, openmod inspired this project a lot with services and clean code, extensive similar things to openmod. **[Kao and his blogs][author_kao_blog]** thanks a lot of these blogs. **[drakonia][author_drakonia]** for her **[costura decompressor][simple_costura_decompressor_source]**. [test]: https://ci.appveyor.com/project/sunnamed434/bitmono/branch/main/tests [codefactor]: https://www.codefactor.io/repository/github/sunnamed434/bitmono/overview/main [deepsource]: https://deepsource.io/gh/sunnamed434/BitMono/?ref=repository-badge [gitter]: https://gitter.im/BitMonoSpeech/community?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge [license]: https://github.com/sunnamed434/BitMono/blob/main/LICENSE [previews]: https://github.com/sunnamed434/BitMono/blob/main/PREVIEWS.md [asmresolver]: https://github.com/Washi1337/AsmResolver [bitmono_issues]: https://github.com/sunnamed434/BitMono/issues [bitmono_releases]: https://github.com/sunnamed434/BitMono/releases [bitmono_docs]: https://bitmono.readthedocs.io/en/latest/ [bitdotnet_source]: https://github.com/0x59R11/BitDotNet [bitmethoddotnet_source]: https://github.com/sunnamed434/BitMethodDotnet [dotnethook_source]: https://github.com/Elliesaur/DotNetHook [openmod_source]: https://github.com/openmod/openmod [confuserex_source]: https://github.com/yck1509/ConfuserEx [simple_costura_decompressor_source]: https://github.com/dr4k0nia/Simple-Costura-Decompressor [unmanagedstring_source]: https://github.com/MrakDev/UnmanagedString [author_0x59r11]: https://github.com/0x59R11 [author_gazzi]: https://github.com/GazziFX [author_ellisaur]: https://github.com/Elliesaur [author_naweka]: https://github.com/naweka [author_mrakdev]: https://github.com/MrakDev [author_kao_blog]: https://lifeinhex.com/ [author_drakonia]: https://github.com/dr4k0nia [author_sunnamed434]: https://github.com/sunnamed434 [appveyor_main_build]: https://ci.appveyor.com/project/sunnamed434/bitmono/branch/main [appveyor_dev_build]: https://ci.appveyor.com/project/sunnamed434/bitmono/branch/dev [bitmono_discord]: https://discord.gg/sFDHd47St4 [build_info]: https://github.com/sunnamed434/BitMono/blob/main/build.md [image_build]: https://ci.appveyor.com/api/projects/status/8jh35hfno6riq25j?svg=true&style=plastic [image_test]: https://camo.githubusercontent.com/b78993dda98a6af1d948156d4a8a8ee351a0fa74376a877d88c3ee045ec1a8d9/68747470733a2f2f696d672e736869656c64732e696f2f6170707665796f722f74657374732f73756e6e616d65643433342f6269746d6f6e6f2f6d61696e [image_codefactor]: https://camo.githubusercontent.com/ee2901dd6883cfd8c4e16c60aae9c7f853b74238f32b3f29ff94097b14e515f1/68747470733a2f2f7777772e636f6465666163746f722e696f2f7265706f7369746f72792f6769746875622f73756e6e616d65643433342f6269746d6f6e6f2f62616467652f6d61696e [image_deepsource]: https://camo.githubusercontent.com/1dffa386a3fb7ef749325e904b85448da593ecc2656649811f5eaad3bb45f417/68747470733a2f2f64656570736f757263652e696f2f67682f73756e6e616d65643433342f4269744d6f6e6f2e7376672f3f6c6162656c3d6163746976652b6973737565732673686f775f7472656e643d7472756526746f6b656e3d5f464a663235596274437050795837535276655843614764 [image_gitter]: https://camo.githubusercontent.com/a4c9f6c61fb0be46766c20f8bbcbfd6e8cf49102683afbce4c8a41c27791d0fe/68747470733a2f2f6261646765732e6769747465722e696d2f4269744d6f6e6f5370656563682f636f6d6d756e6974792e7376673f7374796c653d706c6173746963 [image_license]: https://camo.githubusercontent.com/56e4cafd42547e8b7e61f2e192bf8e9ea9e787dc8026219d64dbeb7a7b908d9d/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f73756e6e616d65643433342f6269746d6f6e6f [image_appveyor_main]: https://camo.githubusercontent.com/010bf91f63b78e7602a889e13809b17436fce3cbe0b3343119ed4b5a0816cff9/68747470733a2f2f63692e6170707665796f722e636f6d2f6170692f70726f6a656374732f7374617475732f386a68333568666e6f3672697132356a2f6272616e63682f6d61696e3f7376673d74727565 [image_appveyor_dev]: https://camo.githubusercontent.com/1565f6bfe401e7c37518825168ee526d72457bc454c90b40a5f72d789adc88fd/68747470733a2f2f63692e6170707665796f722e636f6d2f6170692f70726f6a656374732f7374617475732f6239726d336c376b647572796a67636a2f6272616e63682f6465763f7376673d74727565 [image_bitmono_discord]: https://camo.githubusercontent.com/7e6bc5ec9644d150e8541983fc1ee09be7f1301241e46c04186160282ad61be5/68747470733a2f2f696d672e736869656c64732e696f2f646973636f72642f313038363234303136333332313130363532333f6c6162656c3d646973636f7264266c6f676f3d646973636f7264