Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

█ Blackout █

For NaNoGenMo 2016.

Blackout generates pages of text from book or newspaper scans in the style of Newspaper Blackout Poetry, popularized by Austin Kleon (related to work like A Humument by Tom Phillips).

Blackout does the following:

  1. Take, as input, an image of text, from a newspaper or book.
  2. Run OCR against the image, identifying the words and their bounding boxes.
  3. Feed the extracted text into a natural language parser, categorizing each part of speech.
  4. Given one of many randomly selected Tracery grammars, select words from the current page that match the parts of speech of that grammar.
  5. Draw around those words and "scribble" out all other text on the page image.
  6. Output the final page as a new image.

Pen width, line length, line direction, number of strokes, and stroke opacity are all randomly fuzzed. The pen color is always black, except in rare cases it is blood red.

Blackout has produced two creative works: "The Days Left Forebodings and Water" (this one), and was modified by @samplereality for use in producing "A Great Intimate Unmistakeable More"

"The Days Left Forebodings and Water"

The source material is A Vindication of the Rights of Women by Mary Wollstonecraft (1792).

Read The Days Left Forebodings and Water. 45 pages long, consists of entries that were generated randomly, but hand-picked and ordered on November 9, 2016.

(The full NaNoGenMo entry of ~50,000 words was a [9.3GB PDF] of nearly 10,000 pages. If for some reason you want it, just ask.)


No releases published


No packages published