README.md
1tamgamp.lv2 - Guitar amplifier simulator
2========================================
3
4
5
6**Tamgamp** (*Rhymes with:* "Damage Amp") is LV2 guitar amp simulator that provides two plugins:
7* Tamgamp - a plugin based on Guitarix DK Builder simulated chains.
8* TamgampGX - a plugin based on tuned Guitarix internal amplifiers implementation.
9
10The key features of this project according to initial technical requirements are:
11* Simplicity of the interface, no UI (use generic one), minimum knobs/sliders.
12* Preamplifier simulation only, for simplicity and flexibility (use a separate cab simulator).
13* Smooth bypass/automation. No pops, spikes or clicks.
14* Normalized output level: different amplifiers should sound almost of the same output loudness with different gain settings.
15
16The plugin simulates the set of the following guitar amplifiers:
17
18* Fender Princeton Reverb-amp AA1164 (without reverb module)
19* Fender Twin Reverb-Amp AA769 (Normal channel, bright off)
20* Fender Twin Reverb-Amp AA769 (Vibrato channel, bright on)
21* Marshall JCM-800 High-gain input
22* Marshall JCM-800 Low-gain input
23* Mesa/Boogie DC3 preamplifier (lead channel)
24* Mesa/Boogie DC3 preamplifier (rhythm channel)
25* Mesa Dual Rectifier preamplifier (orange channel, less gain)
26* Mesa Dual Rectifier preamplifier (red channel, more gain)
27* Peavey 5150II crunch channel
28* Peavey 5150II lead channel
29* VOX AC-30 Brilliant channel
30* VOX AC-30 normal channel
31
32This project simulates only preamplifier chains and does not attempt to do any cab simulation,
33so for proper sounding you need to additionally apply equalization or pre-captured impulse responses
34of different cabinets.
35
36For example, you may use the following tools for cabinet simulation:
37* LSP Impulse Responses Mono - https://lsp-plug.in/?page=manuals§ion=impulse_responses_mono
38* LSP Impulse Reverb Mono - https://lsp-plug.in/?page=manuals§ion=impulse_reverb_mono
39* x42 Convolver - https://github.com/x42/convoLV2
40* Guitarix convolver - https://guitarix.org/
41* LV2 Convolution Reverb - http://tomszilagyi.github.io/plugins/ir.lv2/
42
43Authors
44------------
45
46* The Tamgamp.lv2 project originated by Cyrus Adkisson.
47* Tamgamp source code developed by Vladimir Sadovnikov <lsp.plugin@gmail.com>.
48* DK Builder and Guitarix project are developed by Guitarix Team <http://guitarix.org/>:
49 * Hermann Meyer
50 * Andreas Degert
51 * Pete Shorthose
52 * Markus Schmidt
53
54Requirements
55------------
56
57The following tools and libraries are required to build the project:
58 * gcc >= 6.0
59 * zita-resampler
60
61The following additional tools and libraries are required to develop the project:
62 * faust >= 2.15.11
63 * faust-libraries
64
65Usage
66-----
67
68Select the preamplifier simulation using 'Amplifier chain' selector.
69
70Set the 'Amplifier Gain' control to adjust pre-amplification gain. The more
71pre-gain will be set, the more overdrive/distortion of the original signal will be
72at the output.
73
74To correct input/output levels, use 'Input level correction' and
75'Output level correction' respectively.
76
77Adjust the tone by 'Bass', 'Middle', 'Treble' controls (for TamgampGX you need to
78select 'Tone Control Chain' first).
79
80Enjoy!
81
82Install
83-------
84
85The simple installation script looks like:
86
87```bash
88make
89make install
90```
91
92Uninstalling and cleaning:
93
94```bash
95make uninstall
96make clean
97```
98
99
100For developers: to re-generate all automatically generated code, launch:
101
102```bash
103make srcgen
104```
105
106To update file dependencies, launch:
107
108```bash
109make deps
110```
111
112
