dolphin-memory-engine

What it is and what it does

Dolphin Memory Engine is a Python library that hooks into a running Dolphin emulator process to read and write its memory at runtime. It's designed for developers working with Dolphin who need programmatic access to game state during emulation—useful for testing, automation, or memory analysis workflows. The library is distributed as compiled wheels for Python 3.9 to 3.12 on x86_64 Linux, Windows, and Intel macOS.

The package has no runtime dependencies and is classified as Alpha. It requires an active Dolphin emulation session to be useful, at least 250 MB of free system memory, and an x86_64 processor (32-bit x86 and macOS are unsupported). The repository is actively maintained with recent commits, and the project is licensed under MIT.

Use it for:

• Automate testing of game behavior by reading and modifying memory values during emulation
• Develop tools to inspect and log game state changes in real time while playing
• Create memory-based cheats or trainers that modify game values programmatically
• Debug emulation issues by analyzing memory contents during gameplay
• Build analysis tools to extract or monitor specific game data structures

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Reads and writes the memory of a running Dolphin emulator process during gameplay, enabling runtime inspection and modification of game state.

Yes, if you are developing tools for Dolphin emulation and need programmatic memory access. The package is actively maintained, has no external dependencies, and carries a permissive MIT license. Install friction is moderate due to platform-specific wheels and system requirements (x86_64 only, macOS unsupported, Dolphin must be running). Not suitable for macOS users or those without x86_64 hardware.

Install

dolphin-memory-engine on PyPI

pip install dolphin-memory-engine

uv add dolphin-memory-engine

poetry add dolphin-memory-engine

Installing dolphin-memory-engine

Before you install

Medium install friction due to compiled wheels for specific platforms. Requires Dolphin emulator to be running with active emulation, at least 250 MB free memory, and x86_64 architecture (macOS unsupported). Repository is active with recent commits.

License in practice

MIT license permits unrestricted use provided copyright notices are preserved, making this suitable for both personal and commercial projects without licensing restrictions.

Quickstart

pip install dolphin-memory-engine

import dolphin_memory_engine

# Requires Dolphin emulator running with active emulation
memory = dolphin_memory_engine.MemoryReader()
value = memory.read()

Dolphin emulator must be running with active emulation started. x86_64 architecture required; macOS not supported. Requires at least 250 MB free memory. nosuid mount flag on /etc/fstab can cause silent failures.

Verify before relying

• Whether the package works reliably across all supported Python versions on different x86_64 systems
• Performance characteristics when reading or writing memory regions during active emulation
• Compatibility with different Dolphin versions or emulation modes

Package facts

Evidence: dolphin_memory_engine-1.3.1-cp39-abi3-macosx_10_9_x86_64.whl; dolphin_memory_engine-1.3.1-cp39-abi3-macosx_11_0_arm64.whl; dolphin_memory_engine-1.3.1-cp39-abi3-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl; dolphin_memory_engine-1.3.1-cp39-abi3-win_amd64.whl

Tags

More Software Development packages