Symphony Esolang

Symphony is an interpreted, stack-based esoteric programming language where source code is structured and performed as a musical score. This extension provides a development environment for writing, and executing Symphony files within VS Code.

The Symphony Language

Symphony operates on a time-based execution model where one line of code equals one beat. This ensures that the program logic remains synchronized with the musical rhythm.

The language utilizes a 3D instruction mapping system to define its 70 distinct instructions. The logic of a note is determined by three variables:

• Pitch (C–B): Sets the instruction category (e.g., Arithmetic, Stack Operations, I/O).
• Velocity: Selects the dynamic level (Pianissimo to Fortissimo).
• Duration: Determines the articulation (Staccato to Tenuto).

Extension Features

Syntax Highlighting

The extension provides specialized highlighting for Symphony's unique syntax. It distinguishes between musical notes, percussion tokens, and parameters such as instrument (i), velocity (v), and duration (d). Control flow elements like labels and jumps are also clearly identified to assist in navigating non-linear code.

Hover Information

Because the meaning of a note changes based on its velocity and duration, the extension includes a hovering system. Moving the cursor over a note displays the specific instruction mapped to that combination, preventing the need to consult the mapping table manually during development.

Code Snippets

Built-in snippets are included to accelerate the creation of common Symphony structures.

Integrated Execution

The extension adds a "Play" button to the editor title bar. When clicked, it invokes the Symphony interpreter to run the active file, allowing the user to hear the audio output and observe the stack operations in the terminal simultaneously.

Requirements

To use this project, ensure you have the following installed:

• Python 3.13 or higher.
• uv (Python Package Manager).