Sonic Pi v3.2.0 Release Notes

Release Date: 2020-02-25 // about 4 years ago
  • 28th Feb, 2020 (view commits):

    โšก๏ธ After a long 2 years without updates, we are threaded with excitement to ๐Ÿš€ bring you Sonic Pi's first fully independent release. Sam Aaron's work ๐Ÿš€ on this release has been 100% supported by kind and generous donations from people on Patreon in addition to ๐ŸŽ funds raised by delivering talks, workshops and performances. Sam's work ๐ŸŒ has also been hugely assisted by many wonderful code and translation contributions both by members of the Core Team and by our growing ๐Ÿš€ international community of live coders. This release has truly been a community effort.

    So, what's new? This time there are no radical new features, instead we ๐Ÿ’… have a much more polished, accessible and stable version than ever before. ๐Ÿš€ (This release has been heavily battle-tested in many performances worldwide).

    ๐Ÿš€ This release is codenamed Tau - (an improved Pi).

    ๐Ÿš€ One of the core focusses of this release is accessibility. Tau ๐Ÿ‘ introduces support for screen readers. Previously the code editor was ๐ŸŽ invisible to the main screen readers on both macOS and Windows and this ๐Ÿ›  is now fixed. There is also an accessible menu bar and a new high contrast colour theme which is WCAG 2 level AAA compliant. Accessibility is very important to us - we acknowledge that this is only the beginning and we value and encourage feedback from users who have specific accessibility requirements that we are not directly meeting. We ๐Ÿš€ plan to improve our accessibility support where possible in every release going forward.

    ๐Ÿ Another aspect of accessibility is support for Windows devices with high resolution displays. Previously on certain displays font and icon sizes could be far too small, unreadable and out of proportion with the app in general. This has all been addressed with significant work on ensuring ๐Ÿ Sonic Pi looks great on a variety of monitors on both Windows and ๐Ÿš€ macOS. We believe that this release looks better and is more usable than ๐Ÿš€ any previous release.

    Tau features two beautiful new audio visualiser scopes - a spectrum scope showing the frequency content of the audio and a beautiful mirror stereo scope. These scopes have been contributed by Chris Maughan who ๐Ÿ has also been pivotal in improving and simplying the Windows build ๐Ÿ–จ process. We are hugely grateful for his contributions - thanks Chris!

    We have two fabulous new FX - a ping pong delay contributed by Ethan Crawford and an autotuner contributed by Xavier Riley. We hope you have as much fun playing with these as we have.

    ๐Ÿš€ Finally, this release has seen a significant improvement in ๐ŸŒ translation coverage - both of the GUI and the tutorial. We truly believe that this helps us achieve our mission of lowering the barrier to entry for a creative experience with code by helping more non-English speakers start their live coding journeys.

    Now, go and make some noise with code!

    ๐Ÿ’ฅ Breaking Changes

    • spread now produces identical patterns as in the Toussaint paper. Previously, some of the patterns had been shifted. Use the rotate: opt to match prior behaviour if required.
    • OSC cues now include the IP address and port number of incoming messages
    • MIDI cues now include the source information in the first part of the path with : separators to match the new OSC cue format.
    • The osc fn now forces all outgoing args to either be numbers or strings (binary blobs and timestamps are not supported at this point). If the value is neither a number or string, it is 'inspected' and the resulting description string is sent instead.
    • 0๏ธโƒฃ The default incoming OSC cues port is now 4560 as the previous value was registered on the Iana Service Name and Transport Protocol Port Number Registry. However, 4560 is currently free.
    • Constrain :flanger FX's feedback: opt to range 0->1. Values greater than 1 had the effect of increasing the amplitude which should be achieved via the amp: opt.
    • โž• Add arg checker for sample's hpf: opt which now ensures the value is not higher than 119 as values higher than this can cause bad noise artefacts.
    • ๐Ÿ‘Œ Improve sample's start:/finish:/onset:/slice: opt semantics. The start: and finish: opts for sample now work within the specified slice or onset. This allows you to easily play, say the first half of a given slice or onset by specifying a start: of 0 and a finish: of 0.5. Where both the slice: and onset: opts are specified, then the slice operates within the onset. Where the slice:, onset: and start:/finish: opts are all used, the start/finish operate within the slice which in turn operates within the onset. See the updated sample examples for more information.

    ๐Ÿ†• New Fns

    • eval_file evaluates the contents of the specified file inline in the current thread as if it was a function.
    • midi_sysex for sending MIDI sysex messages.
    • โž• Add new chain fn .notes which takes a ring of values and returns a new ring with each element treated as a note. This will leave numbers unchanged but will turn note names like :C1 to their corresponding MIDI note.

    Synths & FX

    • ๐Ÿ†• New FX ping_pong - delayed echo alternating between left and right channels.
    • ๐Ÿ†• New FX autotuner - Autotune/phase vocoder effect.
    • The gverb FX now checks to ensure that the room: opt is greater than or equal to 1.
    • ๐Ÿ‘ The piano synth now supports fractional notes such as 70.3

    GUI

    • ๐Ÿ†• New WCAG 2 level AAA compliant high contrast colour theme. This is especially suited for those with low vision.
    • ๐Ÿ†• New application menu and shortcuts.
    • ๐Ÿ†• New default icons which match the pro icon feel.
    • 2 new visualiser scopes - mirror stereo and spectrum.
    • ๐Ÿšš Move to simple numbered labels for buffers.
    • ๐Ÿ‘Œ Improve scaling of icons, text etc. on high DPI displays on Windows.
    • The version number is no longer placed in the initial comment of new empty buffers. This felt like a friendly thing to do, but can be confusing if a given buffer hasn't been used and the version was updated. This results in the buffer reporting the old version number that was used to create the buffer not the current version used to display it.
    • ๐ŸŒ Many, many translation improvements. Thanks to all the wonderful volunteers contributing to the translation effort: https://hosted.weblate.org/projects/sonic-pi/
    • 0๏ธโƒฃ Error pane height is now higher by default on all platforms and its height is correctly scaled on high DPI monitors.
    • ๐Ÿ’… Preference checkboxes are now similarly styled on all platforms.

    ๐Ÿ‘Œ Improvements

    • ๐Ÿ‘ Allow scale degrees over an octave and augmented/diminished degrees.
    • Calling .tick and .look on a normal array such as [1, 2, 3] will now automatically convert it to a ring first.
    • โž• Add docstring for the set fn.
    • โž• Add new article A.20 - Creative Coding in the Classroom as appeared in issue #9 of the Hello World magazine.
    • OSC messages are now sent from the external cue listening port. This allows OSC servers that reply directly back to incoming messages (such as SuperCollider) to be able to communicate back to messages sent from Sonic Pi.
    • Random fns now understand notes. For example rrand(:e1, :e2) will return a random frequency between E octave 1 and 2.
    • ๐Ÿ Windows can now detect sample onsets from samples stored in .flac and .ogg format in addition to arbitrary sample rates such as 48khz.

    ๐Ÿ›  Bugfixes

    • Further improve boot stability on Mac in the cases where audio input/output sample rates do not match (typically due to the use of bluetooth headsets). Audio inputs on macOS are now disabled by default unless we can definitely determine the audio rates are the same.
    • โช Revert synthdefs to original bytecode version. This fixes a regression in at least the :tb303 synth and possibly others. All synths should sound and behave as they did in v3.0.1.
    • ๐Ÿ›  Fix issue with scaling default opts. Previously it was possible that unspecified opts correctly fell back to the default value - however that default value wasn't scaled. Default values are now always scaled whether or not explicitly specified.
    • with_sched_ahead_time now correctly sets the schedule ahead time before running the block and returns the result of the block itself
    • When "Enforce Timing Guarantees" is selected, Sonic Pi wil no longer throw out of time warnings in 'real time' threads (specified using use_real_time).
    • ๐Ÿ–จ set and cue no longer print duplicate messages which was possible in some cases.
    • ๐Ÿ›  Fix time_warp examples which were incorrect and misleading.
    • ๐Ÿ‘Œ Improve pid handling on Linux. This should reduce the number of zombie processes accidentally generated.
    • The offset: opt for with_swing now matches documented behaviour.
    • Teach sample_duration to scale correctly.
    • ๐Ÿ›  Fix GUI bug which could result in a buffer stuck in the highlighted state after hitting Run.
    • Fix the on: opt when playing chords to work similarly across all notes in a given chord.
    • Stop defonce from being executed multiple times
    • Calling .take on an empty ring no longer results in infinite recursion but instead returns an empty ring.
    • Scope now has a minimum height.
    • ๐Ÿ Windows now supports sending and receiving OSC messages over the network to and from external machines.