Manual en (Warmplace)

10/7/12
sunvox:manual_en [warmplace]
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, Linux, Mac OS X, Windows Mobile, PalmOS, Maemo, Meego, iOS and Android.
Key features:
Modular interface.
Highly optimized synth algorithms.
Flexible architecture: SunVox works on a variety of devices. For example: pocket computer with slow
CPU 13bit sound (fixed point arithmetic); or a big PC with a powerful CPU: 32bit sound (floating
point arithmetic).
Official SunVox page: http://www.warmplace.ru/soft/sunvox [http://www.warmplace.ru/soft/sunvox]
Minimum system requirements

Windows:
no special requirements.
Linux:
any Linux distribution (x86 or x86_64);
SDL library (version 1.2 or later);
ALSA.
Mac OS X:
x86_64 architecture;
Mac OS X 10.6 or later.
Android:
Android 2.3 or later.
Maemo: (tested on Nokia N900)
libsdl1.2;
libosso1.
Meego:
ARM CPU;
libsdl1.2;
libasound2.
Windows Mobile (WinCE):
ARM CPU.
PalmOS:
ARM CPU;
PalmOS 5.0;
www.warmplace.ru/wiki/sunvox:manual_en
1/25
10/7/12
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 [http://fanoush.wz.cz/palm/fhr.html]
Mobile version
Mobile version (ARMbased) of SunVox has fixed point integer audio engine (4.12 bits). This means that you
hear the 13bit sound on mobile devices. It is fast but with slightly audible quantization noise. Rendering to
WAV also has this noise, but no more than that. For example, if you hear some glitches due to lack of CPU
power, these glitches will not be present in the WAVfile after rendering. In other words, the result of WAV
rendering will be the same on different devices with ARM CPU.
In spite of the mobile version noise, 32bit WAV export may be with better quality due to the absence of
audio overflow.
Interface description
2/25
10/7/12
First click on the Stop button stop playing. Second click reset all SunVox activity and switch the engine to
standby mode.
Keyboard shortcuts
Keys
Description
SPACE
edit mode ON/OFF
q,w,e,r,t,y,u,i.
playing notes
CAPSLOCK or '~'
insert note OFF
F1F8
set octave number
TAB
go to the next track
SHIFT + TAB
go to the previous track
CTRL + Z
UNDO
CTRL + Y or SHIFT + CTRL + Z
REDO
CTRL + X
cut
CTRL + C
copy
CTRL + V
paste
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 synth / create a new pattern
CTRL + R
randomize synth controllers (sound network)
SHIFT + DELETE
cut
SHIFT + INSERT
paste
SHIFT + '+'
transpose selected area up (pattern editor)
SHIFT + ''
transpose selected area down (pattern editor)
SHIFT
UP/DOWN/LEFT/RIGHT
selection
SHIFT + MOUSE MOVING
synth link/unlink
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
F9
play
3/25
10/7/12
F11
play pattern
F12
stop
Internal modules (synthesizers & effects)

Some synthesizers have a Mode parameter with the following possible values:
HQ High Quality (stereo). Linear interpolation
HQmono High Quality (mono). Linear interpolation
LQ Low Quality (stereo) for devices with slow CPU
LQmono Low Quality (mono) for devices with slow CPU
Cubic High Quality (stereo). Cubic interpolation
Analog Generator
Generator with 32 double aliasfree oscillators with internal 12/24dB filters, exponential envelopes and
smooth parameters changing.
Video [http://www.youtube.com/watch?v=on67bFRtktw]
DrumSynth
Drum synthesizer with variety of predefined sounds.
Distribution of sounds:
notes C, C#, D, D# for bass drum;
notes E, F, F# for hihat;
notes G, G#, A, A#, B for snare drum.
Controllers:
Volume main synth volume;
Panning;
Polyphony how many notes synthesizer can sound at one time;
Bass volume bass drum volume;
Bass power bass drum power;
Bass tone bass drum tone;
Bass length bass drum length;
Hihat volume;
Hihat length;
Snare volume snare drum volume;
Snare tone snare drum tone;
Snare length snare drum length.
Video1 [http://www.youtube.com/watch?v=EBdJPFISe0g] Video2 [http://www.youtube.com/watch?v=VNwcJGdfRLM]
FM Synthesizer
This synth is based on frequency modulation. It operates on an internal sampling frequency 44100 Hz.
Abbreviations: C carrier; M modulator.
Controllers:
4/25
10/7/12
C.Volume carrier volume;

M.Volume modulator volume;
Panning;
C.Freq mul carrier frequency multiplier;
M.Freq mul modulator frequency multiplier;
M.Feedback modulator feedback;
C.Attack carrier attack;
C.Decay carrier decay;
C.Sustain carrier sustain;
C.Release carrier release;
M.Attack modulator attack;
M.Decay modulator decay;
M.Sustain modulator sustain;
M.Release modulator release;
M.Scaling how modulator volume depends on note number;
Polyphony how many notes synthesizer can sound at one time;
Mode:
0 High Quality. Stereo. Linear interpolation of envelopes;
1 High Quality. Mono. Linear interpolation of envelopes;
2 Low Quality. Stereo. No interpolation;
3 Low Quality. Mono. No interpolation.
Video1 [http://www.youtube.com/watch?v=IH6LiIERfHY] Video2 [http://www.youtube.com/watch?v=sx7aFSLbOD0]
Generator
This synth is for generating different types of waves.
Available local controllers: Type; Pan.
Controllers:
Volume;
Type type of waveform:
0 triangle;
1 saw;
2 square;
3 white noise;
4 dirty wave;
5 sine;
6 halfsine;
7 abssine;
8 pulsesine with duty cycle.
Panning;
Attack;
Release;
Polyphony number of notes the synthesizer can sound simultaneously;
Mode: HQ/HQmono;
Sustain: 0 OFF; 1 ON;
Phase modulation: 0 OFF 256 use input signal for phase modulation;
Duty cycle (only for square waveform).
5/25
10/7/12
Video1
[http://www.youtube.com/watch?v=YbWa_wV639g]
Video2
v=RbuLOMvCDGc] Video3 [http://www.youtube.com/watch?v=C_SCQdZBGKg]
[http://www.youtube.com/watch?
Input
Audio input from Microphone or from Linein.
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;
Anticlick: 0 OFF; 1 ON.
Video [http://www.youtube.com/watch?v=r4NNw9TwQ4]
MetaModule
With MetaModule you can create your own complex modules and save them in the .sunsynth file format. In
other words you can include some external .sunvox song to your project and use this song as synth or
effect.
How to use it?
1. Make a new song. Create some nice audiochain with several modules. Generator + effects, or effects
only. Test it. Then save to mysong.sunvox.
2. Clear all, make a new song again.
3. Add the MetaModule to your audio network.
4. Click the LOAD button under the MetaModule controllers. Then select mysong.sunvox from the first
step.
5. And the important point: now this MetaModule contains your mysong.sunvox. Select some input
module (controller 02) and you can play it, or use it as effect.
6. Save this MetaModule to mysynth.sunsynth file. And that's it. Your compex module is ready. You can
use it in other projects. The mysynth.sunsynth file is similar to VST plugin.
Also you can optimize the 3th and 4th steps. Go to the menu of the window with modules. Click Load
Module. Then select mysong.sunvox file. And MetaModule with your song will be created automatically.
MultiSynth
Translates music events to any number of synths.
Controllers:
6/25
10/7/12
Transpose;
Random random frequency change;
Velocity.
Video1 [http://www.youtube.com/watch?v=0FEOZevIYKs] Video2 [http://www.youtube.com/watch?v=lo9W2HzJm_s]
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.
Available local controllers: Pan.
Controllers:
Volume;
Panning;
Sample interpolation: 0 OFF; 1 Linear;
Volume interpolation: 0 OFF; 1 Linear;
Polyphony number of notes the synthesizer can sound simultaneously.
Video1 [http://www.youtube.com/watch?v=YTlNQ5rDquA] Video2 [http://www.youtube.com/watch?v=ColyxxBzeiE]
Video3 [http://www.youtube.com/watch?v=IQ7asEBSvig]
SpectraVoice
FFTbased synth. Can be used to generate a sound with a complex spectrum.
Available local controllers: Pan.
Controllers:
Volume;
Panning;
Attack;
Release;
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;
4 65536 words;
Harmonic number of harmonic (0 15);
h.freq harmonic's frequency;
7/25
10/7/12
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 [http://www.youtube.com/watch?v=woDptZv1nSg]
Amplifier
Controllers:
Volume;
Panning;
DC offset [http://en.wikipedia.org/wiki/DC_offset];
Inverse amplitude: 0 off; 1 on;
Width stereo width: 0 mono; 128 normal; 256 extended.
Compressor
Side chain compressor [http://en.wikipedia.org/wiki/Dynamic_range_compression]
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
[http://www.youtube.com/watch?v=fjR2rVmZh58]
Video2
[http://www.youtube.com/watch?v=r4NN
w9TwQ4]
DC Blocker
DC [http://en.wikipedia.org/wiki/DC_offset] blocking filter.
Controllers:
Mono: 0 stereo; 1 mono.
Delay
Maximal length of the delay is 1/64 second.
8/25
10/7/12
Controllers:
Dry amount of original signal in output;
Wet amount of delayed signal in output;
Delay L delay length on the left channel; maximum delay 1/64 second;
Delay R delay length on the right channel; maximum delay 1/64 second;
Volume L left channel volume;
Volume R right channel volume;
Mono: 0 stereo delay; 1 mono delay;
Inverse amplitude: 0 OFF; 1 ON.
Distortion (and amplifier)

Controllers:
Volume;
Type type of distortion: 0 limitation; 1 saturation;
Power;
Bitrate: 1..16;
Frequency: maximum = 44100 Hz (8000 (hex) in the XXYY column of pattern).
Echo
Maximal delay length: 4 seconds.
Controllers:
Wet amount of signal with echo in output;
Feedback;
Delay delay length; maximal delay one second;
Stereo: 0 mono; 1 stereo;
Delay units.
EQ
3Band equalizer.
Controllers:
Low;
Middle;
High;
Mono: 0 stereo; 1 mono.
Filter
State Variable Filter. Double Sampled.
Controllers:
Volume;
9/25
10/7/12
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;
Rolloff dB per octave;
LFO frequency units.
Video1 [http://www.youtube.com/watch?v=4tZDfUiaYE] Video2 [http://www.youtube.com/watch?v=eB1nLZTpmrA]
Video3 [http://www.youtube.com/watch?v=YdcYki5emHU]
Flanger
Controllers:
Wet amount of signal with echo in output;
Feedback;
Delay delay length; maximal delay 1/64 second;
Resonance; use low values for smooth delay changing;
Vibrato speed;
Vibrato power;
Vibrato type: 0 half of sinus; 1 sine;
Set vibrato phase;
Vibrato speed units.
LFO
LFO Low Frequency Oscillator.
Controllers:
Volume;
Type: 0 amplitude modulation (tremolo); 1 stereo panning modulation;
Power;
Frequency;
10/25
10/7/12
Shape: 0 sine; 1 square;

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 [http://www.youtube.com/watch?v=ZBA0JYm7epQ]
Modulator
Amplitude modulator (multiplier of the inputs). For N inputs: Modulator Output Amplitude = Input1 * Input2
* Input3 * InputN
More
info
about
amplitude
modulation:
http://en.wikipedia.org/wiki/Amplitude_modulation
[http://en.wikipedia.org/wiki/Amplitude_modulation]
Reverb
Reverberator with DC Blocking Filter.
Controllers:
Wet amount of reverberation in output;
Feedback;
Damp;
Width;
Freeze: 0 none; 1 freeze mode;
Mode;
Allpass filter: 0 disabled; 1 enabled;
Room size.
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);
11/25
10/7/12
Vowel: AEIOU (minimal value A; maximal U);

Character:
0 soprano;
1 alto;
2 tenor;
3 bass;
Mono: 0 Stereo; 1 Mono.
Video [http://www.youtube.com/watch?v=f6ElIPjwXW8]
Vorbis Player
OGG Vorbis Player.
Vibrato
Controllers:
Volume;
Amplitude;
Frequency;
Mono: 0 Stereo; 1 Mono;
Set phase;
Frequency units.
WaveShaper
Controllers:
Input volume;
Mix: minimum output=input; maximum output=filtered input;
Output volume;
Symmetric;
Mode.
Song structure
12/25
10/7/12
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 [http://en.wikipedia.org/wiki/Hexadecimal]
Examples of hexadecimal numbers and its decimal equivalents:
00 = 0;
01 = 1;
09 = 9;
0A = 10;
0B = 11;
13/25
10/7/12
0C = 12;
0D = 13;
0E = 14;
0F = 15;
10 = 16;
11 = 17;
FF = 255
Pattern editor
Pattern format
Any pattern in the SunVox looks like this:
track
0
track
1
track
2
000 event
event
event
001 event
event
event
xxx
line
event some music event (something like a MIDI command).

Examples of events:
C5 80
0000
01
0000
event of turning note A5 A5 80

on:
0000
01
0000
event of turning note C5 on:
event of turning note off:
==
As you can see, an events contain several text/numeric fields. All numbers in the pattern are represented
in HEXADECIMAL format.
Event format: NN VV SS CCEE XXYY
Lets see detailed description of each field in the event:
NN note (C0,c0,D0,d0,E0,F0,f0,G0,g0,A0,a0,B0,C1,c1,D1, B9);
VV velocity (00..80);
SS synth number (00,01,02,03,04,05,06,07,08,09, FF);
CC number of a controller (01,02,03,04, FF);
EE standard effect:
01 slide up (portamento up; sliding speed = XXYY);
02 slide down (portamento down; sliding speed = XXYY);
03 slide to note (sliding speed = XXYY);
04 vibrato; (XX frequency; YY amplitude);
07 set sample offset (offset in percents = XXYY from 0000 (0%) to 8000 (100%));
08 arpeggio (XX second note increment; YY third note increment);
09 set sample offset (offset in frames = XXYY * 256); one frame lenght = 1 / sampling
frequency;
0A slide velocity up/down (XX up speed; YY down speed);
0F set playing speed (XXYY: 0001..001F number of ticks per line; 0020..00FF BPM);
14/25
10/7/12
19 retrigger note after XXYY ticks during the line;

1C cut note after XXYY ticks in the current line;
1D delays the start of note until tick XXYY in the current line;
20 note probability;
21 note probability with random velocity;
22 set the controller's value to the random number from 0 to XXYY;
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).
Velocity can be changed dynamically. Example:
NN VV SS CCEE XXYY
C3 10 03 0000 0000
-- 20 -- 0000 0000
-- 30 -- 0000 0000
-- 40 -- 0000 0000
-- 50 -- 0000 0000
-- 60 -- 0000 0000
In this example velocity changed from 10 to 60.

Example of changing cutoff frequency (global controller) of filter from min to max value:
NN VV SS CCEE XXYY
-- -- 01 0200 0000
-- -- 01 0200 1000
-- -- 01 0200 2000
-- -- 01 0200 3000
-- -- 01 0200 4000
-- -- 01 0200 5000
-- -- 01 0200 6000
-- -- 01 0200 7000
-- -- 01 0200 8000
The Cutoff frequency controller has a number 2 in the filter.

Some synths have local controllers. A local controller can be changed for a separate sound on a separate
track, independently of the other sounds of the same module.
Example: (changing local controller 2 in the module 1)
NN VV SS CCEE XXYY
C3 80 01 0200 0000
-- -- 01 0200 0001
-- -- 01 0200 0002
-- -- 01 0200 0003
-- -- 01 0200 0002
-- -- 01 0200 0001
//Set local controller 2 to value 0000. Separate sound begins playing here
//Set local controller 2 to value 0001
//...
Standard 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.
15/25
10/7/12
(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 Cmajor chord. At the beginning of a line the C3 note is played, then 1/3 into the line
the sound is retriggered at E3, 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 [http://www.youtube.com/watch?
v=gr8yhfLhVCE]
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
[http://www.youtube.com/watch?v=j2aCYlYufH8]
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 DD = 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).
19 Retrigger. Effect 19 allows you to retrigger a note after XXYY ticks during the line. For example, let's
specify note C3 and set XXYY = 2 when the speed (TPL) is currently 6. This starts the specified note at the
beginning of the line, and after two ticks it is restarted. This continues until the beginning of the next line.
1C Cut. This effect turns off the note after XXYY ticks in the current line.
1D Delay. This effect delays the start of a note until tick XXYY in the current line. For example, if note C2
is played, with effect 1D and argument XXYY = 3 when the speed is 6. The note C2 will be triggered at the
3rd tick after the start of the line. Purpose: to delay the start of a sample for a VERY short amount of time.
20 Note probability. Set the probability XXYY (from 0 to 8000) of a note being triggered. This effect can
be used for original unpredictable rhythms.
21 Note probability with random velocity. Same as effect 20 but with random velocity.
22 Set the controller's value to the random number from 0 to XXYY.
30 Stop playing the song.
405F delay an event for selected fraction of the line (from 40 (0%) to 5F (100%)).
Video [http://www.youtube.com/watch?v=u16mkFvORDs]
MIDI Out
16/25
10/7/12
You can use controllers with number 80+X to send MIDI Control Change command. Where the X is MIDI
Controller Number.
Example:
NN VV SS 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
MSB - Most Significant Byte;
LSB - Least Significant Byte.
You can get MIDI Controller Number for CC column from the following table.
Controller number + 80 (hex); Use these values in the CC column of
Controller name
SunVox pattern
80
Bank Select (Controller # A0 more commonly

used)
81
Modulation Wheel
82
Breath Contoller
83
Undefined
84
Foot Controller
85
Portamento Time
86
Data Entry MSB
87
Main Volume
88
Balance
89
Undefined
8A
Pan
8B
Expression
8C
Effect Control 1
8D
Effect Control 2
8E8F
Undefined
9093
General Purpose Controllers
949F
Undefined
A0BF
LSB for Controllers 80 9F (rarely implemented)
C0
Damper Pedal (Sustain)
C1
Portamento
C2
Sostenuto
C3
Soft Pedal
C4
Legato Footswitch
C5
Hold 2
C6
Sound Controller 1 (default: Sound Variation)
C7
Sound Controller 2 (default: Timbre/Harmonic

Content)
C8
Sound Controller 3 (default: Release Time)
C9
Sound Controller 4 (default: Attack Time)
CA
Sound Controller 5 (default: Brightness)
CBCF
Sound Controller 610 (no defaults)
D0D3
General Purpose Controllers
D4
Portamento Control
D5DA
Undefined
DB
Effects 1 Depth (previously External Effects

Depth)
17/25
10/7/12
DC
Effects 2 Depth (previously Tremolo Depth)
DD
Effects 3 Depth (previously Chorus Depth)
DE
Effects 4 Depth (previously Detune Depth)
DF
Effects 5 Depth (previously Phaser Depth)
E0
Data Increment
E1
Data Decrement
E2
NonRegistered Parameter Number LSB
E3
NonRegistered Parameter Number LSB
E4
Registered Parameter Number LSB
E5
Registered Parameter Number MSB
E6F8
Undefined
F9
Reset All Controllers
FA
Local Control
FB
All Notes Off
FC
Omni Off
FD
Omni On
FE
Mono On (Poly Off)
FF
Poly On (Mono Off)
Configuration
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 for applicationspecific data (/Documents and Settings/username/Application
Data/);
Mac OS X
/Users/username/Library/Caches/;
WindowsCE (Windows Mobile)
root of local filesystem;
directory for applicationspecific 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.rar]
http://www.warmplace.ru/soft/palm/psytexx2/converters/file2pdb.tar.gz
[http://www.warmplace.ru/soft/palm/psytexx2/converters/file2pdb.tar.gz] );
root of SDcard.
Typical sunvox_config.ini [http://www.warmplace.ru/docs/sunvox/sunvox_config.ini] file looks like this:
// Remove the '//' symbol to enable (uncomment) the string.
// Window width and height:
18/25
10/7/12
width 800
height 600
// Use this option for setting maximal number of frames per second:
// ( less value - less CPU usage )
//maxfps 30
// Uncomment these options to hide scopes and levels (i.e. for slow devices):
//no_scopes
//no_levels
// Modules size:
//synths_min_num 8
//synth_max_xsize 100
//synth_min_xsize 32
//synth_xsize_divider 8
//synth_ysize_multiplier 80
// Undo buffer size (in kilobytes):
//undosize 2048
// Uncomment this option for screen rotate (device dependent):
// ( example of usage: rotate 90 //turn the screen by 90 degrees )
//rotate 90
// Uncomment this option if you want fullscreen mode in Linux (SDL):
//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
// UI scale factor (normal=256):
//scale 256
// Pixel size:
//zoom 2
// Uncomment the "theme" option to use the custom color themes:
// (four base colors defined by c_0, c_1, c_2 and c_3 options)
//theme
c_0 #000000
c_1 #101010
c_2 #808080
19/25
10/7/12
c_3 #FFFF00
Music made with SunVox

Dedicated group on SoundCloud [http://soundcloud.com/groups/sunvox]
NightRadio Back to the sources (album) [http://www.warmplace.ru/music/btts]
Video tutorials
Getting Started [http://www.youtube.com/watch?v=FJh6yiKPqE4]
Generator module [http://www.youtube.com/watch?v=YbWa_wV639g]
Tracker basics [http://www.youtube.com/watch?v=MB8QcQY_C8]
Tracker basics #2 [http://www.youtube.com/watch?v=bLuh1u9We0o]
SunVox on iPad with MIDIkeyboard [http://www.youtube.com/watch?v=daMCjo8B57s]
SunVox on iOS: simple tutorial [http://www.youtube.com/watch?v=yLWwpA1Zj8I]
SunVox on iOS: FM synth [http://www.youtube.com/watch?v=IH6LiIERfHY]
SunVox on iOS: playing live [http://www.youtube.com/watch?v=5WJFQfq0CmY]
Loop Module [http://www.youtube.com/watch?v=ZBA0JYm7epQ]
Drops Technique [http://youtu.be/4LKggMOvFuM]
Kicker, Compressor, and Ducking [http://www.youtube.com/watch?v=r4NNw9TwQ4]
Standard Effects [http://www.youtube.com/watch?v=u16mkFvORDs]
Arpeggio Standard Effect [http://www.youtube.com/watch?v=gr8yhfLhVCE]
Using the Sampler to play back a drum loop, and timestretch it [http://www.youtube.com/watch?
v=IQ7asEBSvig]
Sampler Retriggering / Scaling [http://www.youtube.com/watch?v=j2aCYlYufH8]

Phase modulation [http://www.youtube.com/watch?v=NlV5rCIz8xk]
Dirty generator [http://www.youtube.com/watch?v=RbuLOMvCDGc]
Acid bass: MultiSynth + two oscillators + filter [http://www.youtube.com/watch?v=4tZDfUiaYE]
Waveform drawing in Generator [http://youtu.be/C_SCQdZBGKg]
DrumSynth [http://youtu.be/EBdJPFISe0g]
DrumSynth and Patterns [http://www.youtube.com/watch?v=VNwcJGdfRLM]
Sample recording [http://www.youtube.com/watch?v=oSDbZWKdWwU]
Synthetic violin [http://www.youtube.com/watch?v=6Rk9MKPwhD8]
MultiSynth: playing several generators simultaneously [http://www.youtube.com/watch?v=0FEOZevIYKs]
MultiSynth (by SolarLune) [http://www.youtube.com/watch?v=lo9W2HzJm_s]
Using std. effect 07 sample offset (sample slicing) [http://www.youtube.com/watch?v=48kAhPIh8c]
How to make a beautiful synthetic choir [http://www.youtube.com/watch?v=f6ElIPjwXW8]
Sampler eats JPEG images [http://www.youtube.com/watch?v=ColyxxBzeiE]
Tempo automation (shuffle) [http://www.youtube.com/watch?v=X4VH5TqySsA]
FM synth. Another example [http://www.youtube.com/watch?v=sx7aFSLbOD0]
Endless selfmodifying song [http://www.youtube.com/watch?v=uajwIouNb6I]
Drawing a sample [http://www.youtube.com/watch?v=skkV2T1LkbQ]
Filter LFO + multisynth [http://www.youtube.com/watch?v=eB1nLZTpmrA]
Automation [http://www.youtube.com/watch?v=YdcYki5emHU]
Sampler: how to make voice with loop [http://www.youtube.com/watch?v=YTlNQ5rDquA]
20/25
10/7/12
How to make "8bit" tune in SunVox [http://www.youtube.com/watch?v=Auiv49gqmQA]

SpectraVoice: two harmonics [http://www.youtube.com/watch?v=woDptZv1nSg]
More... [http://www.warmplace.ru/forum/viewtopic.php?f=3&t=1223]
Frequently asked questions (FAQ)

Q: How to connect one module to another?
A: There are three ways.
For multitouch devices: first touch on source, second touch on destination. Check this simple video
tutorial [http://www.youtube.com/watch?v=IH6LiIERfHY].
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.
Dark part of the connection line must go FROM SOURCE. Bright part TO DESTINATION. Reconnection
removes the previous connection.
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
algorithm.
Frequency = 1000 (for example).
You set Impulse to 3000.
Filter sets its internal frequency to 3000.
Filter resets Impulse to 0. (0 = no more commands from user).
Frequency changes smoothly from 3000 to 1000. Speed depends on the Response value.
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 videotutorial [http://www.youtube.com/watch?v=YTlNQ5rDquA].
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
Hide/show effects.
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;
21/25
10/7/12
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 Sound Network (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 WiFi 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 with iOS
device. Then find SunVox in the list of apps of your device. And you will see the list of SunVox documents.
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.
Step 2. Load sample 0.
22/25
10/7/12
Step 3. Sample 0 loaded.
Step 4. Load sample 1.
23/25
10/7/12
Step 5. Sample 1 loaded.
Step 6. Make sample 1 playable on octaves 5 and 6.
24/25
10/7/12
sunvox/manual_en.txt Last modified: 2012/10/02 11:12 by nightradio
Except where otherwise noted, content on this wiki is licensed under the following license:CC Attribution
NoncommercialShare Alike 3.0 Unported [http://creativecommons.org/licenses/byncsa/3.0/]
25/25

Manual en (Warmplace)

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Manual en (Warmplace)

Uploaded by

Copyright:

Available Formats

10/7/12

Minimum system requirements

edit mode ON/OFF

insert note OFF

set octave number

go to the next track

go to the previous track

CTRL + Y or SHIFT + CTRL + Z

select track (pattern editor)

interpolate values (pattern editor)

interpolate velocity (pattern editor)

create a new synth / create a new pattern

randomize synth controllers (sound network)

transpose selected area up (pattern editor)

transpose selected area down (pattern editor)

SHIFT + MOUSE MOVING

save song to BACKUP.sunvox

increase the edit step

decrease the edit step

Internal modules (synthesizers & effects)

C.Volume carrier volume;

h.volume harmonic's amplitude;

Distortion (and amplifier)

Frequency: maximum = 14000 Hz (8000 (hex) in the XXYY column of pattern);

Shape: 0 sine; 1 square;

Vowel: AEIOU (minimal value A; maximal U);

event some music event (something like a MIDI command).

event of turning note A5 A5 80

event of turning note C5 on:

event of turning note off:

19 retrigger note after XXYY ticks during the line;

In this example velocity changed from 10 to 60.

The Cutoff frequency controller has a number 2 in the filter.

Bank Select (Controller # A0 more commonly

Data Entry MSB

General Purpose Controllers

LSB for Controllers 80 9F (rarely implemented)

Damper Pedal (Sustain)

Sound Controller 1 (default: Sound Variation)

Sound Controller 2 (default: Timbre/Harmonic

Sound Controller 3 (default: Release Time)

Sound Controller 4 (default: Attack Time)

Sound Controller 5 (default: Brightness)

Sound Controller 610 (no defaults)

General Purpose Controllers

Effects 1 Depth (previously External Effects

Effects 2 Depth (previously Tremolo Depth)

Effects 3 Depth (previously Chorus Depth)

Effects 4 Depth (previously Detune Depth)

Effects 5 Depth (previously Phaser Depth)

NonRegistered Parameter Number LSB

NonRegistered Parameter Number LSB

Registered Parameter Number LSB

Registered Parameter Number MSB

Reset All Controllers

All Notes Off

Mono On (Poly Off)

Poly On (Mono Off)

Music made with SunVox

Sampler Retriggering / Scaling [http://www.youtube.com/watch?v=j2aCYlYufH8]

How to make "8bit" tune in SunVox [http://www.youtube.com/watch?v=Auiv49gqmQA]

Frequently asked questions (FAQ)

Q: How to open the sample editor?