To begin using Tweebox, extract the contents of the zip file you downloaded to a location of your choice and then run the application inside. The Windows version of the application is named tweebox.exe; the OS X one is just named Tweebox. You'll see an interface like this:

Initial Tweebox interface

Obviously, if you're using Windows, things will look a little bit different, but the layout should be the same. This window is a view onto your project. A project is a collection of source code files associated with a single story. You can have as many files as you'd like in a single project; you can have just one, too.

When you first start up Tweebox, it gives you an untitled, new project to work with. You may create new projects by choosing New Project from the File menu, and save the one you've been working with the Save Project and Save Project As... menu items. Tweebox project files end in the file suffix .twp.

You can only have one project open at a time in Tweebox.

On the left side of a project window is a list of source files in the current project. You can add to this list by clicking the Add button at the bottom of the list. To remove a file from the list, select it and then choose Remove Source File from the Project menu.

On the right side of the interface are options that affect how your story is published. Click the Set button beside the Save As field to set where your published story file will be saved. This file name you enter should end in .html or .html; if you forget to do this, Tweebox will correct your mistake.

The Story Format pull-down menu lets you choose what type of story to create. In almost all cases, you'll want to leave it set to Jonah.

When you're ready to build your story, choose Build Story from the Project menu. Once Tweebox finishes, it will open the completed story file in your Web browser.

The screenshot below shows a project with one source code file, ready to be built:

Filled-in Tweebox interface