User Tools

Site Tools


This is an old revision of the document!


Entwine is a tool that makes building large stories with Twine 2 easier. It's a good fit if you would like to:

  • Combine multiple stories in Twine into one single story
  • Include many external resources with your story – i.e. images, video, or audio
  • Edit CSS or JavaScript files from an external editor, instead of using Twine's built-in one

Entwine is a command-line tool that integrates with Grunt, which is a tool that automates repetitive tasks. If you don't have experience with Grunt or the command line, this can feel intimidating. It will take some setup work to use Entwine, but this document will guide you through it, and once you're done, your project will be able to build itself automatically as you make changes to its sources. That is, you'll be able to edit an image or change a passage and your project will automatically rebuild without you having to even choose Publish to File in Twine. For large projects, this tradeoff can be worth it.

This document assumes you want to use Entwine with Grunt. It's also possible to use Entwine on the command line by itself, if you're experienced with writing shell scripts. If you'd like to do this, follow the directions for installing Node below, then run npm install -g twine-utils. After that completes, running entwine –help will acquaint you with the direct command-line interface, and the Grunt Entwine task's documentation also provides more information as to what the options do.

There is no Entwine plugin for Gulp or Brunch, other popular tasks runners in the Node ecosystem.

entwine.1462980096.txt.gz · Last modified: 2017/10/09 20:37 (external edit)