Music Blocks is a fork of Turtle Blocks. It has extensions for exploring music: pitch and rhythm.
Music Blocks is designed to run in a browser. Most of the development has been done in Chrome.
| Browser | Comments |
|---|---|
| Chrome | Supported |
| Safari | Supported |
| Firefox | Supported |
| Opera | Supported |
| IE | Not supported |
| Edge | Recent versions supported |
You can run it from https://musicblocks.sugarlabs.org.
- Getting Started
- Toolbars
- Context Menu
- The Block Context Menu
- Keyboard Shortcuts
- Block Palettes
- Flow Palette
- Widget Palette
- Stats
- Planet View
When you first launch Music Blocks in your browser, you'll see a stack
of blocks representing the notes: Sol 4, Mi 4and Sol 4. The first two notes are 1/4 note; third note is
1/2 note. RUN LIVE
Try clicking on the Start block or click on the Play button. You
should hear the notes play in succession: Sol Mi Sol.
To write your own programs, drag blocks from their respective palettes on the left side of the screen. Use multiple blocks in stack(s) to create music and drawings; as the mouse moves under your control, colorful lines are drawn and music of your creation is played.
Note that blocks either snap together vertically or horizontally. Vertical connections indicate program (and temporal) flow. Code is executed from the top to bottom of a stack of blocks. Horizontal connections are used for parameters and arguments, e.g., the name of a pitch, the duration of a note, the numerator and denominator of a division. From the shape of the block, it should be apparent whether they connect vertically or horizontally.
Some blocks, referred to as "clamp" blocks have an interior—child—flow. This might be code that is run if a condition is true, or, more common, the code that is run over the duration of a note.
For the most part, any combination of blocks will run (although there is no guarantee that they will produce music). Illegal combinations of blocks will be flag by a warning on the screen as the program runs.
You can delete a block by dragging it back into the trash area that appear at the bottom of the screen.
To maximize screen real estate, Music Blocks overlays the program elements (stacks of blocks) on top of the canvas. These blocks can be hidden at any time while running the program.
There are five toolbars in Music Blocks, each serving a specific purpose to help you navigate and interact with the application. Below is a detailed description of each toolbar along with images to visually illustrate their functions:
The Main toolbar is located across the top of the screen. It contains several essential buttons for managing your project, controlling playback, and accessing various settings.
- Play Button: Starts playing the project.
- Stop Button: Stops the current project playback.
- New Project Button: Creates a new project from scratch.
- Load Project from File Button: Opens an existing project file.
- Save Project Button: Saves the current project.
- Find and Share Project Button: Opens the Planet view where you can explore and share projects with the community.
- Auxiliary Menu: Provides additional tools for project settings and configuration.
- Help Button: Opens the help menu, providing access to instructions and guidance.
The Secondary toolbar appears when you click the hamburger button (three horizontal lines) in the main toolbar. This toolbar provides several options to control the execution of your project and adjust your work environment.
-
Run Slowly: Executes the program slowly to allow you to follow the process step by step.
-
Run Step by Step: Runs the program one step at a time, ideal for debugging and analysis.
-
Merge with Current Project: Combines the current project with another, promoting collaboration and reusability.
-
Turtle Wrap: Enables wrapping of the turtle's position to seamlessly continue from the opposite edge of the canvas.
-
Set Pitch Preview: Lets users preview pitches while composing, providing instant feedback.
-
Restore: Resets changes and restores the project to its last saved state
-
Switch to Advanced Mode: Quickly transition from Beginner to Advanced mode for more tools and customization options.
1. Display Statistics: Provides insights into project performance, such as usage and execution metrics.
2. Load Plugin: Integrates external plugins to enhance functionality and extend features.
3. Delete Plugin: Allows the removal of plugins that are no longer needed.
4. Horizontal Scrolling: Enables horizontal navigation for easier handling of large projects.
5. JavaScript Editor: Includes an editor for writing and embedding custom JavaScript code.
6.Record: Adds a "Record" button to the main palette, enabling users to record their compositions directly. -
Select Language: Offers a multilingual interface, allowing users to change the language as per their preference.
The Palette toolbar is located on the left side of the screen. It contains various categories of blocks, such as numbers, media, and actions, which you can drag and drop onto the canvas to build your project.
The palette is dynamic, switching between different categories based on your selection. When you hover over the palette, it reveals the specific blocks related to your chosen category.
On the upper right of the canvas is a small toolbar with options for managing the workspace. It allows you to adjust the display and clear the canvas.
- Show Grids: Displays a grid overlay on the canvas for alignment and organization.
- Clear Screen: Clears the entire canvas, removing all blocks and drawings.
- Toggle Display Size: Adjusts the size of the canvas or blocks for a better viewing experience.
Located at the lower right of the canvas, this small toolbar provides additional control over block visibility and size.
- Home Button: Takes you back to the initial view or project start screen.
- Show/Hide Blocks: Toggles the visibility of the blocks you’ve added to the canvas.
- Expand/Collapse Blocks: Allows you to expand or collapse the view of blocks for better organization.
- Decrease/Increase Block Size: Changes the size of the blocks on the canvas to suit your preference.
When you right-click on a block, the following options are available:
- Extract: Detaches the selected block from its current position, making it a standalone entity.
- Move to Trash: Deletes the selected block by moving it to the trash.
- Duplicate: Creates an identical copy of the selected block for reuse.
- Help: Provides detailed information about the functionality of the selected block.
- Close: Closes the contextual menu.
When you right-click on the background, the following options are available:
- Grid: Toggles the display of a grid in the workspace for better alignment and organization.
- Set Pitch Preview: Adjusts and previews pitches while working on a composition.
- Enable Horizontal Scrolling: Allows horizontal navigation for easier management of large projects.
- Turtle Wrap Off: Toggles the turtle wrap feature, which determines whether the turtle wraps around the canvas edges.
- Restore: Reverts the workspace to its last saved state.
- Increase Block Size: Enlarges the size of all blocks for better visibility.
- Decrease Block Size: Shrinks the size of all blocks to save space.
- Expand/Collapse Block: Expands or collapses individual blocks to show or hide their details.
- Show/Hide Block: Toggles the visibility of selected blocks in the workspace.
- Home: Centers the workspace view on the initial starting point.
- Close: Exits the contextual menu.
- Search for Blocks: Opens a search bar to locate specific blocks within the workspace.
- Collapse: Collapses all blocks to their minimal state.
- Clean: Organizes and tidies up the workspace by aligning blocks systematically.
- Select: Enables selection mode for selecting multiple blocks or elements in the workspace.
Many blocks in Music Blocks also feature "pie menus" that allow you to change block parameters quickly by selecting options from a circular menu that appears when you hover over the block.
For further details on how to use these toolbars effectively, you can refer to the Turtle Blocks Documentation.
Context menus are an important part of user interfaces that provide users with quick access to a set of actions relevant to the context in which they are working.The right-click context menu in Music Blocks provides several options for working with blocks and the workspace. To access the right-click context menu, simply right-click anywhere in the workspace.
This context menu appears when you right-click on a block in the workspace. It provides options such as "Duplicate," "Delete," "Help," and "Copy to Palette." The "Duplicate" option creates a copy of the selected block, while the "Delete" option removes the selected block from the workspace. The "Help" option opens a help dialog for the selected block, and the "Copy to Palette" option adds the selected block to the user's custom block palette.
The "Extract" option in Music Blocks allows you to separate a nested block into its individual components or sub-blocks. This can be useful if you want to modify or reuse specific parts of a block without affecting the rest of the block.
This option creates a duplicate of the selected block and places it next to the original block.
This option removes the selected block from your program
This option shows a help screen with information about the selected block. You can use this option to learn more about the block's functionality and how to use it in your projects.
By using the right-click context menu in Music Blocks, you can quickly perform common tasks and manipulate blocks on the workspace. This can help you to work more efficiently and effectively in your projects.
There are several keyboard shortcuts:
PgUp and PgDn will scroll the screen vertically. This is useful for creating long stacks of blocks.
You can use the arrow keys to move blocks and the Delete key to remove an individual block from a stack.
Enter is the equivalent of clicking the Run button.
Alt-C is copy and Alt-V is paste. Be sure that the cursor is highlighting the block(s) you want to copy.
You can directly type notes using d for Do, r for Re, m for
Mi, f for Fa, s for Sol, l for La, and t for Ti.
The block palettes are displayed on the left side of the screen. These palettes contain the blocks used to create programs.
Looking for a block? Find it in the Palette Tables.
See the Turtle Blocks Programming Guide for general details on how to use the blocks.
See the Music Blocks Programming Guide for details specific to music: Rhythm, Meter, Pitch, Intervals, Tone, Ornament, Volume, Drum, and Widget.
All of the other palettes are described in the Turtle Blocks documentation pages.
At the heart of Music Blocks is the concept of a note. A note, defined by the Note value block defines a length of time and a set of actions to occur in that time. Typically the action is to play a pitch, or series of pitches (e.g., a chord). Whatever blocks are placed inside the "clamp" of a Note value block are played over the duration of the note.
The duration of a note is determined by its note value. By default, we
use musical notation, referring to whole notes (1), half notes
(1/2), quarter notes (1/4), etc., but you can use any number as
the note duration. (There are some practical limitations, which you
can discover through experimentation.) The relative length of a
quarter note is half as long as a half note. By default, Music Blocks
will play 90 quarter notes per second, so each quarter note is 2/3
seconds (666 microseconds) in duration.
The Pitch block (found on the Pitch Palette) is used to specify the
pitch of a note. By default, we use traditional western Solfege, i.e.,
Do, Re, Mi, Fa, Sol, La, Ti, where Do is mapped to
C, Re is mapped to D, etc. (when the key and mode are C Major). You can also specify pitch by using a note name, e.g.,
F#. An octave specification is also required (as an argument for our
pitch block) and changes integers for every cycle of C (i.e. C4 is
higher than B3). When used with the Pitch-time Matrix block, a row
is created for each Pitch block.
In addition to specifying the note name, you must also specify an
octave. The frequency of a note doubles as the octave increases. A2 is
110 Hertz; A3 is 220 Hertz; A4 is 440 Hertz; etc.
Two special blocks can be used with a Pitch block to specify the
name of the pitch: the Solfege block and the Pitch-Name block. The
Solfege block uses selectors to scroll through Do, Re, Mi,
Fa, Sol, La, and Ti. A second selector is used for sharps and
flats: ##, #, and. The Pitch-Name block is similar
in that it lets you scroll through C, D, E, F, G, A,
B. It also uses a second selector for sharps and flats.
As noted, and described in more detail in the Music Blocks Programming Guide, you can put as many Pitch blocks inside a note as you'd like. They will play together as a chord. You can also insert graphics blocks inside a note in order to create sound-sync animations.
The Set instrument block, found on the Tone palette, lets you choose a timbre for a note. In the above example, a guitar model is used to make any notes contained within the block's clamp will sound as if they are being played on a guitar. RUN LIVE
The Set synth volume block, found on the Volume palette, lets you
change the volume, which ranges from 0 (silent) to 100 (full
volume), of any notes contained with the block's clamp.
The Set drum block, which is used inside of the clamp of a Note value block is used to add drum sounds to a note. It is found on the Drum palette. RUN LIVE
The Repeat block, found on the Flow palette, is used to create loops. Whatever stack of blocks are placed inside its clamp will be repeated. It can be used to repeat individual notes, or entire phrases of music. RUN LIVE
The Duplicate block, found on the Rhythms palette, is used to
repeat any contained notes. Similar to using a Repeat block, but
rather than repeating a sequence of notes multiple times, each note is
repeated in turn, e.g. duplicate x2 of 4 4 8 would result in 4 4 4 4 8 8, where as repeat x2 of 4 4 8 would result in 4 4 8 4 4 8. RUN LIVE
The Start block, found on the Action palette, is tied to the Run button. Anything inside of the clamp of the Start button will be run when the button is pressed. RUN LIVE
Note that you can have multiple mice and that each mouse is equivalent to a "voice" in music. It can play notes of various pitches in sequence, and can even play multiple notes of the same "note value", but no one mouse can do counterpoint by itself—just like one mouse cannot draw two lines at the same time. If you want counterpoint, pull out an additional Start block, which will create a new mouse that can now perform a new voice.
The Action block, also found on the Action palette, is used to create a collection of blocks that can be run as a group. Whenever you create an Action block, a new block corresponding to that action is added to the palette. The name given to the action is the name associated with the new block. (It is common practice to use Action blocks to define short phrases of music that can be repeated and modified.) RUN LIVE
Actions are a powerful organizational element for your program and can be used in many powerful ways, e.g., an action can be associated with an event, such as an on beat or off beat or mouse click. See Music Blocks Programming Guide, for further details and examples.
The Store in block, found on the Boxes palette, is used to store a value. That value can be retrieved using the Box block. The value can be modified using the Add one block. These blocks are the typical way in which variables are stored and retrieved in Music Blocks. RUN LIVE
The Forward block, found on the Graphics/Mouse palette, is used to draw straight lines. (Note that if this block is used inside of a Note value block—the line will be drawn as the note plays; otherwise the line is drawn "instantly".) RUN LIVE
The Right/Left block, found on the Graphics/Mouse palette, is used to rotate the mouse heading. (Note that if this block is used inside of a Note value block—the heading will change as the note plays; otherwise the heading is changed "instantly".) RUN LIVE
The Pen up and Pen down blocks, found on the Pen palette, determine whether or not the mouse draws as it moves. RUN LIVE
The Set shade block, also found on the Pen palette, is used to set
the lightness or darkness of the "ink" used in the mouse pen. set shade 0 is black. set shade 100 is white. RUN LIVE
The Set color block, also found on the Pen palette, is used to set
the color of the "ink" used in the mouse pen. set color 0 is
red. set color 70 is blue. RUN LIVE
The Random block, found on the Numbers palette, is used to generate a random number, because sometimes being unpredictable is nice. RUN LIVE
The One of block, also found on the Numbers palette, is used to generate a binary choice, one of "this" or "that", because sometimes being unpredictable is nice. RUN LIVE
The Show block, found on the Media palette, is used to display text and images. RUN LIVE
The Mouse button block, found on the Sensors palette, returns true if the mouse button is clicked. The mouse button block can be used to create some interactivity in your program. RUN LIVE
The Cursor x and Cursor y blocks, also found on the Sensors palette, return the X and Y coordinates of the cursor. These blocks can also be used to create interactive programs.
Prompting the user for input is done with the Input block. This block will display a message with a prompt and open an input form at the current position of the mouse. Program execution is paused until the user types into the form and types RETURN (or Enter). The contents of the input form are then transferred to Input-value block. RUN LIVE
The Push and Pop blocks, found on the Heap palette, are used to store and retrieve values on/from a first-in, last-out (FILO) programx heap. There is a separate heap maintained for each Start block.
The Get value and Set value blocks are found on the Dictionary palette. They are used to get and set values in a dictionary object. You can have as many key/value pairs as you'd like in the dictionary and you can have as many dictionaries as you'd like as well. There is also a built-in dictionary associated with each Start block that has key/value pairs for parameters such as x, y, heading, color, shade, grey, pen size, notes played, current pitch, pitch number, and note value.
The Print block, found on the Extras palette, is used to print messages during program execution. It is very useful as a debugging tool and also as a means of adding lyrics to your music—think karaoke. RUN LIVE
The Flow palette is described in more detail in the Turtle Blocks documentation. Here we review a few ways to approach taking different actions on different beats.
The Switch block will take the action defined in the Case that matches the argument passed to the Switch block. In the figure below, it will take a different action based on the beat value: "on case 1 run action1", "on case 2, run action2", ..., "on case 4 run action4". You can also define a default action. RUN LIVE
Another way to do the same thing is with the Do block found on the Action palette. In the figure below, we add the beat count to "action" to create a series of strings: "action1", "action2", ..., "action4". We then "do" that action.
Music Blocks has various Widgets that can be used within Music Blocks to enhance your experience. The Pitch-time matrix is described here.
Many of the blocks on this palette are used to create a matrix of "pitch" and "note value". The matrix is a convenient and intuitive way for generating short musical gestures, which can be regenerated as a "chunk of notes" that can be played back programmatically. Musicians may find it helpful to think of the pitches within the pitch-time matrix as being akin to a bellset in which notes may be added and removed as desired. The "note value" representation acts as a "rhythmic tablature" that should be readable by both those familiar with the concepts of rhythm in music and those unfamiliar (but familiar with math).
Pitch-time Matrix blocks clamp is used to define the matrix: A row in the matrix is created for each Pitch block and columns are created for individual notes, which are created by using Rhythm blocks, individual note blocks, or the Tuplet block. RUN LIVE
The Rhythm block is used to specify a series of notes of the same
duration (e.g., three quarter notes or seven eighth notes). The number
of notes is the top argument; the bottom argument is the the note
duration, e.g., 1/1 for a whole note, 1/2 for a half note, 1/4
for a quarter note, etc. (Recall that in traditional Western notation
all note values are (1) in powers of two, and are (2) in relation to
the "whole note", which is in turn (3) defined by tempo, or
beats—usually quarter notes—per minute) Each note is
represented by a column in the matrix.
Special ratios of the whole note can be created very easily with the
Rhythm block by choosing an integer other than the traditional
"powers of two" that standard Western music notation affords us. For
example, putting a 1/5 into the argument for "note value" will
create a note value equal to "one fifth the durational length of a
whole note". This gives the user endless rhythmic possibilities.
As a convenience, blocks for the most common note values are also provided (whole note through 64th note). They are automatically converted into the corresponding Rhythm blocks, which can be used to create columns in the matrix.
If you would like multiple note values in a row, simply use the Repeat block clamp or Duplicate block clamp.
The Tuplet block is how we create rhythms that do not fit into a simple "power of two" rhythmic space. A tuplet, mathematically, is a collection of notes that are scaled to map into a specified duration. For example, if you would like to script/perform three unique notes into the duration of a single quarter note you would use the tuplet block. The Tuplet block is able to calculate how many notes you have inserted into the clamp and will generate the tuplet accordingly (e.g. if you put three notes in, it will generate a "triplet". We have designed the tuplet block to allow for any input of note value, so the triplet can be three quarter notes, three eighth notes, etc. This design choice allows for maximum flexibility) You can mix and match Rhythm and individual Note blocks within a Tuplet block to generate complex rhythms (e.g. two quarter notes plus an eighth note is possible within the tuplet). Each note is represented by a column in the matrix. RUN LIVE
Note: Each time you open the matrix, it tries to reconstruct the notes marked from the previous matrix. If you modify the Pitch and Rhythm blocks in the Pitch-time Matrix clamp, Music Blocks will try to make a corresponding change in the matrix.
Note: You can construct a matrix from a chuck of blocks by including the chunk in the clamp of the Pitch-time Marix block.
More details about all of the widgets are available in the Music Blocks Programming Guide.
Project statistics are available from a button on the secondary toolbar in advanced mode.
Music Blocks also provides a Planet view to find and share projects. It has options to load project from file locally and make new projects from scratch.
There are LOCAL and GLOBAL options to choose from. LOCAL lists the projects saved on your local machine. GLOBAL lets you explore projects shared by the community. You can filter these projects by tags such as Art, Math, Interactive, Design, Game, etc.
Projects are shown with a thumbnail image and a title. To get more details, click on thumbnail image. A short description is provided.
You can open a project in Music Blocks directly from the Planet or you can download.
