Skip to content

About

R36SでWine

Resources

Stars

1 star

Watchers

0 watching

Forks

 
 

Latest commit

 

History

4 Commits

Folders and files

Repository files navigation

R36S Generic Wine Launcher

English | 日本語


English

What this is

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.

Credit

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):

What you get / what you don't

  • A shared runtime folder (winecommon/) for Box64 + Wine + Weston, used by every app you add, instead of duplicating ~250MB per port.
  • A new_port.sh generator: one command creates a new launcher .sh plus 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.

Setup

  1. 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.
  2. Place them under roms/ports/winecommon/ (see README_GENERIC.md for the exact layout and how to build a clean baseprefix64.tar.gz).
  3. Generate a new app entry:
    ./new_port.sh "My App" myapp notepad.exe
  4. 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.

License

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上で動くことを見つけ出した功績はすべて原作者に帰属します。 特定ゲーム向けのすぐ使えるポートが欲しい場合は 元リポジトリ を参照してください。

参照している(本リポジトリには同梱していない)サードパーティ:

できること・できないこと

  • 共有ランタイムフォルダ(winecommon/)にBox64+Wine+Westonを1回だけ配置 し、アプリを追加するたびに約250MBを複製せずに済む
  • new_port.sh で1コマンド、新しいランチャー.shとアプリ用フォルダ (ゲームデータ・コントローラー割り当て・dynarecチューニング置き場)を生成
  • 快適に動く保証は一切ありません。 R36Sは1GB RAM、GPUドライバは Panfrost/OpenGL非対応(ソフトウェアレンダリングのみ)なので、軽量アプリの 実験用と割り切ってください。汎用Windowsゲーミング環境ではありません。

セットアップ

  1. Box64(RK3326向けビルド)、Wine amd64-wow64ビルド、Westonpack squashfs を 用意する——最も手っ取り早いのは headoverheels-r36sのリリースzip から流用する方法。上記リンクから個別にビルド/入手も可能。
  2. roms/ports/winecommon/ に配置する(正確な構成とbaseprefix64.tar.gzの 自作方法は README_GENERIC.md を参照)。
  3. 新しいアプリを生成する:
    ./new_port.sh "My App" myapp notepad.exe
  4. アプリのファイルを roms/ports/myapp/gamedata/ にコピーし、 EmulationStationのゲームリストを更新して「My App」を起動する。

詳細な手順・環境変数・トラブルシューティングは README_GENERIC.md を参照。

ライセンス

本リポジトリのポート/ラッパースクリプト: MIT(元リポジトリと同じ)。 Box64・Wine・Westonはそれぞれ別プロジェクトで、各自のライセンス (GPLv3 / LGPL)に従います。本リポジトリには同梱していないため、 セットアップ手順に従って各自で入手してください。

About

R36SでWine

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages