Skip to content

Roadmap ​

Everything that is planned or known to be missing, in one place. What already shipped is in the CHANGELOG; larger items have a design document in design/ with the details and a phased plan.

Nothing here is promised or scheduled. ABI additions keep GASM_ABI_VERSION at 0 (older runners trap only if a guest calls something they lack, see Versioning); breaking changes would bump it.

Next up ​

The suggested order, from the most benefit for the least risk:

Done recently: stack switching (gasm_run, design/stack-switching.md), cooperative threads in C, POSIX, SDL 3 and Rust, and real threads (wasi-threads) natively and in browsers, Godot's worker pool included (design/threads.md), gasm:gl on every runner (design/gasm-gl.md), Godot 4.7 (guests/godot), HTTP requests (gasm:fetch, design/fetch.md), the splash screen, OpenGL ES through SDL 3, a guest memory limit, and since 0.10.0: the clipboard (gasm:clipboard, F2 copies the frame), saving files for the player (gasm:files), player consent for hosts and saves, Godot multiplayer (WebSocketPeer on gasm:net) and a smaller engine for 2D games; since 0.11.0 mods and the capabilities manifest.

  1. Opening files (Runtime and ABI): the other half of gasm:files, a picker run by the runner.
  2. .gasm packages (Runtime and ABI): one file with the game, its assets and its manifest.
  3. Godot, the rest (Godot): Jolt, TLS and Crypto.

Runtime and ABI ​

ItemWhat it givesStatus
Stack switching beyond JSPIBrowsers without JSPI (and Node 22) still need the Asyncify builds; wasm's stack-switching proposal would cover them too.waiting on engines
Asynchronous decompressionA runner call that unpacks a compressed block (zstd, deflate) outside the game and hands it over at the next frame: faster loading on every runner, threads or not.not started
.gasm packagesOne file bundling game.wasm, its assets and a manifest.not started
gasm:media: DNS rebindingNatively the private-address check resolves the host before connecting, but the HTTP client resolves it again: a resolver of our own for it (ureq's is unversioned API) would close that gap. HLS streams are an idea, not planned. design/media.mdnot started
Gamepad rumble and force feedbackEffects for gasm_gamepad slots (the Gamepad API's vibrationActuator in browsers, SDL-style rumble natively): DirectInput ports have force feedback with nothing to map it to.idea
Opening files (gasm:files)A file picker run by the runner (importing a map, a replay): the game only sees what the player picks. Saving for the player already works (gasm:files.save).not started
Asking before a savegasm-run writes a game's saves to a default folder (or --save-dir, or refuses them with --no-save); a native save dialog for each would let the player pick the place.idea
WIT / Component ModelMove the ABI to WIT once browsers don't need transpiling for components.waiting on browsers

Graphics ​

ItemWhat it givesStatus
gasm:gl on WaylandANGLE draws into X11 windows, so gasm:gl games use XWayland on Wayland desktops.not started
gasm:gl on SwiftShader on macOS--gl-software needs a Vulkan loader there (Electron doesn't ship one); Metal is always available, so it only matters for tests.not planned
ANGLE built from sourceThe libraries come from Electron 43, the last release that ships them as separate files; a newer ANGLE means building it (depot_tools) or another distribution.when needed
Copying gasm:gfx frames nativelygasm-run's copy key (F2) copies 2D and gasm:gl frames; WebGPU games draw straight to the window's surface, which can't be read back yet (the web player copies them).not started
glow upstreamRust GL code runs on a fork of glow (sdk/glow: its native backend on wasm32), used through [patch.crates-io]. Upstream support (a loader-based backend on wasm32-unknown-unknown) would make the patch unnecessary.idea
A display scaleGuests only see drawable pixels, so UI code guesses a scale (the egui demo uses the drawable height). A gasm.display_scale() import would give the real one.idea
gasm:gfx render targetsRender-to-texture.not started
Temporal upscaling (gasm:upscale)3D gasm:gfx games render at a lower resolution and the runner upscales from colour, depth and motion vectors: a portable FSR 2 port everywhere, and natively MetalFX or DLSS where the player's machine has them (DLSS never shipped, only found). Needs render targets first. design/upscale.mdproposal
gasm:gfx cube maps, render bundlesSkyboxes and environment maps; cheaper repeated draws.not started
Batched gfx commandsOne call per frame for draw-heavy guests instead of one per command.not started
More of WebGPUStorage textures, compute, stencil: not in the gasm:gfx subset and not planned yet.not planned

Presentation (2D frames) ​

The filters, integer scaling, display aspect and window titles shipped in 0.6.0 (design/presentation.md). Left over:

ItemWhat it givesStatus
mmpx, scalefx filtersMore pixel-art upscalers. xbr covers the same content; both need porting from their reference sources, and ScaleFX's license needs checking.declined for now
Content hintA guest suggests a filter class ("pixel art" or "rendered") so players can pick a better default. One more small ABI addition.idea
fps counter behind a flagThe native window title shows — <n> fps always.idea

Mobile ​

ItemWhat it givesStatus
gasm in mobile browsersThe player on phones and tablets: fullscreen (the Fullscreen API where it exists, an installable page for iOS, which only allows it for video), a layout for portrait and landscape with an orientation lock while playing, audio unlocked by the first tap, and on-screen touch controls (a virtual gamepad mapped to the pads, plus the keys a game asks for). Also checking what mobile browsers lack: WebGPU and JSPI on some (gasm:gl and the Asyncify builds cover them), and the memory a page may use (iOS gives less than the 1 GiB default limit).not started
Touch in the ABISeveral fingers at once: today the raw pointer is one mouse, so touch screens only drive it with the first finger. Touches as their own input (id, position, pressure, began/moved/ended), in both runners and for the touch controls above; Godot's touch events (see Godot) and SDL's would come from it.not started
Native runners on Android, iOS and iPadOSgasm-run as an app: wasmtime with wgpu (Vulkan, Metal) and ANGLE for gasm:gl, touch controls on screen, gamepads (Android's input API, Apple's Game Controller framework), and games picked from the device. Apple's systems allow no runtime code generation, so games there would be compiled ahead of time into the app (or run on wasmtime's interpreter); Android can use the JIT. Game files, saves and mods in the app's storage. One Apple app could cover iPhone, iPad and Apple TV.not started
gasm on Apple TV (tvOS)The same app on the TV, with its differences: no web browser at all (only the native runner), no touch screen (the Siri Remote as a pad, game controllers for real play), no JIT (ahead-of-time compiled games, as on iOS), little local storage that's guaranteed to last (saves would go to iCloud), and games shipped inside the app. Needs wgpu's and ANGLE's tvOS support checked; gasm:gfx and gasm:gl run on Metal there.not started

Netplay ​

ItemWhat it givesStatus
Rollback netplayRun by the runner: snapshot and restore guest memory between frames (the runner already drives frames and owns the guest's state), instead of lockstep only.not started

Games and ports ​

SDL 3 ​

What SDL 3 for gasm doesn't do yet, and what would bring it:

MissingWhat it takes
Desktop OpenGLnot planned: OpenGL ES on gasm:gl works (SDL3::GL)
SDL_GPU, VulkanSDL_GPU on gasm:gfx (WebGPU) would be a new GPU driver for SDL; not started
Audio recording, camera, haptics and rumble, sensors, dialogs, tray, processes, shared objectsnot planned; each fails the way SDL fails on a platform without it

ScummVM ​

What works is in the ScummVM README. Not done yet:

MissingEffectWhat it takes
Other enginesonly the five built in: scumm, scumm_7_8, he, sky, drasculaadd them to SCUMMVM_ENGINES (+ engine data); the freeware Flight of the Amazon Queen (queen) and Lure of the Temptress (lure) are next, then Sierra (agi, sci), kyra, gob, saga, sword1/sword2, tinsel
MT-32 emulationRoland MT-32 music (many Sierra and LucasArts games sound best with it)--enable-mt32emu (built into ScummVM) and the user's MT-32 ROMs as assets
General MIDI synth (FluidSynth/fluidlite)GM music; AdLib is used insteadbuild fluidlite, ship or load a SoundFont
GUI themesthe built-in classic look ("scummremastered" and gui-icons.dat aren't embedded)embed the theme zip and icons (zlib is in now)
Translations, TTS, FreeType, fribidiEnglish GUI, no speech synthesis, no TrueType fonts (some engines need them)build the libraries, embed translations.dat
Video codecs (MPEG-2, Theora, VPX, AAC, JPEG, PNG)cutscenes and images in engines that use thembuild the libraries
3D engines (Grim Fandango, Myst III, The Longest Journey)not builtTinyGL (software 3D) now, or gasm:gl later
Cloud, LAN, networkingoffgasm:net could carry some of it
Gamepads 2–4, touch controls, virtual keyboardone gamepad; mouse and keyboard otherwisebackend work
Size in browsers without JSPIthey need the 16.1 MB Asyncify build (the run build is 10.6 MB)JSPI in more browsers

Godot ​

Godot 4.7 runs (Compatibility renderer, GDScript, 2D and 3D physics, audio, input, saves: guests/godot). Left over:

ItemWhat it givesStatus
Jolt physicsJolt doesn't recognize WASI targets (its platform and SIMD detection); a patch like its Emscripten support. Godot Physics 3D is used meanwhile.not started
TLS, Cryptombedtls needs a time source (mbedtls_ms_time, timing.c) for WASI.not started
Godot as a WebSocket serverWebSocketPeer and WebSocketMultiplayerPeer work as clients on gasm:net (a relay room, or a Godot server outside gasm); a game can't host (create_server), and ENet and UDP need sockets browsers don't have.not planned
Complex textThe advanced text server (ICU, HarfBuzz: right-to-left, ligatures) instead of the fallback one; larger.not started
TouchGodot's touch events (InputEventScreenTouch, drags) from gasm's touches, once the ABI has them (Mobile).not started

Testing and tooling ​

ItemWhat it givesStatus
Filter parity in CIscripts/present-test.mjs (native vs WebGL 2 filters, golden images) skips without a GPU; CI's Linux runner would need a software Vulkan driver (lavapipe).not started

MIT licensed. The NES demo core is tetanes-core (MIT/Apache-2.0).