Registry / database / dolphin-memory-engine

dolphin-memory-engine

library1.3.1pypypi✓ verified 89d ago

Python library for reading and writing the memory of running Dolphin (GameCube/Wii emulator) processes. Provides a high-level interface to access game memory addresses, supporting both GameCube and Wii titles. Current version is 1.3.1, with limited API wheels and Python 3.9+ support. The project is actively maintained.

database

pip install dolphin-memory-engine

github ↗package ↗

INSTALL

IMPORT

SIG · DOLPHIN-MEMORY-ENG

dolphin-memory-engine

databasepythonv1.3.1

Install

1.6s avg

Import

—

Disk

17MB

Pass rate

5/ 10

Env Coverage5 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v1.3.1 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

build_error

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 1.6s · import 0.000s · 19MB

17MB installed

● package 17MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

dolphin_memory_engine

✓ import dolphin_memory_engine

✗ from dolphin_memory_engine import DolphinMemoryEngine

Basic hook and memory read. Ensure Dolphin emulator is running before calling hook().

from dolphin_memory_engine import hook, is_hooked, read_word hook() if is_hooked(): # Example: read word from address 0x80000000 value = read_word(0x80000000) print(f"Value at 0x80000000: {value}") else: print("Failed to hook into Dolphin. Is Dolphin running?") unhook()

Debug

Known issues

breakingThe package was renamed from 'py-dolphin-memory-engine' to 'dolphin-memory-engine' in v1.3.0. The old package may still exist but is outdated.

fix

Install 'dolphin-memory-engine' instead of 'py-dolphin-memory-engine'.

affects: >=1.3.0

gotchahook() will raise an exception if Dolphin is not running or if the emulated game is not started. Always check is_hooked() after hook() or use try/except.

fix

Wrap hook() in a try-except or call is_hooked() immediately after hook().

affects: all

deprecatedPython 3.8 support was dropped in v1.3.0. If you are on Python 3.8, you must upgrade to Python 3.9+.

fix

Upgrade Python to 3.9 or later.

affects: >=1.3.0

gotchaThe library uses ctypes and a C extension, which may not be available on all platforms. macOS wheels are provided but not tested; if import fails, install from source or use Linux/Windows.

fix

Use a supported platform (Linux or Windows) or build from source.

affects: all

Upgrade

Version history

1.3.1latest on PyPI · released Mar 29, 2026

Audit

Dependencies

py-dolphin-memory-enginerequiredLegacy package name, no longer updated; use dolphin-memory-engine instead

Agent activity

11 hits · last 30 days

node

Resources

githubhttps://github.com/henriquegemignani/py-dolphin-memory-engine ↗

packagehttps://pypi.org/project/dolphin-memory-engine/ ↗