Ruby DSL for music live coding in the browser, you can play with it in the online editor
DISCLAIMER: This is pretty alpha, so use with care if you plan to use it for real performances... Otherwise have fun!
Chat is available in gitter: nega-sonic/Lobby if you have any questions/suggestions
You can use plain normal or midi notes
# playing a single note
play 42
# multiple notes
play 'E3', 42
# produces the same result as the above
play 'E3'
play 42
# Scales and chords (same as Sonic-pi)
play (scale :c, :major)
play (chord :d, :minor)
Under the hood we use a 'fixed' time for calculating notes durations, adding more notes or play
statements will make durations
shorter. This happens because each play
happens inside a cycle
. A cycle
's duration is around 3 seconds
# doing this
play 'E3'
play 42
# is the same as this
cycle do
play 'E3'
play 42
end
If you want to play notes at the same time then use multiple cycles
cycle do
play 'E3'
end
cycle do
play 42
end
With with_instrument
you can add a synthesizer and connect it with effects. Every instrument needs
to have a name (for performance reasons)
# The order of the effects will affect the final sound
with_instrument(:drums, synth: :membrane, fx: [:bit_crusher, :distortion]) do
# each instrument has its own cycle by default
play 30
play 64
end
# multiple cycles can be used here as well
with_instrument(:lead, synth: :am, fx: :freeverb, volume: 3) do
cycle do
play (scale :c, :major)
end
cycle do
play (scale :c, :pelog)
end
end
It is possible to modify the default values for effects, you can do this trough the fx
block. Options
for each effect are detailed in the Effects section.
drum_effects = fx do
bit_crusher bits: 3
distortion value: 1.3
end
with_instrument(:drums, synth: :membrane, fx: drum_effects) do
4.times do
play 30
play 64
end
end
:expand
for a longer duration. Integer value:every
plays every 'nth'. For example this:cycle(every: 3)
will play every third cycle. Integer value:sustain
reduce/augment the duration of notes. Float value between 0 and 1:probability
play or miss a note randomly. Float value between 0 and 1:humanize
boolean value
:membrane
Use it as drums:simple
:am
:fm
:duo
:mono
:metal
:pluck
:poly
Effects | Options |
---|---|
vibrato | :frequency , :depth |
distortion | :value |
chorus | :frequency , :delay_time , :depth |
tremolo | :frequency , :depth |
feedback_delay | :delay_time , :feedback |
freeverb | :room_size , :dampening |
jc_reverb | :room_size |
phaser | :frequency , :octaves , :base_frequency |
ping_pong_delay | :delay_time , :feedback |
auto_wah | :base_frequency , :octave , :sensitivity , :q |
bit_crusher | :bits |
chebyshev | :order |
pitch_shift | :pitch |
- Using
every
is pretty unstable at the moment, even more if you use it in combination withexpand
- Adding too much notes on a cycle causes the page to crash ( like doing
100.times do { play 30, 50, 60 }
) - Page crashes also when you have a lot of cycles and you hit the 'play' button to fast (fixing this soonβ’)
Bug reports and pull requests are welcome on GitHub at https://github.com/merongivian/negasonic.
The gem is available as open source under the terms of the MIT License.