addams-family-recompiler est un portage natif de The Addams Family pour macOS, compilé depuis ses sources.
Architecture
Mac OS X - macOS
Original game
The Addams Family NES
Download and links
- Download The Addams Family
- Source code 3 GitHub stars
- License : MIT
Version history
0.9.0-beta
Full changelog
NES Native Lab is an experimental NES static recompilation project. This first public beta runs the supported European PAL (En/Fr/De) release of **The Addams Family** through generated native C and a C++ runtime.**The commercial game is not included.** Provide your own legitimately obtained compatible ROM. Its complete identity is checked with SHA-256; validation is not bypassed. This release supports one verified ROM revision, not NES games universally.### What is new- English application prompts, import progress, error messages and window titles. The game's original language selector is unchanged. - A compact controls banner appears for about 10 real seconds. Press **F1** or controller **Y** to hide it early. - **Escape**, normal window close and **Cmd+Q** request confirmation. **Cancel** is selected initially; the game and audio pause safely and resume on cancellation. Mouse, keyboard and supported controllers can operate the dialog. - Original **256 × 240** NES output presented at **4:3**, adaptable nearest scaling, black bars where needed and **F11** fullscreen. Experimental widescreen remains disabled. - Official NES Native Lab icons, portable local import tools, build identity and runtime **ABI v3** checks. - **GOD mode is off by default.** Debug assistance remains separate from normal play.These are new packages built from the same final source commit. Their internal package version is **0.9.0** and the frontend identifies itself as **0.9.0-beta**. Python and Zig required for local compilation are included; no development environment is required. Initial preparation can take a few minutes.### Download and start- **Windows x64:** download the Windows ZIP, extract the entire folder and run `nes_native.exe`. Select your compatible ROM when prompted. Keep all bundled files together. - **macOS Apple Silicon / Intel:** download the ZIP matching your Mac and open `NES Native Lab.app`. Requires **macOS 15 or newer**. Select your compatible ROM. - **Linux x64 / Steam Deck desktop mode:** download the AppImage, run `chmod +x NES-Native-Lab-Linux-x86_64.AppImage`, then open it and drag your compatible `.nes` file into the prompt. If FUSE is unavailable, use `./NES-Native-Lab-Linux-x86_64.AppImage --appimage-extract-and-run`. No ROM download links are provided.Keyboard: arrows move, **Z** jumps, **X** acts, **Enter** is START/inventory, **Right Shift** is SELECT. Controller: D-pad/left stick, A/B, Start/Back. **Escape** opens the exit menu; arrows/Tab choose, Enter activates the selected button and Escape cancels. Controller A confirms, B cancels; Guide opens the menu when the OS delivers that button.### Verification and limitationsAll four native builds and package checks passed on commit `bafd0cf5ef2007daa24c133c3e45dd5d55a8d985` in [GitHub Actions run 38290678505](https://github.com/inthe92/addams-family-recompiler/actions/runs/38290678505). Each platform executed **43 CTest entries: 42 passed, 1 failed (A02), 0 omitted**, including all 56 new frontend cases, 4,736 native instruction executions and 82 IRQ cases. The workflow remains red for A02. Synthetic import, module load, cache/ABI and package checks do not constitute a complete playthrough. Windows was verified on Windows Server 2025; macOS packages were tested natively on macOS 15 ARM64 and Intel; Linux on Ubuntu 22.04 x64. The frontend UI was also checked locally with a private ROM on macOS ARM64.- **A02 remains open:** a PAL APU IRQ/status timing discrepancy. No gameplay impact has been demonstrated. It remains an ordinary failing test; the complete suite is not fully green. - Linux/Steam Deck still needs a complete compatible-ROM gameplay check. Additional visual/controller and Windows 10/11 consumer-PC testing is welcome. - Undetected game, sound or device-specific issues may remain. This beta is not a stable 1.0 or RC. - Windows has **no Authenticode signature**. macOS has **ad hoc signing and is not notarized**. Follow normal OS security review; no security checks are disabled. - No commercial ROM, graphics, music, translated game module or private import cache is distributed. The technical content audit is **not a legal certification** or authorization from rights holders. The project is independent and is not affiliated with or endorsed by them.For a bug report, include your OS/architecture, the build identity (`--build-info`), what you did and the relevant diagnostic error. Never upload your ROM, generated module or private cache.### SHA-256```text 17cfa047521208f75279fa1436dc3e482faf8fd0e4591d2c4c3749b05f3092b4 NES-Native-Lab-Linux-x86_64.AppImage 32d73cf315a3a78a6da9329f772f69c5d2aec5a8a1f7b545476b37f14dcc815b NES-Native-Lab-Windows-x86_64.zip f425417a82711339e412987c73a83a562e5116b1da5505446e582899269eeac8 NES-Native-Lab-macOS-arm64.zip 7f773aef7da117e57cd575cf0b7c9330c4dcb27aa4e54ebebbfef7d8dcd9918d NES-Native-Lab-macOS-x86_64.zip ```
0.3.0-alpha
Full changelog
Experimental testing alpha / Alfa experimental de pruebas
English
NES Native Lab is an experimental static recompilation of NES 6502 code to C, compiled locally into a native module. NES hardware behavior is reproduced by the runtime. This alpha is intended for testing; it is not an RC or version 1.0, and complete gameplay correctness is not established. Compatibility is limited to the supported European En/Fr/De revision of The Addams Family, not NES games in general.
Downloads and first start
- Windows x64:
NES-Native-Lab-Windows-x86_64.zip. Extract the complete folder and runnes_native.exe. - macOS Apple Silicon, macOS 15 or later:
NES-Native-Lab-macOS-arm64.zip. - macOS Intel, macOS 15 or later:
NES-Native-Lab-macOS-x86_64.zip. Extract and openNES Native Lab.app. - Checksums:
SHA256SUMS.txtcovers the exact three attached application ZIPs.
Python 3.11.17, Zig 0.17.0, importer tools and dependency notices are included for local import; no separate Python/compiler installation is needed. Keep each package intact. OpenGL 3.2 support is required. Provide your own compatible ROM when prompted; first local compilation may take several minutes. No ROM, translated commercial game code/module, extracted graphics, music or maps are distributed. Keep your ROM and generated module/cache private.
Supported ROM: 262160 bytes, European En/Fr/De, MMC1, SHA-256:
6143af950d2c4d353c859c56962406feed9930584882fba1056bba5f2614e880.
Other revisions and patched files are rejected. No game download is provided.
GOD mode starts enabled. Use --no-god for normal play: on Windows, run .\nes_native.exe --no-god from the extracted folder; on macOS, run "NES Native Lab.app/Contents/MacOS/nes_native" --no-god. Avoid G/H during an unaided test. Keys: arrows, Z/X, Enter, right Shift; Escape closes gameplay. Import errors show their cause and local log location.
What was actually verified
Windows was built and tested natively on Windows Server 2025 x64: clean ZIP extraction into a path with spaces, bundled Python/Zig execution with installed tools removed from child PATH, synthetic C DLL compilation/loading, importer/cache decision tests, actual frontend ROM-picker cancellation and invalid-ROM error/shutdown. A real compatible-ROM import and game session on consumer Windows 10/11 remain pending, including graphics, sound and cached relaunch. Synthetic checks are not a real game run.
Both macOS packages were built and tested natively on macOS 15.7.9, on their matching ARM64/Intel runners. Architecture/minimum-version/dependency checks, strict ad hoc signature verification before/after clean ZIP extraction, bundled Python/Zig, synthetic module compilation/loading and importer error checks passed. The declared minimum is 15.0; not every macOS 15 patch version or first-open Gatekeeper path was tested.
For each of the three selected native builds, full CTest executed 19 entries: 18 passed, 1 failed (A02), 0 skipped. The passing tests include 4,736 generated-C instruction executions, stack programs, RAM/MMC1/bus/PPU, both $2002 regressions, ABI-v2/import/cache and the A01/A03 corrections. CI remains red: A02's PAL IRQ collision/reference remains open ($4015 at cycle 33,252 returns $40, then IRQ is 0 versus the test's expectation of 1). Its precise PAL timing reference still needs confirmation; the failing test has not been hidden or changed.
Widescreen rooms, enemy activation and some game situations may be incorrect. Normal full-game completion is not verified. Windows has no Authenticode signature; macOS is ad hoc signed and not notarized. No new Linux AppImage is included: recent Linux package verification was incomplete, so Linux is not validated for this release.
Exact provenance
Release tag v0.3.0-alpha points to the verified Windows source da4f990803518c4a57d31d40486d08909cf8860d, Windows run 38142932201. The two immutable Mac ZIPs come from 64dd1064d4a24241554f2ce5d94aa92255bd688f, macOS run 38132924396. Between those sources, only the Windows package verifier and workflow dispatch selection changed; no engine, ABI, recompiler or Mac package-content change invalidates the Mac verification. These existing binaries were not rebuilt or relabeled: their internal frontend/bundle version and some bundled documentation still say 0.2.1. The release identifier is 0.3.0-alpha; these notes describe its actual packages.
This independent project is not affiliated with or endorsed by the rights holders. Technical content/provenance checks are not legal certification and do not establish authorization from the game's rights holders. Project/dependency licenses do not grant rights to the commercial game. All bundled notices are retained.
Español
NES Native Lab es una recompilación estática experimental del código 6502 de NES a C, que se compila localmente en un módulo nativo. El runtime reproduce el comportamiento del hardware NES. Esta alfa sirve para realizar pruebas: no es una RC ni una versión 1.0 y no se ha demostrado la corrección de una partida completa. Solo admite la revisión europea En/Fr/De compatible de The Addams Family; no anuncia compatibilidad general con juegos NES.
Descargas y uso
- Windows x64: descarga
NES-Native-Lab-Windows-x86_64.zip, extrae la carpeta completa y ejecutanes_native.exe. - macOS Apple Silicon o Intel, macOS 15 o posterior: elige el ZIP
arm64ox86_64, extrae y abreNES Native Lab.app. - SHA256SUMS.txt: contiene los hashes de los tres ZIP exactos adjuntos.
Se incluyen Python 3.11.17, Zig 0.17.0, el importador y los avisos de licencias. No hace falta instalar Python ni un compilador externo. Conserva todos los archivos del paquete; necesitas soporte OpenGL 3.2. Debes aportar tu propia ROM europea En/Fr/De compatible, de 262160 bytes y con el SHA-256 indicado arriba. La primera compilación local puede tardar varios minutos; otras revisiones o archivos modificados se rechazan.
No se distribuyen ROMs, código/módulos comerciales recompilados, gráficos, música ni mapas extraídos. Mantén privados tu ROM y los módulos/cachés generados. El proyecto no proporciona una descarga del juego.
El modo Dios está activado por defecto. Para jugar normalmente utiliza --no-god: en Windows, .\nes_native.exe --no-god; en macOS, "NES Native Lab.app/Contents/MacOS/nes_native" --no-god. No pulses G/H durante una prueba sin ayudas. Controles: flechas, Z/X, Enter, Shift derecho; Escape cierra la partida. Los errores de importación muestran su causa y la ubicación del registro local.
Verificación y límites
El paquete Windows se verificó en un runner nativo Windows Server 2025 x64: extracción limpia en una ruta con espacios, herramientas incluidas sin depender de las instaladas, compilación/carga de una DLL C sintética, pruebas del importador y decisiones de caché, cancelación del selector real de ROM y presentación/cierre de un error de importación. Todavía falta una importación válida y una partida real en Windows 10/11 doméstico, incluyendo gráficos, sonido y reapertura desde caché. Las pruebas sintéticas no equivalen a jugar.
Ambos macOS pasaron sus verificaciones en runners nativos macOS 15.7.9, ARM64 e Intel: arquitectura, mínimo declarado 15.0, dependencias, firma ad hoc estricta antes/después de extraer el ZIP, Python/Zig incluidos y compilación/carga de un módulo sintético. No se han probado todas las revisiones de macOS 15 ni todas las situaciones de primera apertura con Gatekeeper.
Cada compilación seleccionada ejecutó CTest completo: 19 pruebas, 18 aprobadas, 1 fallida (A02), ninguna omitida. Pasaron las 4.736 ejecuciones de instrucciones C generadas, pila, RAM/MMC1/bus/PPU, las dos regresiones de $2002, ABI v2/importación/caché y A01/A03. CI sigue en rojo por A02: lectura de $4015 en el ciclo PAL 33.252, valor $40, IRQ posterior 0 frente al 1 esperado. La referencia temporal PAL exacta sigue pendiente de confirmación; no se ha ocultado ni alterado el fallo.
Las habitaciones panorámicas, la activación de enemigos y ciertas situaciones del juego pueden presentar errores. Falta verificar una partida completa sin ayudas. Windows carece de firma Authenticode y macOS no está notarizado. No se adjunta un AppImage Linux nuevo: su verificación reciente quedó incompleta y no se presenta Linux como validado en esta versión.
La etiqueta apunta al commit Windows da4f990… indicado arriba. Los ZIP macOS proceden del commit anterior 64dd106…: los cambios posteriores solo afectan al verificador de Windows y la selección de jobs, no al motor, ABI, recompilador ni contenido del paquete Mac. Se conservan los binarios originales verificados; la versión interna y parte de sus documentos todavía indican 0.2.1, aunque esta publicación se identifica como v0.3.0-alpha. Los enlaces de procedencia y hashes permiten comprobar esa diferencia.
El proyecto es independiente, no está afiliado ni respaldado por los titulares de los derechos. Los controles técnicos no son una certificación jurídica ni prueban autorización de los titulares. Las licencias del proyecto y sus dependencias no conceden derechos sobre el juego comercial. Se conservan sus avisos correspondientes.
0.2.0-alpha
Full changelog
Alpha 0.2.0 / Alfa 0.2.0
English documentation | Documentación en español
English
First content-free native frontend release. Import your own compatible European En/Fr/De ROM locally. Python and Zig are included; no external compiler installation is required. GOD starts enabled; G toggles it and H grants inventory/access requirements. Keyboard and SDL gamepad input are supported.
Packages: macOS Apple Silicon ZIP, Windows x64 portable ZIP, Linux x64 AppImage intended for Steam Deck testing. macOS bundled import, actual OpenGL presentation and a 1800-frame garden boot probe passed. Windows/Linux are cross-built and inspected; actual hardware execution is pending. Widescreen enemy activation and fixed-width/vertical room issues remain. Full gameplay is not verified.
No game ROM, translated game module/code, extracted resources, recovered ASM or prior embedded alpha is included. See the source README for the exact compatible SHA-256 and Steam Deck setup. Keep imported modules/caches private. macOS is ad-hoc signed without notarization; Windows is unsigned.
Español
Primera entrega del frontend nativo sin contenido del juego. Importa localmente tu ROM europea En/Fr/De compatible. Incluye Python y Zig: no hace falta instalar un compilador externo. GOD se activa al iniciar; G lo cambia y H concede objetos y requisitos de acceso. Admite teclado y mandos SDL.
Paquetes: ZIP para macOS Apple Silicon, ZIP portátil para Windows x64 y AppImage Linux x64 para probar en Steam Deck. En macOS se han verificado la importación incluida, la presentación real con OpenGL y una prueba de arranque de 1800 fotogramas hasta el jardín. Windows/Linux están compilados e inspeccionados; falta probar su ejecución en equipos reales. Siguen pendientes la activación de enemigos en panorámico y las habitaciones verticales o de ancho fijo. No se ha verificado una partida completa.
No incluye ROM, módulo/código traducido del juego, recursos extraídos, ASM recuperado ni la alfa anterior con contenido incrustado. El README indica el SHA-256 compatible y los pasos de Steam Deck. Mantén privados los módulos y cachés importados. macOS lleva firma ad hoc, sin notarizar; Windows no está firmado.
Reply on the forum
A question or a hands-on report? Open the discussion on the forum.