PyMemoryEditor

Библиотека на чистом Python (построенная на ctypes), которая позволяет просматривать, изменять и искать в памяти любого запущенного процесса всего в несколько строк Python — рабочие процессы Cheat Engine на Windows, Linux и macOS!

Читайте, пишите и сканируйте память любого процесса — прямо из Python.
Один унифицированный API. Три операционные системы. Без C-компилятора. Без этапа нативной сборки.

Работает на 🪟 Windows · 🐧 Linux · 🍎 macOS — 32-битных и 64-битных системах.

Измените значение в работающей игре · изучите состояние запущенной программы · извлекайте данные прямо из оперативной памяти.

Установка

pip install PyMemoryEditor

Чтобы также установить встроенное GUI-приложение (сканер в стиле Cheat Engine), используйте дополнительный пакет app:

pip install "PyMemoryEditor[app]"
pymemoryeditor

Для более быстрого сканирования больших процессов добавьте дополнительный пакет speed. Он подтягивает NumPy и автоматически векторизует цикл сравнения числовых значений — примерно в 10–30 раз быстрее при выборочном сканировании:

pip install "PyMemoryEditor[speed]"

📖 Полное руководство на Read the Docs.

Пример в действии

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)

Вот и всё — читайте, пишите или сканируйте другой процесс в три строки, одинаково на любой платформе.

Что внутри

🐍 Python-библиотека

Полный контроль над памятью другого процесса — всего в несколько строк Python:

• ✅ Чтение и запись значений (int, float, bool, str, bytes)
• 🔍 Поиск значения с восемью режимами сравнения
• 🎯 Сигнатурный поиск (AOB в стиле IDA и regex)
• 🔗 Цепочки указателей + живой дескриптор RemotePointer
• 🧭 Сканирование указателей — поиск статических указателей, переживающих ASLR
• 🗺️ Карта памяти, модули, потоки
• 🧱 Выделение и освобождение удалённой памяти (Windows / macOS)

🖥️ Встроенное GUI-приложение

Вся мощь библиотеки — без единой строки кода:

• ⚡ Без настройки — подключитесь к процессу и начните сканирование за секунды
• 🧲 Уточнение результатов — First Scan → Next Scan с визуальной обратной связью в реальном времени
• 📋 Чит-таблица — заморозка / запись значений на лету, импорт/экспорт JSON
• 🔬 Hex-просмотрщик — просмотр сырой памяти и запись изменений на месте
• 🧩 Интерфейс сканирования указателей — сканирование, экспорт и повторное сканирование между сессиями в несколько кликов
• 🎨 Доступ в один клик — все функции под рукой, код не нужен

📖 Документация

Полная документация находится на pymemoryeditor.readthedocs.io — установка, рабочий процесс Cheat Engine, каждый метод и параметр, руководство по GUI-приложению, примечания по платформам и устранение неполадок.

Краткая карта разделов:

Что можно создать с помощью этого?

• 🎮 Инструменты для моддинга игр и спидраннинга — классический сценарий использования Cheat Engine.
• 🔬 Отладка и интроспекция — исследование текущего состояния без подключения отладчика.
• 📊 Инструменты наблюдаемости — сбор значений переменных в запущенном процессе для телеметрии.
• 🔐 Исследования в области безопасности и реверс-инжиниринга — на системах, которыми вы владеете или на тестирование которых у вас есть разрешение.
• 🎓 Обучение — встроенное приложение — отличный учебный инструмент для понимания того, как работает сканирование памяти.

[!NOTE] Ответственное использование. PyMemoryEditor взаимодействует с другими процессами через системные API. Направляйте его только на те процессы, которыми вы владеете или которые вам явно разрешено исследовать.

🤝 Вклад

Пул-реквесты, отчёты об ошибках и идеи новых функций очень приветствуются. Ознакомьтесь с CONTRIBUTING.md, чтобы узнать о настройке окружения разработки, структуре тестов и небольшом наборе особенностей платформ, о которых стоит знать.

Если PyMemoryEditor помог вашему проекту, пожалуйста, поставьте ⭐ репозиторию — это самый простой способ поддержать работу и помочь другим узнать о библиотеке.

Лицензия

Распространяется под лицензией MIT — бесплатна для личного и коммерческого использования.