Skip to content
Back to search

32bit-to-64bit-app-migration

Rehost a 32-bit ARM game or app inside a 64-bit process — feasibility, bring-up, interpreter correctness, frame optimisation, and shipping.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/apkdeployer2580--32bit-to-64bit-app-migration/badge.svg)](/listings/apkdeployer2580--32bit-to-64bit-app-migration)

HTML

<a href="/listings/apkdeployer2580--32bit-to-64bit-app-migration"><img src="/api/listings/apkdeployer2580--32bit-to-64bit-app-migration/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

/plugin marketplace add apkdeployer2580/32bit-to-64bit-app-migration
/plugin install rehost@32bit-to-64bit-app-migration

Then just describe what you are doing — the skills trigger on their own. Or start explicitly:

/rehost:start payload/libgame.so

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 17 lines
  1. {
  2. "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
  3. "name": "32bit-to-64bit-app-migration",
  4. "description": "Rehost a 32-bit ARM game or app inside a 64-bit process — feasibility, bring-up, interpreter correctness, frame optimisation, and shipping.",
  5. "owner": {
  6. "name": "apkdeployer2580"
  7. },
  8. "plugins": [
  9. {
  10. "name": "rehost",
  11. "description": "Run an unmodified 32-bit ARM binary inside a 64-bit app: measure the seam, bring it up headless, prove the interpreter, port the hot guest functions to the host until the frame budget holds, and ship it without breaking saves.",
  12. "category": "development",
  13. "source": "./plugins/rehost",
  14. "homepage": "https://github.com/apkdeployer2580/32bit-to-64bit-app-migration"
  15. }
  16. ]
  17. }
README.md · README · 104 lines
  1. # 32bit → 64bit app migration
  2. A Claude Code plugin marketplace for **rehosting** a 32-bit ARM game or app
  3. inside a 64-bit process.
  4. 32비트 ARM 게임/앱을 **64비트 프로세스 안에서 원본 그대로 실행**시키는 작업의
  5. 방법론을 Claude Code 스킬로 묶은 마켓플레이스.
  6. ---
  7. ## The premise / 전제
  8. There is no tool that turns ARM32 machine code into ARM64 machine code. If the
  9. app's body is a 32-bit `.so` and you don't have the source, "converting the APK
  10. to 64-bit" is not a thing that exists.
  11. What does exist: run the original 32-bit code on an **interpreter inside a pure
  12. 64-bit process**, and natively implement only the **narrow seam** where that
  13. code meets the outside world. The game logic stays the shipped binary, bit for
  14. bit; everything around it is 64-bit.
  15. > **32비트 기계어를 64비트 기계어로 변환하는 도구는 없다.** 대신 원본 코드를
  16. > 64비트 프로세스 안에서 **해석 실행**하고, 그 코드가 바깥과 만나는 **좁은
  17. > 경계면만** 네이티브로 구현한다. 이 마켓플레이스는 그 작업의 순서, 함정,
  18. > 그리고 **증명 방법**을 담는다.
  19. Whether it is worth doing is one measurable number — how many distinct things
  20. the binary calls *outside itself*. The first skill measures it for you.
  21. ## Install
  22. ```
  23. /plugin marketplace add apkdeployer2580/32bit-to-64bit-app-migration
  24. /plugin install rehost@32bit-to-64bit-app-migration
  25. ```
  26. Then just describe what you are doing — the skills trigger on their own. Or
  27. start explicitly:
  28. ```
  29. /rehost:start payload/libgame.so
  30. ```
  31. ## What's in it
  32. | Skill | When it fires |
  33. |---|---|
  34. | **rehost-feasibility** | "can this 32-bit game be ported", start of a project — measures the seam and writes the go/no-go |
  35. | **rehost-bringup** | guest address space, ELF32 loader, import/JNI trampolines, first frame, black-screen traps |
  36. | **deterministic-probe** | the headless replay harness: virtual clock, scripted input, frame dumps, PC profiling — the development loop |
  37. | **cpu-differential-test** | prove the interpreter instruction-by-instruction against Unicorn; the silent-decode-bug class |
  38. | **frame-optimization** | slow, stutters, lags after a boss fight — profile to a named guest function, port it to the host bit-exactly, prove it pixel-identical |
  39. | **guest-behavior-patching** | fix an original-game bug or add a QoL change through host-side hooks instead of editing the binary |
  40. | **legacy-assets-and-encoding** | assets won't load, fonts crash at boot, text renders as wrong-but-readable characters |
  41. | **network-rehost** | online features hang; the original servers are gone; decode the wire protocol and stand up a private server |
  42. | **ship-64bit-android** | release signing, update compatibility, **not destroying players' saves**, lifecycle and surface handling |
  43. ### Scripts (`plugins/rehost/scripts/`)
  44. All game-agnostic, all runnable on their own.
  45. | Script | What it does |
  46. |---|---|
  47. | `seam_census.py` | the go/no-go report: imports by library, JNI entry points, symbol survival, arch tags, relocation histogram, loader hazards |
  48. | `xref.py` | every branch **and every stored 32-bit word** pointing at a symbol — finds functions reached only through a pointer, which a `bl` search reports as dead code |
  49. | `disasm.py` | symbol-aware disassembly with PIC/GOT globals resolved to names and incoming stack-argument offsets computed from the prologue |
  50. | `armdiff.py` + `armdiff_helper.rs` | differential-test your interpreter against Unicorn, one instruction at a time |
  51. | `ab_compare.py` | pixel-exact frame-dump comparison — the acceptance test for every host port |
  52. | `frame_stats.py` | per-frame cost as a distribution (p90/p99/max/over-budget/worst frames), with before-vs-after |
  53. ```bash
  54. python plugins/rehost/scripts/seam_census.py libgame.so
  55. python plugins/rehost/scripts/xref.py libgame.so SomeBlitter --words
  56. python plugins/rehost/scripts/disasm.py libgame.so SomeBlitter --frame
  57. python plugins/rehost/scripts/ab_compare.py out_ref out_test
  58. ```
  59. Dependencies: `pip install pyelftools capstone pillow unicorn`
  60. (each script only needs the ones it names).
  61. ## Where this came from
  62. Distilled from two shipped rehosts of Korean feature-phone (WIPI) RPGs onto
  63. 64-bit-only Android — one native-C guest, one JVM guest. Everything specific to
  64. those games (addresses, symbol names, struct offsets, protocol opcodes) has
  65. been left out; what remains is the part that transferred between them.
  66. Some numbers those projects produced, as a sense of what the method is worth:
  67. * interpreter-only → all hot guest functions hosted: **15.1 billion → 72 million**
  68. guest instructions over the same 2600-frame deterministic replay (**≈210×**),
  69. with all 12 dumped frames **pixel-identical** to the unpatched interpreter
  70. * frames over the 33 ms budget: **205/2600 → 1/2600**. The mean was never the
  71. problem — it sat at a comfortable 10.6 ms the whole time, while p99 was 84.6 ms
  72. * one menu-open frame: **55.6 million guest instructions → O(w·h)**, identical output
  73. * the seam that made all of it possible: **79 imported symbols, 14 JNI entry
  74. points** against 878 KB of machine code nobody had the source to
  75. The skills are written in Korean with English frontmatter, matching the
  76. working notes they were extracted from.
  77. ## License
  78. MIT — see [LICENSE](LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.