Skip to main content

Spexcript -- easy layout for theater scripts

Project description

SpeXcript – makes your spex script beautiful

SpeXcript is a markup and layout system for scripts of theater plays or musicals etc. I originally made it for Fyysikkospeksi, a spex made every other year by mostly Engineering Physics undergraduate and graduate students at Aalto University. For now, it has only been for our internal use, but I am now (2015) releasing it for free and as open source. It would make me happy if someone else finds this useful.

Any feedback or suggestions are very welcome:

Getting Started


  • Python 3.4 (May work with older versions, but no official support)


spexcript can be installed with pip (make sure you have it installed):

$ pip install spexcript

or directly from the source code:

$ git clone
$ cd spexcript
$ python install

Basic Usage

The documentation for the markup language itself is on its way, but if you have a spexcript file, say myspex.sxt, you can lay it out as pdf from the command line as follows:

$ python -m spexcript myspex.sxt

The interface and documentation will be further improved in the future.


0.3.0 (2017-04-27) – SpeXcript

  • Improve command-line interface

  • Cleaner pdftex operation from user’s perspective

  • Spexcript succeeds even with empty source file

  • Minor refactoring

  • Filter out unwanted characters that can mess up typesetting

0.2.0 (2015-06-17) – SpeXcript

  • Rebranded as SpeXcript

  • Python 3 compatibility (3.4)

  • Added @mentions with expanded names

  • Bugfixes

  • Refactoring

  • Open sourced

spextex 2 (2013)

  • Rewrote and redesigned C and bash parts, now in Python 2.7

  • Revised and more extensible syntax

  • Some original features still missing

  • Integrated version control removed (use your favorite existing VCS)

  • More customizability for different layouts and languages

spextex 0.0-1.0 (2007-2012)

  • Original version written in C, bash scripts and LaTeX for Fyysikkospeksi

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

spexcript-0.3.tar.gz (16.8 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page