documentation-Estuary

Tutorials Home

Codework: Executable Code-Poetry

John Cayley’s categories include functional codeworks, which merge executable commands with creative writing. These works are both human-readable and computer-executable.

Cayley, J. (2006). Time code language: New media poetics and programmed signification.
In New Media Poetics: Contexts, Technotexts, and Theories, pp. 307-334.


πŸ”Ή Executable Code-Poetry in MEMORIAS

The code-poetry of Jessica A. Rodriguez, particularly her project MEMORIAS exemplifies executable code-poetry, blending Live Coding and Electronic Literature.

MEMORIAS is a web-based project featuring six executable codeworks, integrating natural languages (Spanish, English, Spanglish) with computing languages to generate audiovisual textures.


🌟 Codework Activity: Writing Executable Code-Poetry in Estuary

Level: Intermediate

🎯 Objective

Explore the intersection of computer language syntax and poetry by crafting an executable code-poem using JSoLangs in Estuary

πŸ’» Technologies

Estuary is a live coding platform for collaboration and experimentation with sound, music, and visuals in a web browser.

JSoLangs are small JavaScript programs [built with the peggyjs/peggy library] that transpile live-coded text into one or more of Estuary’s underlying languages (Ogborn, et al., 2021).

πŸ“– Reference: Ogborn, D., Littler, C., & Sicchio, K. (2021).
JSoLangs: Ephemeral esolangs in a collaborative live coding environment. CSDH/SCHN @ Congress - 2021 University of Alberta.


πŸ”Ή Step 1: Choose Your Live Coding Tool

JSoLangs allow you to create new poetic languages on top of Estuary’s existing live coding environments. First, choose one of the following tools:

πŸ’‘ Tip: Choose the tool that best fits your artistic or conceptual goals!


πŸ”Ή Step 2: Learn the Basics of Your Chosen Tool

πŸ“Œ Follow these tutorials to learn how your tool works:

Hydra

CineCer0

TydalCycles (MiniTidal)

πŸ“Œ Explore:
βœ… Identify basic commands & syntax that control visuals, text, or sound.
βœ… Modify example code to see how it changes the output.


πŸ”Ή Step 3: Create Your Executable Code-Poem

πŸ“– Follow this tutorial to learn how to create a JSoLang:
➑️ Estuary: Working with JSoLangs

Now, write a short code-poem that is both readable as text and executable in Estuary.

βœ… Use at least three syntax elements from your chosen tool.
βœ… Experiment with poetic structureβ€”play with rhythm, repetition, or glitch aesthetics.
βœ… Test & refineβ€”observe how syntax manipulation shapes meaning.

πŸ’Ύ Save your work in a separate file for future use in Estuary.


πŸš€ Final Thoughts

By engaging with executable code-poetry, you are blending programming logic with poetic language, transforming syntax into an expressive medium.

How does this experience change your perception of code, language, and creative writing?