Skip to content

Security research tool editing Excel VBA DPB for macro analysis and password manipulation in authorized penetration tests.

License

Notifications You must be signed in to change notification settings

Cursed271/MacroKey

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Welcome to MacroKey Typing SVG


Version License Python Status


Overview 🎯

MacroKey is a Python-based security tool that modifies Excel VBA project DPB values for password manipulation. It enables authorized penetration testing, ethical macro analysis, and secure reverse engineering. Designed for researchers and red-teamers, it provides streamlined macro manipulation, reporting, and detection testing within controlled environments, ensuring compliance and ethical use.

Key Features

  • 🔑 Password Manipulation: Modifies Excel VBA DPB values for password reset and controlled access.
  • 📊 Macro Analysis: Enables secure inspection and testing of locked VBA projects.
  • ⚙️ Automated Processing: Creates new .xlsm files with adjusted DPB seamlessly.
  • 🛠️ Research Utility: Designed for ethical testing, reverse engineering, and red-team workflows.
  • 🚀 Lightweight & Fast: Minimal dependencies with efficient processing for quick results.

Screenshots 📸

MacroKey Interface:

Installation ⚒️

  1. Pre-requisites: Ensure you have Python3 installed.
  2. Clone the Repo: Use "git clone https://github.com/Cursed271/MacroKey"
  3. Traverse into the Directory: Use "cd MacroKey"
  4. Install Dependencies: Use "pip install -r requirements.txt"
  5. Execute the Script: Use "python3 MacroKey.py"
  6. Enter the Name of the Password Protected .XLSM File when prompted

Legal Disclaimer ⚖️

⚠️ Important Notice

This tool is intended for:

  • Authorized security testing ONLY
  • Educational and research purposes
  • Legal and ethical use cases

You must:

  • Obtain proper authorization before use
  • Comply with all applicable laws
  • Use responsibly and ethically

The author assumes no liability for misuse of this tool.

Contributing 💡

  • Steven Pereira (aka Cursed) - Creator & Maintainer

Contributions welcome! Feel free to:

  • 🐛 Report bugs
  • 💡 Suggest features
  • 🔧 Submit pull requests
  • 📖 Improve documentation

License 📃

MacroKey is licensed under the COE or CursedSec Ownership Edict License.

This software is proprietary intellectual property owned exclusively by CursedSec.

Unauthorized redistribution, modification, and re-uploading to any other repository (public or private) are strictly forbidden and constitute a direct violation of the CursedSec Ownership Edict (COE).

Consider this a warning: I track every copy. Get your own ideas, you lazy little shits.

Violators will face immediate legal action and DMCA takedown requests. All development must be conducted via approved Pull Requests on this official repository.

Let's Connect ⛓️‍💥

Have suggestions or feature requests? Feel free to reach out via:

Your feedback helps improve MacroKey! Contributions and PRs are always welcome. 🚀