PyMemoryEditor

Una libreria puramente Python (basata su ctypes) che ti permette di ispezionare, modificare e cercare la memoria di qualsiasi processo in esecuzione in poche righe di Python — flussi di lavoro di Cheat Engine su Windows, Linux e macOS!

Leggi, scrivi e scansiona la memoria di qualsiasi processo — direttamente da Python.
Una API unificata. Tre sistemi operativi. Nessun compilatore C. Nessun passo di compilazione nativa.

Eseguito su 🪟 Windows · 🐧 Linux · 🍎 macOS — 32-bit e 64-bit.

Modifica un valore in un gioco in esecuzione · ispeziona lo stato di un programma live · raccogli dati direttamente dalla RAM.

Installazione

pip install PyMemoryEditor

Per installare anche l'app GUI inclusa (uno scanner stile Cheat Engine), usa l'extra app:

pip install "PyMemoryEditor[app]"
pymemoryeditor

Per scansioni più veloci su processi grandi, aggiungi l'extra speed. Include NumPy e vettorializza automaticamente il ciclo di confronto delle scansioni numeriche — ~10–30× più veloce su scansioni selettive:

pip install "PyMemoryEditor[speed]"

📖 Guida completa su Read the Docs.

Vedilo in azione

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)

Ecco fatto — leggi, scrivi o scansiona un altro processo in tre righe, allo stesso modo su ogni piattaforma.

Cosa contiene

🐍 La libreria Python

Controllo completo sulla memoria di un altro processo — in poche righe di Python:

• ✅ Leggi e scrivi valori (int, float, bool, str, bytes)
• 🔍 Scansione valori con otto modalità di confronto
• 🎯 Scansione pattern (AOB stile IDA e regex)
• 🔗 Catene di puntatori + un handle live RemotePointer
• 🧭 Scansione puntatori — trova puntatori statici che sopravvivono ad ASLR
• 🗺️ Mappa della memoria, moduli, thread
• 🧱 Alloca e libera memoria remota (Windows/macOS)

🖥️ L'app GUI inclusa

Tutta la potenza della libreria — nessun codice necessario:

• ⚡ Zero configurazione — collegati a un processo e inizia a scansionare in pochi secondi
• 🧲 Flusso di lavoro raffinato — Prima Scansione → Scansione Successiva con feedback visivo in tempo reale
• 📋 Cheat table — congela/scrivi valori al volo, importa/esporta JSON
• 🔬 Visore esadecimale — esplora la memoria grezza e riscrivi in linea
• 🧩 Interfaccia scansione puntatori — scansiona, esporta e riscansiona tra sessioni con pochi clic
• 🎨 Accesso con un clic — ogni funzionalità a portata di mano, nessun codice necessario

📖 Documentazione

La documentazione completa è disponibile su pymemoryeditor.readthedocs.io — installazione, flusso di lavoro di Cheat Engine, ogni metodo e parametro, guida dell'app GUI, note sulla piattaforma e risoluzione dei problemi.

Una mappa rapida per orientarsi:

Cosa posso costruire con questo?

• 🎮 Strumenti per modding di giochi e speedrunning — il caso d'uso classico di Cheat Engine.
• 🔬 Debugging e introspezione — ispeziona lo stato live senza allegare un debugger.
• 📊 Strumenti di osservabilità — campiona variabili in un processo in esecuzione per telemetria.
• 🔐 Ricerca sulla sicurezza e reverse engineering — su sistemi di tua proprietà o che sei autorizzato a testare.
• 🎓 Apprendimento — l'app inclusa è un ottimo strumento didattico per capire come funziona la scansione della memoria.

[!NOTE] Uso responsabile. PyMemoryEditor comunica con altri processi tramite API a livello di sistema operativo. Puntalo solo a processi di tua proprietà o per cui hai esplicita autorizzazione a ispezionare.

🤝 Contribuire

Pull request, segnalazioni di bug e idee per funzionalità sono molto benvenute. Leggi CONTRIBUTING.md per la configurazione di sviluppo, l'organizzazione dei test e le piccole peculiarità specifiche della piattaforma da tenere a mente.

Se PyMemoryEditor ha aiutato il tuo progetto, per favore metti ⭐ al repo — è il modo più semplice per supportare il lavoro e aiutare altri a scoprire la libreria.

Licenza

Rilasciato sotto Licenza MIT — gratuito per uso personale e commerciale.