PyMemoryEditor v2.2.0
Une bibliothèque pure Python qui permet d'inspecter, de modifier et de rechercher la mémoire de n'importe quel processus en cours d'exécution en quelques lignes de Python :snake: .
PyMemoryEditor
Une bibliothèque pure-Python (basée sur ctypes) qui vous permet d'inspecter, modifier et rechercher la mémoire de n'importe quel processus en cours d'exécution en quelques lignes de Python — les workflows 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 · extrayez des données directement de 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 inclut 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:
# Analysez tout le processus pour trouver chaque adresse contenant la valeur 100.
for address in process.search_by_value(int, value=100):
print(f"Trouvé à 0x{address:X}")
# Lisez la valeur actuelle, puis écrivez-en une nouvelle.
current = process.read_int(address)
process.write_int(address, current + 500)
C'est tout — lisez, écrivez ou analysez un autre processus en trois lignes, de la même manière sur chaque plateforme.
📖 Documentation
La documentation complète se trouve sur pymemoryeditor.readthedocs.io — installation, workflow Cheat Engine, chaque méthode et paramètre, guide de l'application GUI, notes sur les plateformes et dépannage.
Une carte rapide pour vous orienter :
| Démarrage rapide | Ouvrez un processus, lisez, écrivez et lancez votre première analyse. |
| Recherche en mémoire | Analyses de valeurs, plages, affinage des résultats, boucle Cheat Engine. |
| Analyse de motifs | Trouvez du code/données avec des signatures d'octets (AOB) et des regex. |
| Pointeurs | Chaînes de pointeurs multi-niveaux et le RemotePointer en direct. |
| Analyse de pointeurs | Trouvez des pointeurs statiques qui survivent à l'ASLR. |
| L'application GUI | Le scanner de type Cheat Engine fourni. |
| Référence API | Chaque classe, méthode et paramètre public. |
| Notes sur les plateformes | Permissions et particularités sur Windows, Linux et macOS. |
| Dépannage | Erreurs courantes et comment les résoudre. |
Que puis-je construire avec cela ?
- 🎮 Outils de modding de jeux et de speedrun — le cas d'usage 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 que vous possédez ou que vous êtes autorisé à tester.
- 🎓 Apprentissage — l'application fournie est un excellent outil pédagogique pour comprendre le fonctionnement de l'analyse mémoire.
[!NOTE] Utilisation responsable. PyMemoryEditor communique avec d'autres processus via des API au niveau du système d'exploitation. Ne l'utilisez que sur des processus que vous possédez ou pour lesquels vous avez une autorisation explicite d'inspection.
🤝 Contribution
Les pull requests, rapports de bugs et idées de fonctionnalités sont les bienvenus. Lisez
CONTRIBUTING.md pour la configuration de développement, la structure des tests et
le petit ensemble de particularités spécifiques aux plateformes à connaître.
Si PyMemoryEditor a aidé votre projet, merci de ⭐ le dépôt — c'est le moyen le plus simple de soutenir le travail et d'aider d'autres personnes à découvrir la bibliothèque.
Licence
Publié sous la Licence MIT — libre pour un usage personnel et commercial.