A generalized, multi-app version of headoverheels-r36s by fernandoalves25, which runs the 2003 Head Over Heels Windows remake on the R36S handheld (ArkOS, Rockchip RK3326) via Box64 + Wine (WoW64) + Weston/Xwayland.
This fork strips out the game-specific pieces (hardcoded HoH.exe, Allegro .dll
swap, allegro.cfg generation) and turns the launcher into a reusable template:
a shared Box64/Wine/Weston runtime plus a thin per-app wrapper script, so you can
point it at any small Windows .exe instead of just one game.
This project is a derivative of headoverheels-r36s. The core mechanics —
launching Wine inside Weston via westonwrap.sh, the CPU/GPU performance
governor tuning, the zram swap workaround for 1GB RAM, and the baseline Box64
dynarec flags (SAFEFLAGS/STRONGMEM/BIGBLOCK/CALLRET) — come directly from
that repository's Head Over Heels.sh and run_inner.sh, generalized here.
All credit for figuring out that these specific settings work on the R36S goes
to the original author. See the upstream repo
for the original, game-specific, ready-to-run port.
Third-party components referenced (not bundled in this repo — see setup below):
- Box64 by ptitSeb — GPLv3
- Wine builds by Kron4ek — LGPL
- Westonpack by binarycounter, distributed via PortMaster
- A shared runtime folder (
winecommon/) for Box64 + Wine + Weston, used by every app you add, instead of duplicating ~250MB per port. - A
new_port.shgenerator: one command creates a new launcher.shplus a per-app folder for game files, controller mapping, and dynarec tuning. - No guarantee anything runs well. The R36S has 1GB RAM and a GPU driver with no Panfrost/OpenGL support (software rendering only), so this is for experimentation with lightweight apps, not a general Windows-gaming solution.
- Get Box64 (RK3326 build), a Wine amd64-wow64 build, and a Westonpack squashfs — easiest source is the headoverheels-r36s release zip, or build/download them from the links above.
- Place them under
roms/ports/winecommon/(seeREADME_GENERIC.mdfor the exact layout and how to build a cleanbaseprefix64.tar.gz). - Generate a new app entry:
./new_port.sh "My App" myapp notepad.exe - Copy the app's files into
roms/ports/myapp/gamedata/, refresh EmulationStation, and launch "My App" from Ports.
Full details, environment variables, and troubleshooting: see README_GENERIC.md.
Port/wrapper scripts in this repo: MIT (same as upstream). Box64, Wine, and Weston are separate projects under their own licenses (GPLv3 / LGPL) and are not included in this repository — you fetch them yourself per the setup instructions.
fernandoalves25 さんの headoverheels-r36s を元に、汎用化・複数アプリ対応にしたものです。元リポジトリは、R36S携帯機 (ArkOS、Rockchip RK3326)上で Box64 + Wine(WoW64) + Weston/Xwayland を 使い、2003年のWindowsゲーム「Head Over Heels」リメイク版を動かすポートです。
このForkでは、ゲーム固有の部分(HoH.exeのハードコード、Allegro用.dll
差し替え、allegro.cfg生成)を取り除き、共有ランタイム(Box64/Wine/Weston)
+アプリごとの薄いラッパースクリプト、という再利用可能な構成に組み替えて
います。これにより、特定のゲーム1本だけでなく、任意の軽量Windows実行ファイル
を対象にできます。
このプロジェクトは headoverheels-r36s の派生です。核となる仕組み——
westonwrap.sh経由でWeston内にWineを起動する手順、CPU/GPUパフォーマンス
ガバナー設定、1GB RAM対策のzram swap、そしてBox64 dynarecの基準値
(SAFEFLAGS/STRONGMEM/BIGBLOCK/CALLRET)——は、すべて元リポジトリの
Head Over Heels.sh と run_inner.sh をそのまま汎用化したものです。
これらの設定がR36S上で動くことを見つけ出した功績はすべて原作者に帰属します。
特定ゲーム向けのすぐ使えるポートが欲しい場合は
元リポジトリ
を参照してください。
参照している(本リポジトリには同梱していない)サードパーティ:
- Box64(ptitSeb作) — GPLv3
- Wineビルド(Kron4ek作) — LGPL
- Westonpack(binarycounter作、PortMaster経由で配布)
- 共有ランタイムフォルダ(
winecommon/)にBox64+Wine+Westonを1回だけ配置 し、アプリを追加するたびに約250MBを複製せずに済む new_port.shで1コマンド、新しいランチャー.shとアプリ用フォルダ (ゲームデータ・コントローラー割り当て・dynarecチューニング置き場)を生成- 快適に動く保証は一切ありません。 R36Sは1GB RAM、GPUドライバは Panfrost/OpenGL非対応(ソフトウェアレンダリングのみ)なので、軽量アプリの 実験用と割り切ってください。汎用Windowsゲーミング環境ではありません。
- Box64(RK3326向けビルド)、Wine amd64-wow64ビルド、Westonpack squashfs を 用意する——最も手っ取り早いのは headoverheels-r36sのリリースzip から流用する方法。上記リンクから個別にビルド/入手も可能。
roms/ports/winecommon/に配置する(正確な構成とbaseprefix64.tar.gzの 自作方法はREADME_GENERIC.mdを参照)。- 新しいアプリを生成する:
./new_port.sh "My App" myapp notepad.exe - アプリのファイルを
roms/ports/myapp/gamedata/にコピーし、 EmulationStationのゲームリストを更新して「My App」を起動する。
詳細な手順・環境変数・トラブルシューティングは README_GENERIC.md を参照。
本リポジトリのポート/ラッパースクリプト: MIT(元リポジトリと同じ)。 Box64・Wine・Westonはそれぞれ別プロジェクトで、各自のライセンス (GPLv3 / LGPL)に従います。本リポジトリには同梱していないため、 セットアップ手順に従って各自で入手してください。