PyMemoryEditor

Une bibliothèque 100 % Python (basée sur ctypes) qui vous permet d'inspecter, modifier et rechercher dans la mémoire de n'importe quel processus en cours d'exécution en quelques lignes de Python — les flux de travail de Cheat Engine sur Windows, Linux et macOS !

Lisez, écrivez et analysez la mémoire de n'importe quel processus — directement depuis Python.
Une API unifiée. Trois systèmes d'exploitation. Pas de compilateur C. Aucune étape de compilation native.

Fonctionne sur 🪟 Windows · 🐧 Linux · 🍎 macOS — 32 bits et 64 bits.

Modifiez une valeur dans un jeu en cours d'exécution · inspectez l'état d'un programme en direct · récoltez des données directement depuis la RAM.

Installation

pip install PyMemoryEditor

Pour installer également l'application GUI fournie (un scanner de type Cheat Engine), utilisez l'extra app :

pip install "PyMemoryEditor[app]"
pymemoryeditor

Pour des analyses plus rapides sur les grands processus, ajoutez l'extra speed. Il installe NumPy et vectorise automatiquement la boucle de comparaison des analyses numériques — environ 10 à 30 fois plus rapide pour les analyses sélectives :

pip install "PyMemoryEditor[speed]"

📖 Guide complet sur Read the Docs.

Voyez-le en action

from PyMemoryEditor import OpenProcess

with OpenProcess(name="game.exe") as process:

    # Scan the whole process for every address holding the value 100.
    for address in process.search_by_value(int, value=100):
        print(f"Found at 0x{address:X}")

    # Read the current value, then write a new one back.
    current = process.read_int(address)
    process.write_int(address, current + 500)

Et voilà — lisez, écrivez ou analysez un autre processus en trois lignes, de la même manière sur toutes les plateformes.

Contenu

🐍 La bibliothèque Python

Contrôle total sur la mémoire d'un autre processus — en quelques lignes de Python :

• ✅ Lire et écrire des valeurs (int, float, bool, str, bytes)
• 🔍 Analyse de valeurs avec huit modes de comparaison
• 🎯 Analyse de motifs (AOB de type IDA et regex)
• 🔗 Chaînes de pointeurs + un handle RemotePointer en direct
• 🧭 Analyse de pointeurs — trouvez les pointeurs statiques qui survivent à l'ASLR
• 🗺️ Carte mémoire, modules, threads
• 🧱 Allouer et libérer de la mémoire distante (Windows / macOS)

🖥️ L'application GUI fournie

Toute la puissance de la bibliothèque — sans écrire de code :

• ⚡ Aucune configuration — attachez-vous à un processus et commencez l'analyse en quelques secondes
• 🧲 Affinez votre approche — Première analyse → Analyse suivante avec retour visuel en direct
• 📋 Table de triche — geler / écrire des valeurs à la volée, import/export JSON
• 🔬 Visionneuse hexadécimale — parcourez la mémoire brute et écrivez-y directement en ligne
• 🧩 Interface d'analyse de pointeurs — analysez, exportez et réanalysez entre les sessions en quelques clics
• 🎨 Accès en un clic — toutes les fonctionnalités à portée de main, sans aucun code

📖 Documentation

La documentation complète se trouve sur pymemoryeditor.readthedocs.io — installation, flux de travail de Cheat Engine, chaque méthode et paramètre, guide de l'application GUI, notes sur les plateformes et dépannage.

Un aperçu rapide pour vous orienter :

Que puis-je construire avec cela ?

• 🎮 Outils de modding de jeux et de speedrun — le cas d'utilisation classique de Cheat Engine.
• 🔬 Débogage et introspection — inspectez l'état en direct sans attacher de débogueur.
• 📊 Outils d'observabilité — échantillonnez des variables dans un processus en cours d'exécution pour la télémétrie.
• 🔐 Recherche en sécurité et rétro-ingénierie — sur des systèmes qui vous appartiennent ou que vous êtes autorisé à tester.
• 🎓 Apprentissage — l'application fournie est un excellent outil pédagogique pour comprendre comment fonctionne l'analyse de mémoire.

[!NOTE] Utilisation responsable. PyMemoryEditor communique avec d'autres processus via les API de niveau système. Ne l'utilisez que sur des processus qui vous appartiennent ou que vous avez l'autorisation explicite d'inspecter.

🤝 Contribuer

Les pull requests, les rapports de bogues et les idées de fonctionnalités sont les bienvenus. Lisez CONTRIBUTING.md pour connaître la configuration de développement, l'organisation des tests et le petit ensemble de particularités spécifiques aux plateformes dont il faut être conscient.

Si PyMemoryEditor a aidé votre projet, merci de mettre une ⭐ sur le dépôt — c'est le moyen le plus simple de soutenir le travail et d'aider les autres à découvrir la bibliothèque.

Licence

Publié sous la licence MIT — libre pour une utilisation personnelle et commerciale.