README.tkeca
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