1--------------------------------------------------------------------------
2TKECA 4.4.3 - 2003-2011 Luis Pablo Gasparotto
3--------------------------------------------------------------------------
4
5TKECA is a Tcl/Tk frontend for Kai Vehmanen's Ecasound. So you will need
6Ecasound for using it.
7
8For running you will need Tcl/Tk package.
9
10--------------------------------------------------------------------------
11REQUIREMENTS:
12--------------------------------------------------------------------------
13
14ecasound - http://www.eca.cx/ecasound/
15ecatools - http://www.eca.cx/ecasound/
16normalize (included by default in most distros) -
17  http://src.gnu-darwin.org/ports/audio/normalize/work/normalize-0.7.7/
18TCL/TK Package (Tested with 8.4)
19
20For using LADSPA plugins you will need:
21listplugins (LADSPA SDK) - http://www.ladspa.org/
22analyseplugin (LADSPA SDK) - http://www.ladspa.org/
23Ecasound compiled with Ladspa support - http://www.ladspa.org/
24
25Recommended:
26jackd - http://jackaudio.org/
27timidity (You'll need it if you want to play MIDI tracks) -
28  http://timidity.sourceforge.net/
29
30--------------------------------------------------------------------------
31Changes:
32--------------------------------------------------------------------------
33
340.2.0-0.2.1	Visual changes
35		A lot of alert messages
36		Unlimited tracks (I need to add a scroll bar)
37		Top buttons layout
38		Mixdown to file
39		Pause/Continue button
40		Export to .ecs button
41		"Save as" button
420.2.1-0.4.0	Ladspa plugins support
43		The way that tkeca deals with effects was changed
44		Some changes in the script
45		You don't need to type "wish" anymore (Thanks to Kai
46		    Vehmanen)
470.4.0-0.4.1	Effects Preview
480.4.1-0.4.2	Scrollbar in the tracks frame added.
49		Visual changes
50		Mixdown bug solved
51		Browsers starts in .
520.4.2-0.6.0	Options button works. Allows to edit ecasoundrc file
53		Entry for selecting current directory
54		Bug fixes on "Save as" button, open file when there was an
55		    existing project, play when choosing a different
56		    device
57		Autodetect external wave editor and ladspa directory
58		Visual changes in effect windows
590.6.0-0.8.0	Recording/Mixdown properties windows
600.8.0-0.8.1	Alert when trying to make mixdown with no tracks
61		Bug when opening more than one Recording properties
62		    windows fixed
630.8.1-0.8.2	Bug when trying to export .ecs with checked Rec box
64		Bug when playing recorded tracks
65		Add quotes when filename contains spaces
660.8.2-1.0.0	GUI changes
67		Each track can contain more than file (takes), each take
68		    can be placed in a desired time and processed during
69		    a defined time("Wave Info" button opens a new window)
70		Each take have a "Wave Edit" button
71		Each take can be seted to Play or Record but it always
72		    will depends of the track status (Main window)
73		mfe file format was changed, no compatibility with
74		    previous versions
75		"Wave Edit" button was changed for "Eca Tools" because now
76		    wave edit works with each take and Normalize and Dc
77		    Fix works with all track takes. The "Wave Edit" button
78		    was added to "Wave Info" window
79		The Play+Record button was eliminated and replaced for the
80		    "Recording" checkbutton
81		The "Play" button changes to "Stop" button when playing
82		    tracks
83		Added buttons to modify the starting position
841.0.0-1.0.1	Tkeca was released under GNU General Public License (GPL)
85		Added file license.txt
861.0.1-1.0.2	Bug when ecasoundrc wasn't in ~/.ecasoundrc
87		    (Thanks to Kai Vehmanen)
88		Bug when no LADSPA directory was defined in .ecasoundrc
89		    (Thanks to Kai Vehmanen)
901.0.2-1.2.0	Bug in "Options" button (.ecasoundrc related)
91		"Save File" stores "Current Directory" and "Recording"
92		Up to 16 channels
93		Added ALSA and JACK devices to the "Dev." button
94		Added "Chn." for selecting source for multichannel cards
95		Added "Del Last Track" button
96		Added "Del All Tracks" button
97		Added "Prop" button for track properties
98		Added automatic wave file length parse using Ecalength
99		The way that Tkeca build the Ecasound command was
100		    improved
101		Bug when panning mono files
1021.2.0-1.4.0	Opening "Track Properties" window is no longer when
103		    checking the "Rec" check box. Now use the "Prop"
104		    button
105		Bug when deleting tracks: "Waves" info keeps the old
106		    wave files information
107		Mute and unmute tracks in real time
108		Volume slide works in real time
109		Pan slide works in real time
110		"Play" checkbox was replaced by "Mute" checkbox, it works
111		    only with the takes marked as "Play". It has no effect
112		    with the takes marked as "Rec"
113		Parse current position when pressing the Stop button
1141.4.0-1.6.0	Added "Bypass" effect checkbox. You can use it in real
115		    time.
116		Effects parameters can be modified in real time.
117		Bug when "Edit Current Effect"
118		Bug when using Volume and Pan in real time
1191.6.0-1.8.0	Added Locate window with up to 16 preset positions
120		Added detection of wrong versions of mfe files
121		"Del All Tracks" function was changed by "Close"
122		Destroy associated Wave files windows when deleting tracks
123		    or close
124		Added "Lose changes" warning when opening a new file over
125		    an already opened file
1261.8.0-2.0.0	Real time position clock (it's only for reference, it's
127		    not a precision tool). When stop playing/recording the
128		    clock values are replaced by the output of Ecasound's
129		    "dump-position", this is the real position
130		Automatic file name extension
1312.0.0-3.0.0 	Tkeca don't use ewf files anymore, now each track has only
132		    one associated wave file. This is because sometimes
133		    ewf files generates sync problems
134		Allows to start recording in the middle of a wave file
135		Punch-in and punch-out positions in the locate window
136		    (Thanks to Rocco for suggest this feature and helping
137		    me to test it)
138		Automatic "Go to 00:00" after punching and after
139		    play/record for a time longer than the longest wave
140		    file
141		Effect menu was improved, now you can see the name of the
142		    attached effect and it status.
143		Added "Wave File Delete" command to Tools button
144		Automatic filename extension when exporting to .ecs
145		"Exported to..." message after exporting to ecs
146		Enlarged pan and volume faders
147		Enlarged "Options" window
148		The way Tkeca generates the chainsetup was improved
149		"Time Format" button was added. It allows to switch
150		    between MM:SS and SSSS. Useful for old Ecasound users
151		    who use to work with Seconds
152		"Wave Files" window no longer in this version
153		The main window was simplified
154		The general "Recording" checkbox was eliminated
1553.0.0-3.2.0	Bug when Fw 5'' and Rew 5'' in Seconds Format
156		Bug in LADSPA effects that use srate. Tkeca assumes 44100
157		    (Thanks to Mark de Wever for report this bug)
158		Bug in effects names when loading an saved file.
159		    (Thanks to Mark de Wever for report this bug)
160		Pre-roll using temporary files
161		Metronome (like an effect)
162		html User Manual
1633.2.0-3.2.1	Bug when opening projects mfe(volume_position1)
164		    not defined.
165		Bug when generating instructions for Ecasound
1663.2.1-4.0.0	Bug when opening file over an already open file
167		Bug when changing plug-ins parameters in real time.
168		Bug in the File entry box.
169		"Default" device option uses the default output of
170		    ecasoundrc
171		"Solo" button.
172		"Del" current track button.
173		Ut to 8 effects in each track.
174		Save the effects status.
175		Added Ecasound preset effects (10 band Eq and more)
176		Track name box
177		Disable "Rec" checkbutton when playing/recording
178		Muted tracks skiped when exporting to .ecs.
179		Some basic mastering tools were added to the
180		    Mixdown Options Window.
181		"Del Last Track" button no longer.
182		Mixdown Options window changed.
183		Effect Windows format changed.
184		Track Recording Properties windows changed.
185		Global Options Window changed.
186		Effect menus changed. Faster and easier access
187		Warning message when trying to add new effects on the
188		    fly, this is not (and never was) allowed.
189		Warning message  when deleting wave files.
190		Compatibility with files created with version 3.0.0 or
191		    later.
192		Cosmetic changes.
1934.0.0-4.0.1	Bug when changing Volume or Pan on the fly.
1944.0.1-4.0.2	Bug in mixdown properties window.
1954.0.2-4.2.0	Main window components expands to fit all available space
196		Bigger Effects window, components expands to fit all available
197		Options window components expands to fit all available
198		Master volume window
199		Tracks header was eliminated
200		Track volume controls max set to 400
201		Bug when adding tracks with one or more previous "Solo" tracks
202		Bug in the Wave File delete warning window
203		Effect windows shows track name in replace of track number
204		Toplevel windows have a more descriptive title
205		Button "Pause" was eliminated
206		Certain buttons get disabled after "Play" button is pressed
207		"Stop" button in Effect windows
2084.2.0-4.4.0	LADSPA Loading Window
209		Main Window is visible during the LADSPA plug-ins loading
210		Message if Tkeca is unable to find ecasoundrc file
211		Processing Mixdown window
212		Master volume control
213		Filenames with spaces are allowed
214		Certain buttons get disabled during mixdown
215		Compressor utility is no longer available for mixdown, it was
216		    useless and buggy
217		Bug: Certain buttons remain disabled after exporting .ecs
218		Bug: Track Properties windows always reset to default
219		    values
220		Bug: Always applying compressor due an "IF" error.
2214.4.0-4.4.2	Installer script
222		Latency compensation
223		Metronome
224		Improved layout on Locate window
225		Cancel button in Mixdown window
226		Improved looking on Mixdown Window/Rec Properties window
227		Improved devices list
228		tkeca.log only stores useful information and can be used as
229		  debugging tool (before size was 21MB now is less than 1KB)
230		Went back to TK default colors but now there's a button for
231		    changing the colors palette
232		Buttons "Rew 5", "Forw 5" and "Go to 00:00" are available when
233		    playing.
234		Certain buttons and entry boxes get disabled when pressing Play
235		Normalize parameters when doing a mixdown
236		Bug: Start and End time not showed in the mixdown window
237		Bug: Recording over an existing file was not possible
238		Bug: Time counter keeps rolling when pressing a locate button
239		Bug: Play still looks for wave files of deleted tracks
2404.4.2-4.4.3	File types include MIDI and mod exts
241		Again compatible with TK 8.4 since this is the current
242		    version for distros like Ubuntu and Debian
243		Bug: Track properties reset to default values everytime
244		Bug: Mixdown properties reset to default values everytime
245		Bug: Global Multichannel properties reset to default values
246		    everytime
247--------------------------------------------------------------------------
248TODO:
249--------------------------------------------------------------------------
250
251- Add a scroll bar in the tracks frame (Done in version 0.4.2)
252- Allows to change global options (Done in version 0.6.0)
253- Allows to change recording properties when checking the Rec checkbox
254(Done in version 0.8.0)
255- Allows to open more then one wave file for track
256	    i.e.  	ding.wav at 00:00
257			dang.wav at 04:00
258			... (Done in version 1.0.0)
259- Add preview feature to the Effects windows (Done in version 0.4.1)
260- Realtime Mute/Unmute tracks (Done in version 1.4.0)
261- Realtime Active / Bypass effects in real time (Done in version 1.6.0)
262- Change effects parameters in real time (Done in version 1.6.0)
263- Parse current position when pressing the Stop button
264    (Done in version 1.4.0)
265- "Solo" button (Done in version 4.0.0)
266- Locate positions (Done in version 1.8.0)
267- Allows to use file names with spaces (Done in version 4.4.0)
268- Master Volume control (Done in version 4.4.0)
269- A decent User Manual
270- Better MIDI support and sequencing features
271- Full featured Mastering interface
272- Hardware latency compensation (Done in version 4.4.2)
273- Vumeters
274- Soundcard detection
275- Track volume time line
276- Track pan time line
277
278--------------------------------------------------------------------------
279Thanks to:
280--------------------------------------------------------------------------
281
282Kai Vehmanen for making Ecasound
283Seymour Shlien for being my Tcl/Tk mentor
284
285--------------------------------------------------------------------------
286Licensing/Distribution Policy
287--------------------------------------------------------------------------
288
289Copyright (C) 2002-2009  Luis Pablo Gasparotto
290
291This program is free software; you can redistribute it and/or modify
292it under the terms of the GNU General Public License as published by
293the Free Software Foundation; either version 2 of the License, or
294(at your option) any later version.
295
296This program is distributed in the hope that it will be useful,
297but WITHOUT ANY WARRANTY; without even the implied warranty of
298MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
299GNU General Public License for more details.
300
301You should have received a copy of the GNU General Public License
302along with this program; if not, write to the Free Software
303Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
304
305See 'license.txt' file for details
306
307http://tkeca.sourceforge.net
308Contact: lpgasparotto@gmail.com
309