sonic-pi README

The project's README from github.com/sonic-pi-net/sonic-pi. As one markdown file: README.md.

                                       ╘
                                ─       ╛▒╛
                                 ▐╫       ▄█├
                          ─╟╛      █▄      ╪▓▀
                ╓┤┤┤┤┤┤┤┤┤  ╩▌      ██      ▀▓▌
                 ▐▒   ╬▒     ╟▓╘    ─▓█      ▓▓├
                 ▒╫   ▒╪      ▓█     ▓▓─     ▓▓▄
                ╒▒─  │▒       ▓█     ▓▓     ─▓▓─
                ╬▒   ▄▒ ╒    ╪▓═    ╬▓╬     ▌▓▄
                ╥╒   ╦╥     ╕█╒    ╙▓▐     ▄▓╫
                           ▐╩     ▒▒      ▀▀
                                ╒╪      ▐▄

             _____             __        ____  __
            / ___/____  ____  /_/____   / __ \/_/
            \__ \/ __ \/ __ \/ / ___/  / /_/ / /
           ___/ / /_/ / / / / / /__   / ____/ /
          /____/\____/_/ /_/_/\___/  /_/   /_/

Code. Music. Live.

Sonic Pi is a new kind of musical instrument. Instead of strumming strings or whacking things with sticks - you write code - live.

Sonic Pi has been designed with the aim to find a harmonious balance between three core principles:

Sonic Pi is a complete open source programming environment originally designed to explore and teach programming concepts within schools through the process of creating new sounds.

In addition to being an engaging education resource it has evolved into an extremely powerful and performance-ready live coding instrument suitable for professional artists and DJs.

Whilst Education is a core focus it now sits at the intersection between three core domains:

Again, finding a balance working to the best benefits of all these domains is the objective.

Contributors

Sonic Pi has been developed with support from many individuals and organisations. Please see the CONTRIBUTORS.md file for a more complete list.

Translations

Sonic Pi's application and built in tutorial have been translated into several languages thanks to the awesome work of several volunteer translators:

Status Language Application Tutorial
Translation Status of Sonic Pi: da Danish :white_check_mark: :red_circle:
Translation Status of Sonic Pi: nl Dutch :white_check_mark: :white_check_mark:
Translation Status of Sonic Pi: fi Finnish :white_check_mark: :red_circle:
Translation Status of Sonic Pi: fr French :white_check_mark: :white_check_mark:
Translation Status of Sonic Pi: de German :white_check_mark: :white_check_mark:
Translation Status of Sonic Pi: hu Hungarian :white_check_mark: :red_circle:
Translation Status of Sonic Pi: is Icelandic :white_check_mark: :red_circle:
Translation Status of Sonic Pi: it Italian :white_check_mark: :white_check_mark:
Translation Status of Sonic Pi: ja Japanese :white_check_mark: :white_check_mark:
Translation Status of Sonic Pi: nb Norwegian Bokmål :white_check_mark: :white_check_mark:
Translation Status of Sonic Pi: pl Polish :white_check_mark: :white_check_mark:
Translation Status of Sonic Pi: pt Portuguese :red_circle: :white_check_mark:
Translation Status of Sonic Pi: ro Romanian :white_check_mark: :white_check_mark:
Translation Status of Sonic Pi: ru Russian :white_check_mark: :white_check_mark:
Translation Status of Sonic Pi: zh_Hans Simplified Chinese :white_check_mark: :red_circle:
Translation Status of Sonic Pi: es Spanish :white_check_mark: :white_check_mark:
Translation Status of Sonic Pi: si sinhalese :white_check_mark: :red_circle:
Translation Status of Sonic Pi: tr_TR Turkish :white_check_mark: :red_circle:

Would you like to contribute a translation too? If so, please take a look at our translation docs to get started.

Information for developers

Sonic Pi is under active development, and welcomes new contributors:

Weblate
Travis CI

sonic-pi (sonic-pi-net/sonic-pi)

Searching Database…

12.2K ·GitHub
What is this?Sonic Pi is a free, open source programming environment where you write and live-edit code to create and perform music, originally built to teach coding in schools but now also used by professional artists and DJs for live performances.
Is this a music app with buttons, or do I actually write code to make sound?It is a code editor and runtime built around its own live-coding language: you type statements that trigger synths and samples, run them, and keep editing while the music plays, rather than clicking pre-made controls.
How do I get Sonic Pi running?You install a build for your platform (Linux, Mac, Windows, or Raspberry Pi) and open the app, which comes with its own built-in editor and tutorial.
Is setup the same on every platform?No, each platform has its own separate build/install path in the docs (Linux, Mac, Windows, Raspberry Pi), so there isn't one universal install command described.
Is this just a toy for kids, or can serious musicians use it on stage?Both: it's designed to be simple enough for a curious 10-year-old to learn programming, but also powerful and stable enough for professional artists and DJs performing live.
Is Sonic Pi actually free to use?Yes, it's described as a complete open source programming environment with no costs or paid tiers mentioned anywhere in the README.
Has Sonic Pi been translated for non-English speakers?Yes, volunteer translators have localized the app and/or its built-in tutorial into many languages, including French, German, Japanese, Russian, Spanish, and Simplified Chinese.
What's the educational angle behind Sonic Pi?It was created to teach programming concepts in schools by letting students create music instead of abstract exercises, and the project links out to dedicated computing and music education resources for teachers.
Size
456.3 MB
Stars
12.2K
Age
13y
Commits · 90 Days