2023.08.20 Release Rebuild 1.0.0

Full Changelog: https://github.com/dovezp/x64dbg.plugin.codex/commits/1.0.0

Release Notes

• Verified plugin was still usable on x64dbg
• Adjusted versioning tag

Requirements

To harness the power of Codex, ensure you have the following components:

• Windows Operating System
  • Visual Studio 2015
  • Visual C++ Redistributable for Visual Studio 2015
  • Microsoft .NET Framework 4
• x64dbgpy Plugin
  • Python 2.7 (PyQt4, PyQt5, and PySide)

Getting Started

0. Install x64dbgpy and ensure PyQt4, PyQt5, and PySide are located within "...\plugins\x64dbgpy\".
1. Clone the Codex repository to your local machine using your preferred method, such as Git CLI or a GUI client.
2. Navigate to the cloned repository folder and locate the "x64dbg.plugin.codex.sln" solution file. Double-click it to open it in Visual Studio 2015.
3. Once the solution is open, you might need to configure the build settings to match your environment:
   1. Select your desired build mode (e.g., Debug or Release).
   2. Choose the targeted platform (x86 or x64) based on your system architecture.
4. Build the solution by clicking the "Build" menu at the top and selecting "Build Solution" or by pressing Ctrl + Shift + B. Visual Studio will compile the project and generate the necessary binaries.
5. After the build process completes successfully, navigate to the "build" folder within the repository directory. You should find the built binaries and any associated files generated during the build.
6. Copy the built binaries to your x64dbg plugin directory.
7. Create a directory called codex.
8. Create a settings.json file in your x64dbg plugin codex directory.
9. Edit the settings in "...\plugins\codex\settings.json" to customize menu items and organize scripts. Follow the example template below for reference.

Simplified Context Menus

Codex brings simplicity to your workflow by providing context menus accessible both on the general menu bar and the disassembly window. This enables you to seamlessly manage and execute your Python-based scripts right where you need them.

Menu Bar Context

Easily access and execute your favorite scripts through the menu bar. Codex integrates directly into the menu structure, offering a straightforward way to enhance your debugging capabilities.

Disassembly Window Context

When deep-diving into disassembly, Codex ensures your scripts are just a click away. The disassembly window context menu gives you quick access to script execution, reducing the time spent switching between tools.

Now you can work more efficiently and focus on what matters most: solving intricate debugging challenges.

Configuration and Usage

• Edit the settings in "...\plugins\codex\settings.json" to customize menu items and organize scripts.
• You can create nested folders, making organization a breeze.
• Simplify script names for a clearer understanding of their purpose.
• Each script can import and use additional files, enhancing versatility.

Example

To get an idea of how to apply Codex to best fit your needs, check out my featured demo script's settings.json structure:

{
    "settings": {
        "scripts": {
            "menu": [
                {"folder": "Oreans", "name": "OEP Finder (Universal)", "file": "oreans_oep_finder_uni.py"}
            ],
            "disassembly": [
                {"folder": "Deobfuscate", "name": "PUSH/POP -> MOV", "file": "push_pop.py"}
            ]
        }
    }
}