Вы находитесь на странице: 1из 25

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

sunvox:manual_en [warmplace]

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

www.warmplace.ru/wiki/sunvox:manual_en

2/25

10/7/12

sunvox:manual_en [warmplace]

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

www.warmplace.ru/wiki/sunvox:manual_en

3/25

10/7/12

sunvox:manual_en [warmplace]

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:

www.warmplace.ru/wiki/sunvox:manual_en

4/25

10/7/12

sunvox:manual_en [warmplace]

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).

www.warmplace.ru/wiki/sunvox:manual_en

5/25

10/7/12

sunvox:manual_en [warmplace]

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;
Polyphony number of notes the synthesizer can sound simultaneously;
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:

www.warmplace.ru/wiki/sunvox:manual_en

6/25

10/7/12

sunvox:manual_en [warmplace]

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;
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;
4 65536 words;
Harmonic number of harmonic (0 15);
h.freq harmonic's frequency;

www.warmplace.ru/wiki/sunvox:manual_en

7/25

10/7/12

sunvox:manual_en [warmplace]

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.

www.warmplace.ru/wiki/sunvox:manual_en

8/25

10/7/12

sunvox:manual_en [warmplace]

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:
Dry amount of original signal in output;
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;

www.warmplace.ru/wiki/sunvox:manual_en

9/25

10/7/12

sunvox:manual_en [warmplace]

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:
Dry amount of original signal in output;
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;

www.warmplace.ru/wiki/sunvox:manual_en

10/25

10/7/12

sunvox:manual_en [warmplace]

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:
Dry amount of original signal in output;
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);

www.warmplace.ru/wiki/sunvox:manual_en

11/25

10/7/12

sunvox:manual_en [warmplace]

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

www.warmplace.ru/wiki/sunvox:manual_en

12/25

10/7/12

sunvox:manual_en [warmplace]

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;

www.warmplace.ru/wiki/sunvox:manual_en

13/25

10/7/12

sunvox:manual_en [warmplace]

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);

www.warmplace.ru/wiki/sunvox:manual_en

14/25

10/7/12

sunvox:manual_en [warmplace]

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
//Set local controller 2 to value 0002
//Set local controller 2 to value 0003
//...

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.
www.warmplace.ru/wiki/sunvox:manual_en

15/25

10/7/12

sunvox:manual_en [warmplace]

(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

www.warmplace.ru/wiki/sunvox:manual_en

16/25

10/7/12

sunvox:manual_en [warmplace]

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)

www.warmplace.ru/wiki/sunvox:manual_en

17/25

10/7/12

sunvox:manual_en [warmplace]

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 with SunVox;
directory for applicationspecific data (/Documents and Settings/username/Application
Data/);
Mac OS X
directory with SunVox;
/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:

www.warmplace.ru/wiki/sunvox:manual_en

18/25

10/7/12

sunvox:manual_en [warmplace]

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

www.warmplace.ru/wiki/sunvox:manual_en

19/25

10/7/12

sunvox:manual_en [warmplace]

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]

www.warmplace.ru/wiki/sunvox:manual_en

20/25

10/7/12

sunvox:manual_en [warmplace]

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;

www.warmplace.ru/wiki/sunvox:manual_en

21/25

10/7/12

sunvox:manual_en [warmplace]

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.

www.warmplace.ru/wiki/sunvox:manual_en

22/25

10/7/12

sunvox:manual_en [warmplace]

Step 3. Sample 0 loaded.

Step 4. Load sample 1.

www.warmplace.ru/wiki/sunvox:manual_en

23/25

10/7/12

sunvox:manual_en [warmplace]

Step 5. Sample 1 loaded.

Step 6. Make sample 1 playable on octaves 5 and 6.

www.warmplace.ru/wiki/sunvox:manual_en

24/25

10/7/12

sunvox:manual_en [warmplace]

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/]

www.warmplace.ru/wiki/sunvox:manual_en

25/25