Introduction To Sunvox
Introduction To Sunvox
1/38
What is SunVox
PDF version of this page
What is SunVox
SunVox is a small, fast and powerful modular synthesizer with pattern based sequencer (tracker). It is
a tool for those people who like to compose music wherever they are, whenever they wish. On any
device. SunVox is available for Windows, OS X, Linux, Maemo, Meego, Raspberry Pi, Windows Mobile
(WindowsCE), PalmOS, iOS and Android.
Key features:
modular interface;
powerful microtonal (ultra-chromatic) sequencer;
highly optimized synth algorithms, flexible architecture: SunVox works on a variety of devices with
different CPUs;
a lot of built-in modules (synths and effects) + ability to make very complex connections between
them;
support of 16/24/32bit WAV, AIFF and XI samples;
multitrack WAV export;
MIDI in/out/import/export;
XM (FastTracker) and MOD (ProTracker, OctaMED) import.
no special requirements.
Linux:
OS X:
x86_64 architecture;
Mac OS X 10.6.
Android:
Android 2.3.
iOS:
WarmPlace Wiki - http://www.warmplace.ru/wiki/
sunvox:manual_en http://www.warmplace.ru/wiki/doku.php?id=sunvox:manual_en
iOS 7.
libsdl1.2;
libosso1.
Meego:
ARM CPU;
libsdl1.2;
libasound2.
ARM CPU.
PalmOS:
ARM CPU;
PalmOS 5.0;
FOR T|T, T2 and ZIRE71 USERS: Please, install FHR (Fargo Heap Resizer) before running SunVox.
FHR page: http://fanoush.wz.cz/palm/fhr.html
Installing
Windows:
1. download SunVox for Windows (ZIP archive);
2. unpack this archive to any folder (your home directory or some external flash drive);
3. you will see the new directory sunvox after unpacking - open it, and go to the sunvox/win32
directory;
4. you will find several files in the win32 folder: sunvox.exe (full 32bit version) and
sunvox_lofi_console.exe (version with 16bit audio engine for slow devices); just lauch one of these
versions.
Linux:
1. download SunVox for Linux (ZIP archive);
2. unpack this archive to the home user directory (/home/username);
3. you will see the new directory sunvox after unpacking - open it, and go to the sunvox/linux_x86
(for 32bit Linux) or sunvox/linux_x86_64 (for 64bit Linux) directory;
4. you will find several files in the linux_xxx folder: sunvox, sunvox_lofi, sunvox_no_simd, etc.; just
use the most appropriate for your system;
5. in case of some errors: open Terminal, go to the sunvox directory (use cd command), enter chmod
a+x sunvox and then ./sunvox ; if still not working - copy all error messages from the Terminal
and send it to nightradio@gmail.com.
OS X:
http://www.warmplace.ru/wiki/
2015/10/02 19:38
3/38
What is SunVox
iOS:
Maemo:
1. download SunVox for Maemo (ZIP archive);
2. unpack it to any folder on your computer;
3. you will see the new directory sunvox after unpacking - open it, and go to the sunvox/maemo
directory;
4. you will find the sunvox (in deb format) in the maemo folder - just copy and install this file on the
Maemo device.
Meego:
1. download SunVox for Meego (ZIP archive);
2. unpack it to any folder on your computer;
3. you will see the new directory sunvox after unpacking - open it, and go to the sunvox/meego
directory;
4. you will find the sunvox (in deb format) in the meego folder - just copy and install this file on the
Meego device.
Windows Mobile (WinCE):
1. download SunVox for Windows Mobile (ZIP archive);
2. unpack it to any folder on your computer;
3. you will see the new directory sunvox after unpacking - open it, and go to the sunvox/wince
directory;
4. you will find the sunvox.cab file in the wince folder - just copy and install this file on the Windows
Mobile device.
PalmOS:
1. download SunVox for PalmOS (ZIP archive);
2. unpack it to any folder on your computer;
3. you will see the new directory sunvox after unpacking - open it, and go to the sunvox/palmos
directory;
4. you will find the following files in the palmos folder: sunvox.prc, sunvox_framebuffer.prc - just
copy one of them to the SD-card of your PalmOS device (PALM/Launcher directory);
5. insert the SD-card back to the PalmOS device and you will see that the SunVox is successfully
installed.
sunvox:manual_en http://www.warmplace.ru/wiki/doku.php?id=sunvox:manual_en
Linux
Supported
architectures
x86, x86_64
Maemo
ARM (armel)
(Linux)
Meego
ARM (armhf)
(Linux)
Raspberry Pi
ARM (armhf)
(Linux)
Sound
quality
Real-time
recording,
Multi-touch
MetaModule,
Vorbis player
32-bit
YES
13-bit
YES
13-bit
YES
32-bit, 13bit
YES
MIDI
IN, OUT,
Export, Import
IN, OUT,
Export, Import
IN, OUT,
Export, Import
IN, OUT,
Export, Import
IN, OUT,
Export, Import
Windows
x86
32-bit
YES
Windows
Mobile
ARM
13-bit
YES
Export, Import
x86, x86_64
32-bit
YES
IN, OUT,
Export, Import
OS X
Android
ARM, x86
iOS
ARM
PalmOS
ARM
GPIO
YES
YES
YES
YES
YES
YES
IN, OUT,
Export, Import
Export, Import
Some SunVox versions have the fixed point integer audio engine (4.12 bits). This means that you
actually will hear the 13-bit sound. Such versions are fast, but the cost of speed is slightly audible
quantization noise.
In spite of the 13-bit version noise, 32-bit WAV export may be with better quality due to the absence
of audio overflow.
Interface description
http://www.warmplace.ru/wiki/
2015/10/02 19:38
5/38
What is SunVox
First click on the Stop button - stop playing. Second click - reset all SunVox activity and switch the
engine to standby mode.
Keyboard shortcuts
Keys
SPACE
Q,W,E,R,T,Y,U,I.
CAPSLOCK or '~'
F1F8
SHIFT + )
SHIFT + (
WarmPlace Wiki - http://www.warmplace.ru/wiki/
Description
edit mode ON/OFF
notes
insert note OFF
set octave number
octave up
octave down
sunvox:manual_en http://www.warmplace.ru/wiki/doku.php?id=sunvox:manual_en
Keys
Description
TAB
go to the next track
SHIFT + TAB
go to the previous track
INSERT (or Command+I in OSX) insert an empty note and shift the content down
BACKSPACE
delete previous note and shift the content up
DELETE (or Fn+Backspace in OSX) delete current note
K
insert SP (Set Pitch) command
SHIFT + K
insert the Previous Track special command
CTRL + (
selection begin (pattern editor)
CTRL + )
selection end (pattern editor)
CTRL + Z
UNDO
CTRL + Y or SHIFT + CTRL + Z REDO
CTRL + X
cut
CTRL + C
copy
CTRL + V
paste
CTRL + M
paste and mix
CTRL + A
select all
CTRL + T
select track (pattern editor)
CTRL + D
duplicate / clone
CTRL + I
interpolate values (pattern editor)
CTRL + U
interpolate velocity (pattern editor)
CTRL + N
create a new module / create a new pattern
CTRL + R
randomize module controllers (routing)
SHIFT + DELETE
cut
SHIFT + INSERT
paste
SHIFT + '+'
transpose up (+1 semitone) (pattern editor)
SHIFT + '-'
transpose down (-1 semitone) (pattern editor)
SHIFT + ']'
transpose octave up (+12 semitones) (pattern editor)
SHIFT + '['
transpose octave down (-12 semitones) (pattern editor)
SHIFT + UP/DOWN/LEFT/RIGHT selection
SHIFT + MOUSE MOVING
module link/unlink
SHIFT + controller value changing write the value to the pattern
SHIFT + Touch Theremin play write the microtone (Set Pitch XXYY command) to the pattern
CTRL + O
load song
CTRL + S
save song
CTRL + B
save song to BACKUP.sunvox
CTRL + '+'
increase the edit step
CTRL + '-'
decrease the edit step
SHIFT + F9
record start/stop
F9
play/stop
F10
play from beginning
F11
play pattern
F12
stop
SHIFT + F12
go to beginning
http://www.warmplace.ru/wiki/
2015/10/02 19:38
7/38
What is SunVox
Basic concepts
Project
A few words about hex numbers. Memory locations and software in today's computers use the
hexadecimal (hex) number system which comprises sixteen distinct symbols, digits 0 - 9 and letters
A, B, C, D, E, F (or a - f) where the letters represent the numbers 10 - 15. For more detail on the
hexadecimal system please visit: http://en.wikipedia.org/wiki/Hexadecimal
Examples of hexadecimal numbers and its decimal equivalents:
WarmPlace Wiki - http://www.warmplace.ru/wiki/
sunvox:manual_en http://www.warmplace.ru/wiki/doku.php?id=sunvox:manual_en
00 = 0;
01 = 1;
09 = 9;
0A = 10;
0B = 11;
0C = 12;
0D = 13;
0E = 14;
0F = 15;
10 = 16;
11 = 17;
FF = 255
Pattern
Pattern is a group of simultaneously played tracks that represents some section of the SunVox
project.
Any pattern in the SunVox looks like this:
line track 0 track 1 track 2
000 event event event
001 event event event
xxx
http://www.warmplace.ru/wiki/
2015/10/02 19:38
9/38
What is SunVox
As you can see, an events contain several text/numeric columns (fields). All numbers in the
pattern are represented in HEXADECIMAL format.
Event format: NN VV MM CCEE XXYY
Lets see detailed description of each column in the event:
sunvox:manual_en http://www.warmplace.ru/wiki/doku.php?id=sunvox:manual_en
20 - note probability;
21 - note probability with random velocity;
22 - set controller value to the random number from 0000 to XXYY;
23 - set controller value to the random number with range from XX (00..FF) to YY (00..FF);
30 - stop playing the song;
405F - delay an event for selected fraction of the line (from 40 (0%) to 5F (100%));
XXYY - parameter of a selected effect/controller (0000 - min; 8000 - max).
VV
10
20
30
40
50
60
MM
03
------
CCEE
0000
0000
0000
0000
0000
0000
XXYY
0000
0000
0000
0000
0000
0000
VV
----------
MM
01
01
01
01
01
01
01
01
01
CCEE
0200
0200
0200
0200
0200
0200
0200
0200
0200
XXYY
0000
1000
2000
3000
4000
5000
6000
7000
8000
http://www.warmplace.ru/wiki/
2015/10/02 19:38
11/38
What is SunVox
Pattern effects
01 - Slide up (Portamento Up). This effect will slide up the frequency of the synth being played on
the track by XXYY (one semitone = 40) tones for every tick. If a slide rate is not specified (XXYY is
zero) then the last slide rate used on the track is used again.
02 - Slide down (Portamento Down). This effect will slide down the frequency of the synth being
played on the track by XXYY (one semitone = 40) tones for every tick. If a slide rate is not specified
(XXYY is zero) then the last slide rate used on the track is used again.
03 - Slide to note. This effect will slide a note being played on a track to a specified note. The
parameter XXYY (one semitone = 40) will states the speed at which a slide will occur. If a slide rate is
not specified (XXYY is zero) then the last slide rate used on the track is used again.
04 - Vibrato with parameters XXYY, where the XX - frequency (examples of values: 20 - one period
per line; 40 - two periods per line), YY - amplitude (one semitone = 40).
08 - Arpeggio. This effect is normally used to simulate chords. It can also be used to produce a
heavy vibrato. Example: Note = C3; XXYY = 0407 (second note increment = 4; third note increment =
7) this is an attempt to produce a C-major chord. At the beginning of a line the C3 note is played, then
1/3 into the line the sound is retriggered at E-3, at 2/3 is retriggered at G3, and at the beginning of
the next line (if there are no new notes to be played on the track), it is retriggered at C3 again. Video
09 - Set sample offset. This functionality enables you to start a sample from a specified position
rather than the normal beginning position. Multiply value XXYY * 256 to get the position in frames
from the beginning of the sample where playback should start. If no sample is specified, the sample
currently playing is retriggered to the offset specified. Example: play instrument 2 at note C3, and
XXYY = 0023. This would make playback of the sample start at offset 0023 * 0100 = 2300. This offset
provides quite a wide range from where you can start playing the sample.
07 - Set sample offset (by percentage). XXYY from 0000 (sample start) to 8000 (sample end).
Video
0A - Slide velocity up/down. This effect will change the velocity of the synth being played on a
track. The value XXYY the speed of the velocity change. If XX is nonzero the velocity is increased, and
if YY is nonzero the velocity is decreased. Example: set XXYY to 0003. This means that at the
beginning of the line, the current velocity of the synth is decreased by 3 (because YY = 3). The
velocity is decreased by 3 again for every tick on this line.
0F - Set playing speed. This effect changes the speed (number of ticks per line) of playback. Valid
values for speed setting are 1 - 1F (1 - 31 in decimal). Values above 1F (31 in decimal), represent a
modified speed based on beats per minute, where 4 lines are 1 beat. A speed value of 2A (42 in
decimal), equals 42 beats per minute.
11 - Fineslide up. This effect functions just like effect 1, except that the frequency of the note is
only modified once (at the beginning of a line).
12 - Fineslide down. This effect functions just like effect 2, except that the frequency of the note is
only modified once (at the beginning of a line).
13 - Set Bypass/Solo/Mute flags. BSM = XYY; Example of mute: 13 0001; example of solo: 13
0010.
WarmPlace Wiki - http://www.warmplace.ru/wiki/
sunvox:manual_en http://www.warmplace.ru/wiki/doku.php?id=sunvox:manual_en
MIDI Out
You can use controllers with number 80+X to send MIDI Control Change command. Where the X is
MIDI Controller Number.
Example:
NN VV
-- --- -MSB LSB -
MM CCEE XXYY
01 8100 0000 - set Modulation (MSB and LSB) to the min value
01 8100 8000 - set Modulation (MSB and LSB) to the max value
Most Significant Byte;
Least Significant Byte.
You can get MIDI Controller Number for CC column from the following table.
Controller number +
80 (hex); Use these
Controller number
values in the CC
Controller name
(dec)
column of SunVox
pattern
0
80
Bank Select (Controller # A0 more commonly used)
http://www.warmplace.ru/wiki/
2015/10/02 19:38
Controller number +
80 (hex); Use these
Controller number
values in the CC
(dec)
column of SunVox
pattern
1
81
2
82
3
83
4
84
5
85
6
86
7
87
8
88
9
89
10
8A
11
8B
12
8C
13
8D
14-15
8E-8F
16-19
90-93
20-31
94-9F
32-63
A0-BF
64
C0
65
C1
66
C2
67
C3
68
C4
69
C5
70
C6
71
C7
72
C8
73
C9
74
CA
75-79
CB-CF
80-83
D0-D3
84
D4
85-90
D5-DA
91
DB
92
DC
93
DD
94
DE
95
DF
96
E0
97
E1
98
E2
99
E3
100
E4
WarmPlace Wiki - http://www.warmplace.ru/wiki/
13/38
What is SunVox
Controller name
Modulation Wheel
Breath Contoller
Undefined
Foot Controller
Portamento Time
Data Entry MSB
Main Volume
Balance
Undefined
Pan
Expression
Effect Control 1
Effect Control 2
Undefined
General Purpose Controllers
Undefined
LSB for Controllers 80 - 9F (rarely implemented)
Damper Pedal (Sustain)
Portamento
Sostenuto
Soft Pedal
Legato Footswitch
Hold 2
Sound Controller 1 (default: Sound Variation)
Sound Controller 2 (default: Timbre/Harmonic Content)
Sound Controller 3 (default: Release Time)
Sound Controller 4 (default: Attack Time)
Sound Controller 5 (default: Brightness)
Sound Controller 6-10 (no defaults)
General Purpose Controllers
Portamento Control
Undefined
Effects 1 Depth (previously External Effects Depth)
Effects 2 Depth (previously Tremolo Depth)
Effects 3 Depth (previously Chorus Depth)
Effects 4 Depth (previously Detune Depth)
Effects 5 Depth (previously Phaser Depth)
Data Increment
Data Decrement
Non-Registered Parameter Number LSB
Non-Registered Parameter Number LSB
Registered Parameter Number LSB
sunvox:manual_en http://www.warmplace.ru/wiki/doku.php?id=sunvox:manual_en
Controller number +
80 (hex); Use these
Controller number
values in the CC
(dec)
column of SunVox
pattern
101
E5
102-120
E6-F8
121
F9
122
FA
123
FB
124
FC
125
FD
126
FE
127
FF
Controller name
Module
Lines between the modules define the direction of signal transmission: more intensive part of line
must go from the source; less visible part must go to the destination (reciever).
There are three ways to connect one module to another:
For multitouch devices: first touch on source, second touch on destination. Check this simple videotutorial.
Select the first module (source). Click on the LINK button. Select the second module (destination).
Select the first module (source). Drag it to destination with SHIFT key pressed.
2015/10/02 19:38
15/38
What is SunVox
Every module has a set of parameters (controllers). Value of every controller can be changed, and
this change can be recorded in any pattern. Click twice (or right click) on the controller to open the
Controller Properties window, where you can do the following operations: change, reset,
randomize, write to pattern, assign MIDI IN;
Timeline
Timeline defines the layout of the SunVox project. It describes how to play the patterns. Patterns can
be repeated across multiple orders to save tracking time and file space.
Playback speed is defined by the following parameters:
TPL (Speed) - Ticks Per Line. Tick is the smallest time interval in SunVox.
BPM - Beats Per Minute. If TPL=6, Beat size is 4 lines. If TPL=3, Beat size is 8 lines.
Internal modules
Some modules have a Mode parameter with the following possible values:
If the CPU of your device is too slow for some SunVox project, here are some tips to avoid this.
sunvox:manual_en http://www.warmplace.ru/wiki/doku.php?id=sunvox:manual_en
Synths
Analog Generator
Generator with 32 double alias-free oscillators with internal 12/24dB filters, exponential envelopes
and smooth parameters changing.
Video
DrumSynth
Drum synthesizer with variety of predefined sounds.
Distribution of sounds:
Controllers:
Video1 Video2
FM Synthesizer
This synth is based on frequency modulation. It operates on an internal sampling frequency 44100 Hz.
Abbreviations: C - carrier; M - modulator.
http://www.warmplace.ru/wiki/
2015/10/02 19:38
17/38
What is SunVox
Controllers:
Video1 Video2
Generator
Basic oscillator with different waveforms and volume envelope.
This module can receive the incoming signal and use it for the phase modulation. To do this, connect
any other audio source to the input of the Generator, and that source will affect the frequency of the
Generator. And don't forget to set Phase Modulation controller to non-zero value.
Available local controllers: Type; Pan.
sunvox:manual_en http://www.warmplace.ru/wiki/doku.php?id=sunvox:manual_en
Controllers:
Volume;
Type - type of waveform:
0 - triangle;
1 - saw;
2 - square;
3 - white noise;
4 - dirty wave;
5 - sine;
6 - half-sine;
7 - abs-sine;
8 - pulse-sine with duty cycle.
Panning;
Attack;
Release;
Polyphony - number of notes the synthesizer can sound simultaneously;
Mode: HQ/HQmono;
Sustain: 0 - OFF; 1 - ON;
Frequency modulation: 0 - OFF 256 - use input signal for frequency modulation;
Duty cycle (only for square waveform).
Input
Audio input from Microphone/Line-in.
Compatibility: implemented in the iOS and Android versions only. Other systems will be supported
in future SunVox updates.
Kicker
Available local controllers: Type.
Controllers:
Volume;
Type - type of waveform: 0 - triangle; 1 - square;
Panning;
Attack;
Release;
Vol. Add - additional volume;
Env. Accel - volume & frequency envelope acceleration;
Polyphony - number of notes the synthesizer can sound simultaneously;
Anticlick: 0 - OFF; 1 - ON.
Video
http://www.warmplace.ru/wiki/
2015/10/02 19:38
19/38
What is SunVox
Vorbis player
OGG Vorbis player.
Sampler
Sampler can play and record audio files. Supported file formats: WAV, XI, AIFF, RAW. 8 / 16 / 24 / 32
bits. In Linux version all FFmpeg formats supported too.
Buttons description:
Load - load some audio file; this file will be stored in the module;
Rec, Rec mono, Rec LoFi - start/stop recording of received audio signal; for example, you can
connect Generator to Sampler, and Sampler will record the signal from Generator;
Edit - show/hide sample editor.
Volume;
Panning;
Sample interpolation: 0 - OFF; 1 - Linear;
Volume interpolation: 0 - OFF; 1 - Linear;
Polyphony - number of notes the synthesizer can sound simultaneously;
Rec threshold - the level at which the Sampler should start recording.
SpectraVoice
FFT-based synth. Can be used to generate a sound with a complex spectrum.
Available local controllers: Pan.
Controllers:
Volume;
Panning;
Attack;
Release;
Polyphony - number of notes the synthesizer can sound simultaneously;
Mode: HQ/HQmono/LQ/LQmono/Cubic;
Sustain: 0 - OFF; 1 - ON;
Sample size:
0 - 4096 words;
1 - 8192 words;
2 - 16384 words;
3 - 32768 words;
sunvox:manual_en http://www.warmplace.ru/wiki/doku.php?id=sunvox:manual_en
4 - 65536 words;
Harmonic - number of harmonic (0 - 15);
h.freq - harmonic's frequency;
h.volume - harmonic's amplitude;
h.bandwidth - harmonic's bandwidth;
h.bandtype - harmonic's bandtype:
0 - half sine;
1 - square;
2 - organ ver.1;
3 - organ ver.2;
4 - organ ver.3;
5 - organ ver.4;
6 - full sine.
Video
Effects
Amplifier
Controllers:
Volume;
Panning;
DC offset;
Inverse amplitude: 0 - off; 1 - on;
Width - stereo width: 0 - mono; 128 - normal; 256 - extended;
Absolute - enable it to apply absolute value filter to the signal;
Fine volume.
Compressor
Side chain compressor
Controllers:
Volume;
Threshold: 256 - 0 dB;
Slope (%);
Attack (ms);
Release (ms);
Peak/RMS: 0 - peak; 1 - RMS sensing;
Side chain input - side chain input number.
Video1 Video2
Explanation of compressor settings (taken from here)
http://www.warmplace.ru/wiki/
2015/10/02 19:38
21/38
What is SunVox
Slope
This controls the amount the compressor reduces the volume when activated (the threshold is the
point where the compressor is activated).
In SunVox it is measured by a percentage, but in other DAWs it is called Ratio. They have the same
effect, it's just that the measurement is different (Example: 50% vs 2:1 ratio)
For example:
I have a kick and a synth going to a compressor. I set the sidechain input to the kick module, so when
the kick's volume goes over the threshold, the sidechain compressor activates and decreases the
volume of the synth.
Now let's get into some numbers.
Suppose the slope is set to 50%. If my kick goes 2 decibels over the threshold, the compressor will
reduce the volume of the synth by 1 decibel (2*.5=1). If my kick goes 4 decibels over the threshold,
the compressor will reduce the volume of the synth by 2 decibels (4*.5=2). If I want less volume
reduction, I reduce the slope. So now let's set that slope to 25%. If my kick goes 4 decibels over the
threshold, the compressor will reduce the volume of the synth by 1 decibel (4*.25=1).
Attack
This value controls how long the compressor takes to reduce the audio when activated. Note that
(when activated) the compressor will IMMEDIATELY start to reduce the volume. It's the attack that
tells it how long to take to get to the full reduction.
Suppose I have a kick that lasts 32 milliseconds and exceeds the threshold by 4 decibels. My slope is
set to 50%, and the attack time is 10 milliseconds. The volume of the synth connected to the
compressor will be reduced by 2 decibels (4*.5=2) over 10 milliseconds. The biggest change in
volume will be at the end of the attack.
Here is a more visual example of the effect of the compressor on the synth:
--- = Volume of synth
Threshold = 2 db
Assuming the synth's volume starts at 8 decibels:
A-------- <==(kicker exceeds the 2 db threshold by 4 db, sidechain
compressor is activated and begins reducing the volume of the synth)
B------ <==(the synth's audio is reduced by 2 db 10 milliseconds after being
activated at A. The volume of the synth is now 6 db)
Note that the length of the kick doesn't matter (when changing the volume), its volume just needs to
exceed the threshold to activate the compressor (you could have a kick that is 1 millisecond long and
it'll still activate it). To sustain the compression, your kick will have to stay over the threshold for a
longer period of time.
Release
This controls how long the compressor takes to return the audio to its original volume after the attack
(it's essentially the same as attack, but backwards).
Using the example above (from the attack portion of this post), let's set the release to 45
WarmPlace Wiki - http://www.warmplace.ru/wiki/
sunvox:manual_en http://www.warmplace.ru/wiki/doku.php?id=sunvox:manual_en
milliseconds. After the sidechain input audio stops being over the threshold, the release returns the
synth to its original volume over 45 milliseconds.
Visual example:
--- = Volume of synth
Threshold = 2 db
Assuming the synth starts at a volume of 8 decibels:
A-------- <==(kicker exceeds the 2 db threshold by 4 db, sidechain
compressor is activated and begins reducing the volume of the synth)
B------ <==(the synth's audio is reduced by 2 db 10 milliseconds after being
activated at A. The volume of the synth is now 6 db)
C-------<==(the kick's volume has decreased and is no longer over the
compressor's threshold, which triggers the release)
D-------- <==(45 milliseconds AFTER C, the audio is back to its original
volume)
What your attack/release/slope values are depends on what you want. If you want a hard, pumping
sidechain compressor, try an attack of 10 and a release of 45, then adjust the slope until it really
pushes the synth down (just before it hits the bottom of the waveform box). This will reduce the
volume over 10 milliseconds, then return it to its original state 45 milliseconds after the sidechain
input audio stops being over the threshold.
If you want the kick to be louder, but don't want it to affect the compressor, you can link it to a
distortion module (which is linked to out) and increase the volume (of the distortion module). The
sidechain just uses the input you give it. The sidechain compressor functions the same as a regular
compressor, the only difference is that the sidechain asks for an input instead of affecting everything
linked to it.
DC Blocker
DC blocking filter.
Controllers:
Delay
Maximal length of the delay is 1/64 second.
Controllers:
http://www.warmplace.ru/wiki/
2015/10/02 19:38
23/38
What is SunVox
Distortion
Controllers:
Volume;
Type - type of distortion: 0 - limitation; 1 - saturation;
Power;
Bitrate: 1..16;
Frequency: 44100 means no frequency distortion at all.
Echo
Maximal delay length: 4 seconds.
Controllers:
EQ
3Band equalizer.
Controllers:
Low;
Middle;
High;
Mono: 0 - stereo; 1 - mono.
Filter
State Variable Filter.
In HQ mode the Filter is double-sampled. In LQ mode the Filter is 2x faster, but with the following
consequences:
frequency range is reduced by half (to 7000 Hz maximum); so if you want to set cut-off frequency
2000 Hz - you should set it to 4000;
LQ algorithm is very fast (specially for slow devices), but the cost of this speed is the instability in
sunvox:manual_en http://www.warmplace.ru/wiki/doku.php?id=sunvox:manual_en
some cases (Filter in LQ mode with high Freq values is unstable on some input signals with a
predominant high-frequency component).
Controllers:
Volume;
Frequency: maximum = 14000 Hz (8000 (hex) in the XXYY column of pattern);
Resonance;
Type:
0 - lowpass;
1 - highpass;
2 - bandpass;
3 - notch;
Response - speed of changing the frequency, resonance and volume;
Mode:
0 - double sampled stereo;
1 - double sampled mono;
2 - low quality stereo;
3 - low quality mono;
Impulse - frequency, that will be set immediately; then frequency will return to its previous value
smoothly (according to value of the Response controller);
Mix: minimum - output=input; maximum - output=filtered input;
LFO freq;
LFO power;
Set LFO phase;
Exponential freq;
Roll-off - dB per octave;
LFO frequency units;
LFO waveform.
Filter Pro
High quality IIR filter. Much more slower than the Filter.
Flanger
Controllers:
http://www.warmplace.ru/wiki/
2015/10/02 19:38
25/38
LFO
LFO - Low Frequency Oscillator.
Controllers:
Volume;
Type: 0 - amplitude modulation (tremolo); 1 - stereo panning modulation;
Power;
Frequency;
Shape:
Set phase;
Mono: 0 - stereo; 1 - mono;
Frequency units.
Loop
This effect is for repeating small pieces of input sound.
Controllers:
Volume;
Delay;
Stereo: 0 - mono; 1 - stereo;
Repeats - number of repeats in the loop.
Video
Modulator
Amplitude or Phase modulator. First input = Carrier. Other inputs = Modulators.
More info about amplitude modulation: http://en.wikipedia.org/wiki/Amplitude_modulation
More info about phase modulation: https://en.wikipedia.org/wiki/Phase_modulation
WarmPlace Wiki - http://www.warmplace.ru/wiki/
What is SunVox
sunvox:manual_en http://www.warmplace.ru/wiki/doku.php?id=sunvox:manual_en
Pitch Shifter
Video
Reverb
Reverberator with DC Blocking Filter.
Controllers:
Vocal Filter
This filter was designed to simulate the vocal tract of a human.
Controllers:
Volume;
Bandwidth - bandwidth of formants;
Amp. add - additional value for amplitude of formants;
Formants - number of voice formants; maximum = 5 (best result);
Vowel: AEIOU (minimal value - A; maximal - U);
Character:
0 - soprano;
1 - alto;
http://www.warmplace.ru/wiki/
2015/10/02 19:38
27/38
What is SunVox
2 - tenor;
3 - bass;
Mono: 0 - Stereo; 1 - Mono.
Video
Vibrato
Controllers:
Volume;
Amplitude;
Frequency;
Mono: 0 - Stereo; 1 - Mono;
Set phase;
Frequency units.
WaveShaper
In simple terms, WaveShaper allows you to change the shape of the input signal. Default shape is
linear (no changes; play the original signal).
In math terms, WaveShaper is the expression y = f( x ); where y - output; x - input; f - function with
graph which you can see in the WaveShaper interface. The horizontal axis of the graph is Input. The
vertical axis of the graph is Output.
Controllers:
Input volume;
Mix: minimum - output=input; maximum - output=filtered input;
Output volume;
Symmetric;
Mode;
DC filter (DC Blocking Filter).
Misc
Feedback
Generally the feedback is not allowed in SunVox you can't create an endless loop between the
modules. But you can do it by placing two Feedback modules inside of the loop (see screenshot).
Internal Feedback delay = 20 ms.
sunvox:manual_en http://www.warmplace.ru/wiki/doku.php?id=sunvox:manual_en
GPIO
With this module you can use the General-Purpose Input/Output (GPIO) pins of the device board. For
example, you can send some signals to the LEDs, or receive the ON/OFF messages from the buttons.
Requirements: Linux with GPIO Sysfs Interface enabled.
Video
MetaModule
MetaModule is a full-featured copy of SunVox in a single module. So you can include one SunVoxproject into another recursively. Some complex synth or effect (with large amount of the modules)
may be hidden in the MetaModule. You also can use it as arpeggiator.
There are two ways to play some generator in the MetaModule:
1. set Input Module controller to play some selected module inside of the MetaModule; polyphony is
possible in the this way, because it can be handled by the selected module directly;
2. set Play Patterns controller and play the whole SunVox project (with patterns) inside of the
MetaModule; polyphony is not possible in this way, because we need a separate copy of the
MetaModule for each polyphony channel, but this limitation may be removed in future SunVox
updates.
MultiCtl
With this module you can control multiple controllers at once.
Video
http://www.warmplace.ru/wiki/
2015/10/02 19:38
29/38
What is SunVox
MultiSynth
Sends the incoming events (Note ON, Note OFF, etc.) to any number of connected modules. So with
the MultiSynth you can play a large number of synths simultaneously by pressing one note only.
Controllers:
Transpose;
Random - random frequency change;
Velocity;
Finetune;
Random phase;
Random velocity;
Phase - the starting position of the sample or the starting phase of some Generator.
Video1 Video2
Sound2Ctl
This module converts the audio signal to the numeric value of any selected controller.
Input port of the Sound2Ctl is for receiving the audio signal. Output port of the Sound2Ctl is for
transmitting the commands like set controller X to the value Y.
If you want to disable this module: just mute it, or set OUT Controller to 0.
Video
Preferences
Go to the main menu Preferences, and you will see the window with the main SunVox settings (not
for the separate project, but for the whole SunVox app).
Main
Modules
Timeline
Interface
Audio
Recording
Metronome ON/OFF.
Fit pattern to grid: when enabled - the start position of the new recorded pattern will be multiple
of 32.
Note quantization: when enabled - the Delay effects (405F) will not be used for the new
recorded notes.
Automation quantization: when enabled - the Delay effects (405F) will not be used for the
automation (controller changing) commands, and the pattern size will be much more compact
(one track per controller) and readable.
sunvox:manual_en http://www.warmplace.ru/wiki/doku.php?id=sunvox:manual_en
MIDI
Configuration file
In most cases, you should not change this file manually, because the main settings are available in
the SunVox Preferences window.
SunVox takes its configuration from the sunvox_config.ini or sunvox_config.txt file. This file must be
placed in one of the following directories:
Linux
directory with SunVox;
user home directory (/home/username/);
Windows
directory with SunVox;
directory for application-specific data (/Documents and Settings/username/Application Data/);
OS X
directory with SunVox;
/Users/username/Library/Caches/;
WindowsCE (Windows Mobile)
root of local filesystem;
directory for application-specific data (/Documents and Settings/username/Application Data/);
PalmOS
root of local filesystem (use these utilities for converting from file to PDB:
http://www.warmplace.ru/soft/palm/psytexx2/converters/file2pdb.rar ;
http://www.warmplace.ru/soft/palm/psytexx2/converters/file2pdb.tar.gz );
root of SD-card.
2015/10/02 19:38
31/38
What is SunVox
//synth_xsize_divider 8
//synth_ysize_multiplier 80
// Undo buffer size (in kilobytes):
//undosize 2048
// Uncomment this option to rotate the screen (device dependent):
// ( example of usage: rotate 90 //turn the screen by 90 degrees )
//rotate 90
// Uncomment this option if you want fullscreen mode:
//fullscreen
// Uncomment this option if your device has touchscreen without pen
(stylus),
// or if you just want a large buttons:
//touchcontrol
// Sound buffer size (in frames):
buffer 4096
// Audio device name:
// * name examples for ALSA (Linux): "hw:0,0", "hw:1,0";
// * name examples for other audio systems: "0" - first device; "1" second device;
//audiodevice hw:0,0
// Audio driver name (alsa, oss, sdl, dsound, mmsound, asio):
// * alsa - ALSA (Linux);
// * oss - OSS (Linux);
// * sdl - SDL (Linux);
// * dsound - DirectSound (Windows);
// * mmsound - oldest audio API, slow, but compatible with all Windows and
Windows Mobile devices;
// * asio - ASIO (Windows);
//audiodriver alsa
// Sample rate (audio frames per second; minimum - 44100):
frequency 44100
// Video driver name on Windows Mobile:
// * gapi - default; requires gx.dll installed in your system;
// * raw - raw hires framebuffer; not supported by some devices;
// * gdi - compatibility mode; slow but universal;
//videodriver gapi
// Force UI optimization for Pen/Mouse control:
//pencontrol
// Display pixels per inch:
//ppi 160
WarmPlace Wiki - http://www.warmplace.ru/wiki/
sunvox:manual_en http://www.warmplace.ru/wiki/doku.php?id=sunvox:manual_en
Video tutorials
Getting Started
Making Music with SunVox Tutorial #1
Making Music with SunVox Tutorial #2
Tracker basics #1
Tracker basics #2
Controllers
Controllers: adjusting the levels graphically
Standard Effects
Arpeggio Standard Effect
Generator module
Loop Module
Drops Technique
Kicker, Compressor, and Ducking
Pitch Shifter
Using the Sampler to play back a drum loop, and time-stretch it
Sampler Retriggering / Scaling
Using std. effect 07 - sample offset (sample slicing)
Sample recording
Sampler eats JPEG images
Sampler: how to make voice with loop
Drawing a sample
Input Module and Sampler Recording
Phase modulation
Dirty generator
http://www.warmplace.ru/wiki/
2015/10/02 19:38
33/38
What is SunVox
For multitouch devices: first touch on source, second touch on destination. Check this simple videotutorial.
Select the first module (source). Click on the LINK button. Select the second module (destination).
Select the first module (source). Drag it to destination with SHIFT key pressed.
Lines between the modules define the direction of signal transmission: more intensive part of line
must go from the source; less visible part must go to the destination (reciever).
Q: SunVox crashing for no apparent reason.
A: Try to clean the settings of the SunVox. Launch it from console with the following command:
sunvox clearall. If you are Windows user - just run the reset_sunvox.bat script.
Q: Interface is lagging very much.
A: Try to disable some module visualization options: Main Menu Preferences Modules.
Q: Filter effect's impulse value doesn't change. When i change impulse value, it return 0.
A: It is normal behaviour. There is no need to remember the impulse value. I'll try to describe the
WarmPlace Wiki - http://www.warmplace.ru/wiki/
sunvox:manual_en http://www.warmplace.ru/wiki/doku.php?id=sunvox:manual_en
algorithm.
Q: Is there a particular bit rate/sample rate/# channels that the samples need to be in
order to work?
A: WAV samples must be in following format: 8 / 16 / 24 / 32 (float) bits; mono / stereo; any sampling
frequency; only uncompressed PCM data. Supported file formats: WAV, AIFF, XI, JPEG. As for JPEG,
brightness of the pixels will be converted into the sound wave (pixel by pixel).
Q: How to open the sample editor?
A: Please check this video-tutorial.
Q: For multisamples, how do I set the root note of my sample?
A: Use the rel.note (relative note) parameter for such purposes.
Q: I noticed the effects parameters on the right of the note, velocity etc at the top seem to
be missing.
A: These columns are hidden by default. But you can enable them - just go to the Main menu and
select Show additional columns.
Q: How to paste sounds from another iOS apps?
A:
1. copy the sound in some another app #1;
2. go to SunVox;
3. open Main Menu (button it the top right part of the screen) Export/Import Paste file from
system pasteboard;
4. select folder and name for the new file;
5. click SAVE and the file with sample from app #1 will be created;
6. now you can load this file by clicking the Load Module option in the Routing window (window with
modules).
Q: After i export the session into soundfile, where can i open this file in iOS device?
A: There are three ways.
1) Open SunVox Main menu Export/import Copy file to system pasteboard select your audio
file. Then you can open some other iOS app with Audio Copy/Paste support and do the Paste
operation.
2) Open SunVox Main menu Export/import Wi-Fi export/import. Then follow the instructions on
the screen.
3) Use iTunes File Sharing to access the SunVox files. Launch the iTunes on your computer. Sync it
http://www.warmplace.ru/wiki/
2015/10/02 19:38
35/38
What is SunVox
with iOS device. Then find SunVox in the list of apps of your device. And you will see the list of SunVox
documents.
Q: Is there a way to make the Sampler notes less 'clicky'? When I play pure waveforms
especially the clicks become really loud as it cuts off a wave at one amplitude and starts a
new one at a different amplitude.
A: Unfortunately there is no automatic anticlick function in the current version of the Sampler. You
should make it yourself. Please try to use the Volume Envelope with 1-tick (at least) release. Also
make sure that your Sampler has enough Polyphony channels. If not sure - just set it to 32 os ro.
Q: How to connect SunVox to another app via MIDI?
A:
Windows: use LoopMIDI to create the virtual MIDI cable between the apps; in SunVox this port can
be used as MIDI input (SunVox Preferences MIDI) or MIDI output (SunVox Module Properties
MIDI OUT).
Q: How do I adjust multisample instruments? I see slots for multiple samples and a zone
managment section in the editor, but I can only load one sample at a time?
A: I hope this little tutorial will help you.
Step 1. Open new empty sampler.
sunvox:manual_en http://www.warmplace.ru/wiki/doku.php?id=sunvox:manual_en
http://www.warmplace.ru/wiki/
2015/10/02 19:38
37/38
What is SunVox
sunvox:manual_en http://www.warmplace.ru/wiki/doku.php?id=sunvox:manual_en
From:
http://www.warmplace.ru/wiki/ - WarmPlace Wiki
Permanent link:
http://www.warmplace.ru/wiki/doku.php?id=sunvox:manual_en
Last update: 2015/10/02 12:53
http://www.warmplace.ru/wiki/