Glk meets Emscripten


Keywords
interactive fiction, interactive-fiction, emscripten, glk
License
GPL-2.0
Install
npm install emglken@0.5.3

Documentation

Emglken: Glk meets Emscripten

Over the years many Interactive Fiction interpreters have been written which use the Glk API, or have been adapted to do so. Emglken takes some of these interpreters, compiles them to use the RemGlk-rs Glk library using Emscripten, and then outputs to Javascript and WebAssembly. These interpreters, which once needed to be compiled for each distinct operating system and CPU combination, can now be run anywhere there's a modern Javascript runtime: on the web with Parchment, in desktop apps like Lectrote, or in Node.js directly.

Emglken itself has almost no code at all; this project basically just takes care of compiling all the pieces together with the right settings, as well as providing a common JS interface to handle setting up the connections between each interpreter and GlkOte.

npm package and console app

Emglken has been published to the npm package repository. You can install the emglken package and use each interpreter as you wish. A basic console app is also provided, just run emglken with the path to the storyfile you want to run.

emglken storyfile.gblorb

Included Projects

Emglken, RemGlk-rs and AsyncGlk (used by the console app) are MIT licensed, as are some of the interpreters, but others are licensed under other Free Software licenses as listed below.

Name Upstream repo License
AsyncGlk curiousdannii/asyncglk MIT
Bocfel garglk/garglk GPL-2.0/GPL-3.0
Git DavidKinder/Git MIT
Glulxe erkyrath/glulxe MIT
Hugo hugoif/hugo-unix BSD-2-Clause
RemGlk-rs curiousdannii/remglk-rs MIT
Scare garglk/garglk GPL-2.0
TADS tads-intfic/tads-runner GPL-2.0