Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

18 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🐍 CracksTheCodes

Decompiled Python Code Collection by @AtomixClub

Welcome to CracksTheCodes — a curated archive of reverse-engineered Python applications, scripts, and compiled bytecode. Whether you're a security researcher, malware analyst, or just curious about how Python programs work under the hood, this repository is for you.

⚠️ Disclaimer: This repository is intended for educational and research purposes only. Please respect intellectual property and only decompile code you have permission to analyze.


👨‍💻 About the Creator

AtomixClub is a reverse engineering enthusiast and Python security researcher passionate about understanding how software works at its core. This collection represents countless hours of decompilation, analysis, and documentation.

GitHub Twitter Telegram


🐍 What's Inside?

This repository contains decompiled source code from various Python formats, including:

  • 📦 Compiled Python Bytecode.pyc files from Python 2.7 to 3.11+
  • 🔒 PyInstaller Executables – Decompiled standalone Windows/Linux/macOS apps
  • 🥧 Py2EXE & Py2APP – Recovered source from packaged applications
  • 📱 Python-for-Android – Kivy, BeeWare, and other mobile Python apps
  • 🕸️ Obfuscated Python – Deobfuscated and cleaned source code
  • 🧩 Python Modules – Extracted from various sources and platforms

🛠️ Tools Used

The decompilation process relies on a variety of specialized Python reverse engineering tools:

Tool Purpose
uncompyle6 / decompyle3 Decompile Python bytecode (Python 2.7-3.8)
pycdc (Python Bytecode Decompiler) Modern decompiler supporting Python 3.9+
pyinstxtractor Extract PyInstaller packages
pyi-archive_viewer Explore PyInstaller archives
unpy2exe Decompile py2exe executables
pyREtic Dynamic analysis for obfuscated Python
xdis Cross-version Python bytecode disassembler
🧠 Brain The tool that actually does the work when all the automated ones fail

⚠️ Important Note on Decompilation Results

Not all files can be perfectly restored!

Due to limitations in decompilation tools (uncompyle6, pycdc, etc.) and the nature of Python bytecode:

  • 🔨 Some files decompile to 100% working source code – Clean and executable
  • 🔧 Some files produce partial code – May have missing sections or syntax errors
  • 📋 Some files only yield .dis output – Raw disassembly when decompilation fails
  • Some files are completely unrecoverable – Corrupted, heavily obfuscated, or unsupported Python versions

Files with .dis extension contain Python bytecode disassembly – not source code, but still useful for understanding program flow. Think of it as assembly language for Python.


🔥 Featured Decompilations

📌 Educational Examples

  • Obfuscation Techniques – Before/after comparison of obfuscated vs clean code
  • Pyc Structure – Raw bytecode vs decompiled source side-by-side
  • Failed Decompilations – Examples of .dis files and why decompilation failed

🚀 Getting Started

Want to try decompiling Python yourself? Here's how:

Step 1: Run the tools

# Using uncompyle6
uncompyle6 file.pyc > file_decompiled.py

# Using pycdc (for newer Python versions)
pycdc file.pyc > file_decompiled.py

Step 2: Stare at the screen for 3 hours

# No command for this. Just pure suffering.

Step 3: When decompilation fails, get disassembly

python -m dis file.pyc > file_disassembled.dis

Step 4: Stare at the screen for another 5 hours

# You're now officially a reverse engineer.
# Congratulations? 🎉

Extract and decompile PyInstaller executable:

# Extract the executable
python pyinstxtractor.py your_app.exe

# Decompile the extracted .pyc files
cd your_app_extracted
uncompyle6 struct.pyc > struct.py

# Question all your life choices
echo "Why did I choose this career path?" >> existential_crisis.txt

📚 Learning Resources


🤝 Contributing

Have an interesting Python decompilation to share? Found a better tool or technique? Contributions are welcome!

Please ensure:

  • ✅ You have permission to share the decompiled code
  • ✅ Include original file hash (MD5/SHA256) for reference
  • ✅ Add build/decompilation notes in a separate .txt file
  • ✅ Note whether the file is full source, partial, or .dis only
  • ✅ Include a "how many hours of staring this took" metric (mandatory)
  • ❌ No proprietary or copyrighted commercial software

⚖️ Legal & Ethical Guidelines

This repository exists for:

  • 🔬 Security research and education
  • 🛡️ Malware analysis and defense development
  • 📖 Learning programming concepts through real examples
  • 🔍 Understanding software behavior
  • 😭 Developing a unhealthy relationship with your computer screen

Please use this knowledge responsibly. The maintainer (@AtomixClub) is not responsible for misuse of the provided code, or the existential dread that comes with reading decompiled Python.


📊 Repository Stats

GitHub stars GitHub forks GitHub watchers GitHub license Hours spent staring


⭐ Support the Project

If you find this collection useful:

  • Star this repository on GitHub
  • 🐛 Report issues or suggest improvements
  • 🔗 Share with fellow researchers and enthusiasts
  • Buy me a coffee (I need it after all that staring)

Happy Reversing! 🐍🔓

— AtomixClub

P.S. If you're reading this and wondering why your decompiled code looks like garbage, welcome to the club. Stare harder.

About

Crack The Codes is a repository where the contents are a collection of codes that we have successfully cracked.

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages