rakarrack Logo

Help Contents


GENERAL

Return to Top

RAKARRACK is a multi-effect processor for guitar players but can also be used for other purposes. Seventeen effects are included in this version: Lineal EQ, Compressor, Distortion, Overdrive, Echo, Chorus, Phaser, Flanger, Reverb,  Parametric EQ, WahWah, Alienwah, Cabinet, AutoPan/Extra Stereo, Harmonizer, Musical Delay and NosieGate. Ten can be used simultaneously on a chain. Also has a Tuner and a monophonic MIDI Converter. Rakarrack can be managed externally by MIDI, the program receive Program Change and Volume Control Change MIDI messages. One of the most important things of RAKARRACK is that everything is on a single mouse click. All the effect parameters are on the screen.

The effects are processed on a chain, the chain order processing is fully configurable by the user for each preset. The preset saves all the effects parameters. These presets can be grouped into banks to manage more efficiently.

Rakarrack is capable of generating high power output. It has Gain controls in general and some of the effects. Use these gains with caution because they can produce unwanted effects.

Rakarrack is a JACK application, Dave Phillips wrote some good articles in their blog of how to use linux audio with jack, if you don't know about jack, or you have problems running rakarrack, please read this series of articles:

Troubleshooting Linux Audio, Part 1

Troubleshooting Linux Audio, Part 2

Troubleshooting Linux Audio, Part 3a

Troubleshooting Linux Audio, Part 3b


Command Line Options

Short Format Long Format  
-h --help Shows the command line options and exits.
-n --no-gui Start the application without GUI
-l file --load=file Load file single Preset
-b file --bank=file Load a file Bank

Examples:

rakarrack -l mypreset.rkr     Starts Rakarrack and load the preset file mypreset.rkr

rakarrack -n -b mybank.rkrb    Starts Rakarrack without GUI and load the bank file mybank.rkrb

The Main Screen

rakarrack Main Screen

Connecting

The connections shown in the screenshot correspond to a motherboard sound card. The guitar is connected to the input line. Obviously this configuration can vary depending of your sound card. RAKARRACK has two inputs to allow use of stereo devices. The screenshot shows the connection of a guitar, usually mono aural.

rakarrack Qjackctl Connect

Presets & Banks

The state of the rack can be saved to a file at any time, either pressing the "Save" buttons or via the menu File->Save Preset. Rakarrack suggest the preset name for the filename.rkr in the save operation, but you can put what you want. You can assign the preset name here:

rakarrack Preset Box

If the user modifies any preset bank, The "compare" button allows you to compare the sound of the current state of rakarrack with the original bank preset from which it departed.

You can use banks to store groups of presets. 80 preset can be saved on a bank. To include a preset in a bank must first indicate the name of preset on the main screen, open the bank window and click on a empty slot with the right mouse button. To retrieve a preset stored in a bank must open the window of banks and clicking the left button on the preset desired, also you can use the Preset selector of the main window.

To save a preset in a bank:

To retrieve a preset from a bank:

When rakarrack starts always load the bank selected in preferences unless you specify another bank in the command line. Of course you can load/save any bank via menu File. By default, is allocated in preferences the installation included bank. This bank ("Default.rkrb") is installed with root properties, then you can't overwrite as user. But is easy to save in any place to work with it. The bank contains default presets developed by the development team and some friends who have contributed in this facet.

rakarrack Bank Window

Up the Bank windows screenshot, the tittle bar show the loaded bank. Click on preset or use preset counter in the Preset section to change the preset.

Presets marked with (*) use the Select mode in the Harmonizer effect, that means you need to play a monophonic melody in the Key/Chord selected. The harmonizer recognizes what note you play and creates a second voice in the Key/Chord selected.

Preferences (Settings)

rakarrack Settings Window

Through the Settings window you can configure different aspects of the application. The colors of he four elements on the screen, background, buttons, labels and leds.

rakarrack buttons color    rakarrack background color    rakarrack leds color    

Also you can select the following schemes of widget decoration, X11, fltk, gtk+ y plastic. Some small example of fltk and plastic.

srakarrack chema fltk  rakarrack schema gtk+

Audio

Preserve Gain/Master

The Input Gain and Master Volume are stored in the preset, activating this option the Input Level and Master Volume was not modified when preset changes

Harmonizer Quality

Selects the quality of the harmonizer audio engine,  the available values are "4,8", the default value is "4". Incrementing the quality increments the CPU usage by this effect. This parameter will take effect the next time you run rakarrack.

MIDI

Here you can select if you want to auto connect the rakarrack MIDI IN to another device when the program starts, and you can select the device, also when the program is running you can connect here o use other utilities to do that.

Jack

Here you can select if you want to auto connect the Jack output ports, you can select the ports available, the number of selected ports needs to be an odd number.

Misc

Here you can define a nickname that was recorded in the presets that are created. The development team intends to create banks of effects created by users. These presets should assume the same license with which this program is released (GPL version 2 or higher) and suggest carrying an identification in the form First Name Last Name (nick). Of course you have to give a descriptive name to your preset. If you have a good preset and want to share or want to be included in future versions, send it to this address holborn@users.sourceforge.net

Bank

Here you can specify what file bank is loaded when program starts.

Shortcuts

We created a few shortcuts to make it easier to manage the program.

Key Function
R Enable rakarrack
T Enable Tuner
M Enable MIDI Converter
L Open the load preset window
S Open the save preset window
B Open the bank window
I Open the Settings window
O Open the Order window
N New preset
P Compare
F1 Open the Help window

The effects are enabled pressing the keys (1,2,3,4,5,6,7,8,9,0) . These keys are unrelated to the effects but with his position. So the key 1 trigger the effect that in the first position (the first effect of the left in the first line) and so on until 0 (the latter effect to the right in the second line).


EFFECTS

Return to Top

The chain has seventeen effects, you can select any of the available effects: Linear EQ, Compressor, Distortion, Overdrive, Echo, Chorus, Phaser, Flanger, Reverb, EQ parametric, WahWah, Alienwah, Cabient, Pan, Harmonizer, MusicDelay and NoiseGate. Ten can be used simultaneously. It cascading process, following the order that appears on the screen, from left to right and top to bottom. The order is configurable by the user via the button "Put in your order Rack" giving access to this screen. The effect selected moves up or down using the arrows. The double arrow button interchange the selected effects between the two browsers.

rakarrack Order Window

The effects have two common elements. The "On" button and "Preset" input choice. These individual effect presets are not modified by the user and in most cases are those that Octavian Paul Nasca defined for the purposes of ZynAddSubFX. The value of preset individual is not stored in presets general and can not relate to the parameters in effect.

Parameter Adjustement

    All the parameters managed with a slider widget can be adjusted fine with the mouse wheel or the Up/Down - Left/Right arrows in the keyboard, also you can navigate and adjust trough the parameters with you computer keyboard with the Tab, Up/Down arrow and space bar keys.


MIDI Control

    For control the parameter values via MIDI see the MIDI Implementation Chart  for the complete list of MIDI message commands recognized.



EQ Lineal

rakarrack Lineal EQ Adapted from the ZynAddSubFX Equalizer.

Compressor

rakarrack Compressor Adapted from the ArtsCompressor Compressor.

Distorsion

rakarrack Distorsion Adapted from the ZynAddSubFX Distorsion

Overdrive

rakarrack Overdrive Adapted from the ZynAddSubFX Distorsion

Echo

rakarrack Echo Adapted from the ZynAddSubFX Echo

Chorus

rakarrack Chorus Adapted from the ZynAddSubFX Chorus

Phaser

rakarrack Phaser Adapted from the ZynAddSubFX Phaser

Flanger

rakarrack Flanger Adapted from the ZynAddSubFX Chorus

Reverb

rakarrack Reverb Adapted from the ZynAddSubFX Reverb

EQ Parametric

rakarrack Parametric EQ Adapted from the ZynAddSubFX Equalizer

Cabinet Emulation

rakarrack Cabinet

  New Effect using the ZynAddSubFx Equalizer engine

AutoPan/Stereo Expander

rakarrack AutoPan

New Effect

Harmonizer

rakarrack Harmonizer

Intelligent Harmonizer Explained

Rakarrack harmonizer effect use the audio engine of the smbPtichShifter.cpp located at http://www.dspdimension.com. In order to save CPU use only a mono pitch-shifter in the lowest quality available, you can change this on the program Settings window, but only for a low quality values because high quality ones use too much CPU. The audio signal converted to mono is send it to the pitch-shifter and returned to the two pole Peak filter, panned and send it to both channels L/R. The rakarrack Harmonizer has 3 modes:

Normal Mode

Is how a normal pitchshifter run, the pitch ratio is fixed and can be selected in the Interval effect parameter of the effect.

Select Mode

In this mode the pitch ratio is variable, this value depends of the selected Interval parameter, and the Note and Chord effect parameters. Rakarrack then recognize the audio note played (Only "melodies" monophonic data can be played in this mode) and modifies the pitch ratio in order to do a musical harmonization with the Tonality/Chord selected in the parameters, of course the twelve tonality's are available and 33 chords:

,6,Maj7,lyd,Maj(9),Maj7(9),6/9,+,m,m6,m7,m7(b5),m9,m7(9),m7(11)
,m(Maj7),m(Maj7)(9),dim,dim7,7,7(Sus4),7(b5),7(9),7(#11),7(13),7(b9)
,7(b13),7(#9),+Maj7,+7,1+8,1+5,(Sus4),2

MIDI Mode

This mode run in the same way as Select Mode but the Tonality/Chord is recognized via MIDI notes, the MIDI chord recognizer recognizes all the above chords plus all the inversions and bass changed chords, also has memory, they use the chord just another chord is send it and recognized. The MIDI channel can be selected in the Settings window, then the Harmonizer adjust the pitch ratio with the audio note recognized, played by the user, and the Tonality/Chord received via MIDI. (Sequencer track ... )



Musical Delay

rakarrack Musical Delay

Musical Delay Explained

The musical delay effect is a dual line delay, the word "musical" is due that you can adjust the delay time in both lines in a musical terms, with Tempo effect parameter, and the Delay1, Delay2, Delay3 effect parameters.

The Delay lines are measured in fractions of quarter notes at the Tempo selected. That means 1/2 is an Eighth note and 1/4 is a Sixteenth note. (1,1/2,1/3,1/4,1/5,1/6) are the possible values, that include eighth triplets, etc.

The center delay parameter, is the delay between the two delay lines, and is the only one can be set equal to zero.

The Tempo effect parameter value range is big (10~480) that's for admit half or double song Tempo in order to obtain largest or shortest delays.

Off course you have Gain, Pan and Feedback parameters for each delay line in order to adjust the desired effect.


Noise Gate

rakarrack Noise Gate

New Effect based on Gate, Steve Harris LADSPA plugin.

WahWah

rakarrack WahWah

  Adapted from the ZynAddSubFX DynamicFilter

Alienwah

rakarrack Alienwah

Adapted from the ZynAddSubFX Alienwah


MIDI Converter

Return to Top

This is a experimental monophonic MIDI converter. The parameters are not stored on presets but are saved as preferences and is remembered each time you start the program.

The most important thing for a better results is tune your guitar. You need to connect with qjackctl or whatever Alsa-Seq connect utility the rakarrack MC OUT port to a synthesizer or sequencer device in order to produce sound or record something.

The Triggerparameter controls the volume passed to the note recognition algorithm.

The Velocity is for adjust the MIDI velocity sensitivity message send.

The Channel is the channel selected for the MIDI message, of course.

rakarrack MIDI Converter

TUNER

Return to Top

rakarrack Tuner

When "Your frequency" is outside the acceptable range is shown in red.


Credits

Return to Top

Rakarrack Team


Presets


Thanks to:



MIDI Implementation Chart

Return to Top

Program Change ( x ) 0~80
Control Change Volume 0x07 (x) 1~127

Modulation 0x01 (x) 1~127 (WahWah Depth)

Undefined 0x14 (x) 1~127 (Alienwah Depth)

Undefined 0x15 (x) 1~127 (Phaser Depth)

Undefined 0x16 (x) 1~127 (Flanger Depth)

Undefined 0x17 (x) 1~127 (Chorus Depth)

Undefined 0x18 (x) 1~127 (Musical Delay Gain 1)

Undefined 0x19 (x) 1~127 (Musical Delay Gain 2)

Undefined 0x1A (x) 1~127 (Harmonizer Freq)

Undefined 0x1B (x) 1~127 (Harmonizer Interval)

Undefined 0x1C (x)
1~127 (Wah Wah Wet/Dry)

Undefined 0x1D (x)
1~127 (Overdrive Wet/Dry)

Undefined 0x1E (x) 1~127 (Distortion Wet/Dry)

Undefined 0x1F (x) 1~127 (Harmonizer Wet/Dry) 

Undefined 0x2E (x) 1~127 (Echo Pan)

Undefined 0x2F (x) 1~127 (Overdrive Pan)

Undefined 0x30 (x) 1~127 (Distortion Pan)

Undefined 0x31 (x) 1~127 (Harmonizer Pan)

Undefined 0x32 (x) 1~127 (Chorus Pan)

Undefined 0x33 (x) 1~127 (Flanger Pan)

Undefined 0x34 (x) 1~127 (Chorus Wet/Dry)

Undefined 0x35 (x) 1~127 (Flanger Wet/Dry)

Undefined 0x36 (x) 1~127 (Phaser Wet/Dry)

Undefined 0x37 (x) 1~127 (Alienwah Wet/Dry)

Undefined 0x38 (x) 1~127 (Musical Delay Wet/Dry)

Undefined 0x39 (x) 1~127 (Reverb Wet/Dry)

Undefined 0x3A (x) 1~127 (AutoPan/Extra Stereo Wet/Dry)

Undefined 0x3B (x) 1~127 (Echo Wet/Dry)

Undefined 0x3C (x) 1~127 (Phaser Pan)

Undefined 0x3D (x) 1~127 (Alienwah Pan)

Undefined 0x3E (x) 1~127 (Musical Delay Pan 1)

Undefined 0x3F (x) 1~127 (Reverb Pan)

Undefined 0x41 (x) 1~127 (Musical Delay Pan 2)

Undefined 0x42 (x) 1~127 (WahWah Pan)

Undefined 0x43 (x) 1~127 (AutoPan/Extra Stereo Pan)

Undefined 0x44 (x) 1~127 (Overdrive Drive)

Undefined 0x45 (x) 1~127 (Distortion Drive)

Undefined 0x46 (x) 1~127 (Overdrive Level)

Undefined 0x47 (x) 1~127 (Distortion Level)

Undefined 0x48 (x) 1~127 (Chorus Freq.)

Undefined 0x49 (x) 1~127 (Flanger Freq.)

Undefined 0x4A (x) 1~127 (Phaser Freq.)

Undefined 0x4B (x) 1~127 (WahWah Freq.)

Undefined 0x4C (x) 1~127 (Alienwah Freq.)

Undefined 0x4D (x) 1~127 (AutoPan/Extra Stereo Freq.)

Undefined 0x4E (x) 1~127 (Echo Fb)

Undefined 0x4F (x) 1~127 (Chorus Fb)

Undefined 0x50 (x) 1~127 (Flanger Fb)

Undefined 0x51 (x) 1~127 (Phaser Fb)

Undefined 0x52 (x) 1~127 (Alienwah Fb)

Undefined 0x53 (x) 1~127 (Musical Delay Fb 1)

Undefined 0x54 (x) 1~127 (Musical Delay Fb 2)

Undefined 0x55 (x) 1~127 (Overdrive LPF)

Undefined 0x56 (x) 1~127 (Distortion LPF)

Undefined 0x57 (x) 1~127 (Reverb LPF)

Undefined 0x58 (x) 1~127 (Overdrive LPF)

Undefined 0x59 (x) 1~127 (Distortion HPF)

Undefined 0x5A (x) 1~127 (Reverb HPF)

Undefined 0x5B (x) 1~127 (Chorus LR_Cr)

Undefined 0x5C (x) 1~127 (Flanger LR_Cr)

Undefined 0x5D (x) 1~127 (Phaser LR_Cr)

Undefined 0x5E (x) 1~127 (Overdrive LR_Cr)

Undefined 0x5F (x) 1~127 (Distortion LR_Cr)

Undefined 0x60 (x) 1~127 (Alienwah LR_Cr)

Undefined 0x61 (x) 1~127 (Echo LR_Cr)

Undefined 0x62 (x) 1~127 (Musical Delay LR_Cr)

Undefined 0x63 (x) 1~127 (Chorus St_df)

Undefined 0x64 (x) 1~127 (Flanger St_df)

Undefined 0x65 (x) 1~127 (Phaser St_df)

Undefined 0x66 (x) 1~127 (WahWah St_df.)

Undefined 0x67 (x) 1~127 (Alienwah St_df.)

Undefined 0x68 (x) 1~127 (AutoPan/Extra Stereo St_df.)

Undefined 0x69 (x) 1~127 (Chorus Rnd)

Undefined 0x6A (x) 1~127 (Flanger Rnd)

Undefined 0x6B (x) 1~127 (Phaser Rnd)

Undefined 0x6C (x) 1~127 (WahWah Rnd.)

Undefined 0x6D (x) 1~127 (Alienwah Rnd.)

Undefined 0x6E (x) 1~127 (AutoPan/Extra Stereo Rnd)

Undefined 0x6F (x) 1~127 (WahWah Amp S.)

Undefined 0x70 (x) 1~127 (WahWah Amp S.I.)

Undefined 0x71 (x) 1~127 (WahWah Smooth)

Undefined 0x72 (x) 1~127 (Phaser Phase)

Undefined 0x73 (x) 1~127 (Alienwah Phase)