MUSIC BLOCKS
============

“All musicians are subconsciously mathematicians” – Monk

Music Blocks is a collection of manipulative tools for exploring
fundamental musical concepts in an integrative and fun way.

![alt tag](https://raw.githubusercontent.com/sugarlabs/musicblocks/master/screenshots/Screenshot-1.png)

![alt tag](https://raw.githubusercontent.com/sugarlabs/musicblocks/master/screenshots/Screenshot-2.png)

Using Music Blocks
------------------

Music Blocks is designed to run in the browser.

The easiest way to run Music Blocks is to open [Music Blocks](https://musicblocks.sugarlabs.org) in your browser (Firefox, Chrome, and  Opera work best).

If you want to run Music Blocks offline, download (or git clone) this
repo and point your browser to the index.html file found in the
musicblocks directory on your local file system.

You can also run Music Blocks by setting up a local server.

Sugar users can run Music Blocks as an app embedded in the Browse
activity (See [Music Blocks
Embedded](http://activities.sugarlabs.org/en-US/sugar/addon/4804)) or
simply open Music Blocks in Browse.

See
[Using Music Blocks](http://github.com/sugarlabs/musicblocks/tree/master/documentation/README.md)
and
[Music Blocks Guide](http://github.com/sugarlabs/musicblocks/tree/master/guide/README.md)

Credits
-------

Music Blocks is a fork of
[TurtleBlocksJS](https://github.com/walterbender/turtleblocksjs)
created by Walter Bender.

Devin Ulibarri has contributed functional and user-interface
designs. Many of his contributions were inspired by the music
education ideas, representations and practices (e.g. aspects of
matrix, musical cups) developed and published by [Larry
Scripp](http://www.larryscripp.net/) with whom Devin studied at New
England Conservatory and for whom he worked at Affron Scripp &
Associates, LLC.

[Center for Music and the Arts in Education (CMAIE)](http://centerformie.org/)

[Music in Education](http://music-in-education.org/)

Some of the graphics were contributed by Chie Yasuda.

Much of the initial coding of the fork from Turtle Blocks was done by
Yash Khandelwal as part of Google Summer of Code (GSoC) 2015. Hemant
Kasat contributed to additional widgets as part of GSoC
2016. Additional contributions are being made by Tayba Wasim, Dinuka
Tharangi Jayaweera, Prachi Agrawal, Cristina Del Puerto, and Hrishi
Patel as part of GSoC 2017.

Many students contributed to the project as part of Google Code-in
(2015&ndash;16, 2016&ndash;17, and 2017&ndash;2018).

A full list of
[contributors](https://github.com/sugarlabs/musicblocks/graphs/contributors)
is available.

Reporting Bugs
--------------

Bugs can be reported in the
[issues section](https://github.com/sugarlabs/musicblocks/issues)
of this repository.

Contributing
------------

Please consider contributing to the project, with your ideas, your
music, your lesson plans, your artwork, and your code.

Programmers, please follow these general
[guidelines for contributions](https://github.com/sugarlabs/sugar-docs/blob/master/contributing.md).
