Spiner

Spiner

Spiner is a tool that allows you to easily author you own Choose Your Own Adventure books using Twine 2. It transforms your published Twine story into EPUB ebook that you can read on modern e-reader.

Get Started    Guides

Spiner has to treat images differently than Twine because EPUB is an offline format. That means Spiner will have to download all the images and publish them along with your story inside the EPUB file.

Local images

If you include an image referring to a file on your local machine, Spiner will make sure to copy that file into your EPUB.

📘

Use the desktop version of Twine to see local images

Due to security reasons most modern browsers do not show local images when using the browser version of Twine. Although they will still be included in the EPUB, it is recommended to use the desktop version to make playtesting easier.

![](file:///home/mrombout/Pictures/example.png)

Online image

If you include an image referring to an online file, Spiner will download that image and copy it into your EPUB file.

![](https://raw.githubusercontent.com/mrombout/Spiner/develop/FrontEnd/src/main/resources/icon.png)

Base64 image

If you include an image as a specially encoded base64 image, Spiner will include that image data as an image in your EPUB.

📘

What is base64?

Base64 is a way to convert binary data (all the 0's and 1's) into text that is natively understood by browsers and e-readers.

![](data:image/png;base64,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)

Updated 2 months ago

Images


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.