// PORTMASTER : retro on handhelds

Port games to ARM handhelds (RG35XX, TrimUI, Retroid, etc.) using SDL2, Godot, and LÖVE2D runtimes.

portmaster@handheld:~$ cat quickstart.txt
[1] Install PortMaster from portmaster.games
[2] Drop .port folder into ports/
[3] Launch via PortMaster UI or ES-DE

Structure: mygame.port/
├── MyGame.sh # launch script
├── MyGame.squashfs # bundled runtime + assets
└── port.json # metadata (title, desc, author)

// RUNTIME TARGETS

# SDL2

▸ C/C++ with SDL2 runtime
▸ Use gptokeyb for input
▸ 320×240 or native resolution
▸ Frame cap to 60 FPS
# GODOT 4

▸ Export for ARM Linux
▸ Use godot-4.2 runtime
▸ Low-res viewports (320×240)
▸ Touch + controller input
# LÖVE2D

▸ Bundle .love with runtime
▸ Use love-12.0 runtime
▸ love.graphics.scale for pixel art
▸ love.audio for chiptune

// PORT.JSON TEMPLATE

{
  "title":    "My Game",
  "desc":     "Description of the port",
  "author":   "Your Name",
  "version":  "1.0",
  "runtime":  "sdl2_20",
  "req_arm":  true,
  "req_gl":   true
}

// RESOURCES

$ cat resources.txt
▸ PortMaster: portmaster.games
▸ Docs: github.com/PortsMaster/PortMaster-Info
▸ Discord: discord.gg/portmaster
▸ Runtimes: SDL2-2.28 / Godot 4.2 / LÖVE 12.0
▸ Tools: gptokeyb (keyboard mapping), squashfs-tools (bundling)