curiousdannii/parchment

The Interactive Fiction web app

Parchment

Parchment is the Interactive Fiction player for the web. To play a story with Parchment go to https://iplayif.com!

Parchment is made with the support of a grant from the Interactive Fiction Technology Foundation.

Parchment for Inform 7

Inform 7 includes Parchment, allowing you to produce personal websites for your stories. If you want to update the version of Parchment used by Inform 7, get it from the releases page and unzip it into the Templates subfolder of your project's Materials folder.

Site Generator

For those who aren't using Inform 7 (or who can no longer recompile their storyfile), the Parchment Site Generator allows you to make a single file version of Parchment. This supports any of the formats supported by Parchment (Adrift 4, Glulx, Hugo, TADS 2/3, Z-Code).

Single File Build

Parchment is also available as a single file, suitable for downloading and using offline. Download from the releases page.

Free Software

Parchment is MIT licensed, and incorporates the following upstream projects:

Name	Upstream repo	License
AsyncGlk	curiousdannii/asyncglk	MIT
Bocfel	garglk/garglk	GPL-2.0/GPL-3.0
Emglken	curiousdannii/emglken	MIT
Git	DavidKinder/Git	MIT
GlkOte	erkyrath/glkote	MIT
Glulxe	erkyrath/glulxe	MIT
Hugo	hugoif/hugo-unix	BSD-2-Clause
Iosevka	be5invis/Iosevka	OFL
jQuery	jquery/jquery	MIT
Quixe	erkyrath/quixe	MIT
RemGlk	erkyrath/remglk	MIT
Scare	garglk/garglk	GPL-2.0
TADS	tads-intfic/tads-runner	GPL-2.0
ZVM	curiousdannii/ifvms.js	MIT

Building Instructions

Parchment is only designed for building in Linux and may not work in other OSes. You'll need to install Git and Node version >= 16.

The upstream projects are included as git submodules. Start by initializing the submodules:

git submodule update --init --recursive

Then install the npm dependencies:

npm install

This will also automatically build Parchment.

Then, you'll need to open index.html on a web server. (It won't work when you run it on your filesystem as a file:/// URL.) You can launch a simple web server like this:

npm start

Then you can view Parchment at http://localhost:8080 to see your handiwork.

Each time you change code in the src folder, the server will automatically rebuild the web code. Refresh to see your changes.

You can also build your own dist/inform/parchment-for-inform7.zip like this:

npm install
npm run inform7