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

Release history Release notifications

This version
History Node


History Node


Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
spexcript-0.3.tar.gz (16.8 kB) Copy SHA256 hash SHA256 Source None Apr 27, 2017

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page