Adding stereo plugins, fixed LADSPA menus, ignoring NON-RT plugins - Alex
[terminatorX.git] / ChangeLog
1 terminatorX - ChangeLog
2 All changes were done by me (Alexander König) if not stated otherwise.
3 This is not a GNU-style ChangeLog but you sort of get the idea what was
4 changed.
6 [v3.82] (pre-release)
7 - applied a fix from Juha Erkkila <> that makes tX work on
8   systems that don't have procfs mounted.
9 - added an optional Dry/Wet control for all LADSPA plugins. Simply click on the
10   plugin's label to add or remove the additional control.
11 - added an additional stereo effects queue that allows loading stereo LADPSA 
12   plugins. The stereo effects are located below the mono effects - to add a new
13   instance press the "Stereo FX" button and select the plugin of your choice.
14 - fixed the plugin menu - empty categories no longer get a menu entry.
15 - plugins that do not qualify as realtime capable will now be disabled.
17 [v3.81]
18 - JACK doesn't seem to like SCHED_FIFO clients so I added a little test that
19   will set SCHED_OTHER when jack output was selected. This will work for true
20   root or a capabilities-enabled suid-root binary only.
21 - removed the disfunctional "Cancel" button from the load-progress dialog.
22 - switched default MIDI mapping to non-destructive. (previous settings will not
23   be overwritten now).
24 - added a default MIDI mapping accessible via the "Turntables" menu. The actual
25   mapping is documented in the manual.
26 - fixed a bug that caused enabling sync-client setting via MIDI to fail.
27 - when compiled with rt-scheduling suppport terminatorX will now display the 
28   resulting scheduling policy in the "About" dialog.
29 - if terminatorX was setup to use realtime priority for the audio engine thread
30   but you dont want it - disable realtime scheduling in the Preferences dialog.
31   This works with capabilities _ONLY_.
32 - if you don't want to confirm program termination every time you can now
33   disable "Ask for Quit confirmation" in the Preferences.
34 - added support for Linux' POSIX capabilities. This allows a suid-root installed
35   terminatorX binary to drop root privileges much earlier than with the old
36   approach (so it should be more secure). Requires the libcap library.
37 - obligatory documentation updates - clicking on the sub-sections should now 
38   work.
39 - removed gtk+ 1.2 cruft - terminatorX now compiles with gtk+ 2.2 and
40   *_DISABLE_DEPRECATED macros enabled. To verfiy that you can run 
41   configure with --disable-deprecated.
42 - terminatorX now has a JACK backend. Currently it works like this: on startup
43   tX will connect to the JACK daemon - if the daemon is not available on 
44   startup JACK output is not available. When the audio engine is turned off,
45   tX emits silence via the JACK ports, so you can leave the ports connected. 
46 - sick of green - you can now configure the colors terminatorX should use for 
47   the audio display as well as the vu meters in the Preferences dialog.
48 - hopefully fixed wrong setting of the master volume when loading set files.
49 - some ALSA installations seem to core on snd_pcm_hw_params_free() after sound
50   device init. So freeing the hw_params can now be explicitly disabled in
51   the Preferences - if terminatorX crashes right after hitting the "Power On"
52   button it might be necessary to activate this for your ALSA setup. This
53   probably results in a tiny memory leak - but on leak vs core you might decide
54   for leak. Note: I even enabled the leak by default now.
55 - fixed a bug that caused turntable 1 to get the focus on entering Mouse Grab
56   mode even when it's audio panel was minimized.
57 - MIDI mappings can now have "bounds", meaning that the incoming MIDI signals
58   can modify the parameter within the given range only.
59 - introduced a new way of assigning MIDI controllers to parameters: simply 
60   right-click on a parameter's control: a menu with "MIDI Learn" and 
61   "Remove MIDI Binding" will pop up - select "MIDI Learn" and send the 
62   corresponding MIDI event.
63 - fixed a bug in the MIDI callback thanks to David Hamilton 
64   <>
65 - running suid root (the old way) was reported exploitable by Andrew Griffiths
66   <> - the described environment variable based exploit 
67   was fixed - however there are possibly other ways to exploit it. So the 
68   old method of running suid root has been disabled by default. On Linux 
69   systems you really should use the capabilities based approach (see above).
70   If really want to use the old suid-root solution run configure with 
71   --enable-suidroot.
72 - often, you record events and mess things up - in this case I'd often prefer 
73   dropping the complete take instead of recording a bad perfomance - which is 
74   why you now can activate "Confirm Recorded Events" from the "Sequencer" menu.
75   When enabled terminatorX will ask whether to actually record or drop the 
76   events created for the last take. The setting for this flag is stored in your
77   ~/.terminatorXrc.
78 - introduced a new "Sequencer" menu that allows to delete events of a specific
79   type (all, all for certain turntable, all for a certain parameter) from the
80   sequencer. Events can be deleted for the complete song, upto the current song
81   position or from the current song position. Yeah, I know, termintorX is 
82   lacking a proper event-editor here, so where's your patch? ;)
83 - switching the X11 mouse cursor when the user has to wait for terminatorX to 
84   finish some operation
85 - fixed a sequencer bug: the events for master pitch and volume weren't erased
86   correctly when another set was loaded
87 - fixed FreeBSD issues with the configure script
88 - fixed compilation issues for gcc 2.95.x
90 [v3.80]
91 - I've invested quite some time in valgrinding this release, among other things
92   a major mem leak showed up - the sample memory wasn't being free'd correctly
93   which is now corrected along with many other things. valgrind is a very 
94   helpful tool indeed.
95 - Added a new Pitch Calculator that allows adjusting a turntable's pitch to that 
96   of the master turntable. This makes synchronizing finely cut loop samples
97   really easy
98 - XML based set files can get rather huge when they contain a lot of sequencer
99   events - to solve this terminatorX now uses zlib to save compressed set
100   files if enabled in the preferences dialog.
101 - I hacked support for Steve Harris' cool liblrdf - if you've got that library
102   setup correctly and you use Steve's wonderful plugin collection with RDF 
103   description you should get a nicely structured menu when clicking on the
104   "FX" button. All plugins not categorized through RDF files go to the 
105   "Unclassified" category.
106 - I'm no longer including the html and ps versions of the manual - it's now
107   attached in it's XML/DocBook source and will be installed via scrollkeeper.
108   terminatorX offers a menu entry to start gnome-help to display the manual.
109 - Reworked the Preferences dialog - I now use glade-2 to create that code -
110   I'm fed up with copy'n'pasting gtk+ code so now I'll let glade-2 do this 
111   whereever possible. The glade project files are included with this tarball
112   in case you want to mess with them.
113 - Switched to a fixed blocksize (1 ms) for rendering. This finally allows to
114   playback set files with events recorded on machines with small buffer sizes
115   on slow machines with large buffer sizes. The buffersize of the audiodevice
116   has no effect on the "operating" blocksize anymore.
117   Note that the samlping rate has a - very small - effect though. Depending on
118   the sampling rate terminatorX will try to find a blocksize that fits exactly
119   1 ms - while this is easy for "straight" sampling rates (22000 32000 48000)
120   this results in "44.1" samples for 44100 Hz.
121 - Finally hacked a native ALSA backend. It's in "Works For Me" TM state.
122 - Added "Remove Binding" button
123 - MIDI now uses a GIOCallback so the effect of MIDI controllers is visible
124   even without the audio engine turned on.
125 - Reworked the mastergui for better usabilty and less space consumption, yes,
126   terminatorX now features a boring menubar - which helps using it on small
127   displays quite a bit, and should be easier to handle for first-time users.
128 - Implemented a suggestion from Darrick Servis <> that
129   stops clipping in the mixer routine. The outgoing signal is now limited as it
130   should be, which improves the output quality for signals too loud
131   significantly.
132 - MIDI mappings are now stored within the (new) tX set files.
133 - Applied a patch from Arthur Peters <> which brings
134   preliminary MIDI support to terminatorX. This is realized via the ALSA
135   sequencer interface, so in order for it to compile you have to have
136   the ALSA devel packages installed. ./configure will autodetect them.
137 - Fixed a bug in XML serialization that dropped strings' contents.
138 - You can now hit "F11" to turn fullscreen mode on/off - this will help using
139   terminatorX on small DJ laptops. Note that the key will have no effect in 
140   scratch mode - hit it before you enter grab mode. This feature requires a 
141   NETWM compliant window manager.
142 - terminatorX now stores set files as XML documents, too - so terminatorX has
143   become terminatorXML finally. Note: for sets with a large number of events
144   recorded into the sequencer - the XML based set files can grow significally
145   larger than the old ones (see "compression" above)
146 - The old code to support the obsolete binary tX file formats has now been
147   scheduled for deletion. It's been moved into the tX_legacy* source files and 
148   it will be built only when "--enable-legacy" was used on configuring
149   terminatorX (which is the default). Expect this to become disabled and then
150   totally removed from the sources in future.
151 - Enhanced audio data display - you can now zoom into the audio signal, which
152   should allow much more precise scratching with larger audio files (ie 
153   complete tracks). On playback terminatorX will scroll the displayed area
154   to ensure you always see the area of the sample in which you're currently
155   scratching on.
156 - I have not backported the new code to the old gtk+ 1.2 - so this release no
157   longer builds with gtk+ 1.2 - you have to upgrade to gtk+ Version 2 to be
158   able to build terminatorX.
159 - fixed a nasty gcc 3.2 compilation bug - thanks to 
160   Adam Duck <> and other reporters
162 [v3.73]
163 - Fixed a compilation bug ocurring on big endian systems only.
164 - Fixed the built-in wav loading routines for big endian systems (again).
165 - Finally traced down and fixed a long outstanding bug in the dial widget,
166   the background of the dials is now drawn correctly.
167 - Ported terminatorX to gtk+ Version 2. The code for gtk2 will be enabled
168   when gtk2 is detected by configure. To force terminatorX to use the good
169   old gtk 1.2.x (x>=5) run configure with the '--disable-gtk2' switch.
170   WARNING: gdkxft-users: gtk2 applications segfault when preloading
171! So unset LD_PRELOAD and set GDK_USE_XFT=1 instead.
172 - Applied a patch from Adrian that brings lots of new stuff:
173   - Debian package support (removed - Mike Furr now maintains an official 
174                             Debain package for terminatorX)
175   - enhanced GNOME integration
176   - a manpage for terminatorX
177 - Included another gcc3 fix thanks to Gregor Riepl <>
178 - Improved configure's compatibilty - it should detect pthreads more reliably
179   and it should detect ladspa.h when located in /usr/local/include without
180   /usr/local/include being contained in the include path.
181 - This release should compile and run on FreeBSD systems and possibly
182   OpenBSD, too. Thanks for help and testing this goes to 
183   Tilman Linneweh <>.
184 - Sequencer now refuses to play when no events available - and displays
185   a dialog that suggests running the audio engine.
186 - De-uglified the terminatorX note dialog.
187 - Fixed gtk+2 signals for load file dialog
188 - Pre-listen support for mpg321
189 - Added a new auto-hiding "panel-bar" to which turntable control and audio
190   panels can be minimized to.
191 - Cleaned up the turntables' audio panel for better looks and easier usage
192 - Rewrote the engine thread completely - unlike before the engine thread 
193   is created on startup and kept alive until termination.
194 - terminatorX can now be run suid root - and it might even be safe. After
195   creating the engine thread both terminatorX threads drop root privileges
196   before evaluating any parameters or reading/writing files, etc. The problem
197   is the pthread "manager thread" is out of control of terminatorX code - so
198   I cannot tell that thread to drop privileges.
199 - Fixed Drag'n'Drop for GNOME 2
200 - To enhance the loading of audiofiles terminatorX now contains code to use
201   mad (MPEG Audio Decoder), libvorbis and libaudiofile directly instead of 
202   pipeing audio data through mpg123, ogg123 or sox. As a result the new routines
203   bring following advantages:
204         - tX loads audiofiles significantly faster
205         - tX now honours the samplerate of an audiofile
206           (by adjusting the pitch of the turntable)
207         - tX provides much better feedback on the loading progress
208   Although the old loading-methods are still available (and piped loading has
209   been improved, too) I highly recommend installing the libraries above as the
210   new routines simply work better.
211 - Deleted tons of old outdated code in and
213 [v3.72]
214 - Applied a patch from Matthew Evans <> that introduces 
215   support for Ogg Vorbis audiofiles. It requires ogg123 > RC2 and sox to work.
216   Autodetection is supported via configure (--enable-ogg123).
217 - Experimental support for input devices other than the core-pointer
218   under XFree86 > 4. This uses the xsetpointer executable that comes with
219   XFree86. configure should autodetect this correctly, in case it doesn't
220   use the --enable-xetpointer switch.
221 - Adrian sent me a patch introducing two new buttons: mute and solo. As it
222   didn't fully harmonize with the sequencer I rewrote parts of it and added new
223   functionality to the turntables: They can now be switched to mix_solo or
224   mix_mute - these settings affect current mixing only - their values will
225   neither be saved nor will changes to those control be recorded in the
226   sequencer - if you want to record muting events either use the mute button
227   from the turntable's trigger menu, the keyboard short-cuts (alt/strg), or
228   your middle mouse button.
229 - fixed a bug that produced corrupt wavfiles on big endian machines
230 - some minor fixes to make terminatorX compile with newer gcc releases
231 - Well, I am allowed to change my mind, aren't I? Anyway, 3DNow! is back.
232   Nevertheless newer gcc releases seem to have a bug in handling movq and
233   the current 3DNow! stereo implementation does not seem to be very efficient.
234   So use --enable-3dnow only if you want to help me improve perfomance.
235 - Modified the mpg123 loader in order to make it work with mpg321, too.
236   mpg321 lacks support for mpg123's -m switch ("singlemix") therefor 
237   mpg?2?'s output is now piped into sox to convert the signal to mono.
238   For this reason mpg?2? support now requires sox to be installed, too.
239 - added a workaround for a gtk+ bug that causes empty labels when strings
240   contain umlauts - unluckily my name features one of these so I had to write
241   this workaround.
243 [v3.71]
244 - applied a big patch from Adrian Reber ( This patch includes:
245   o compile fixes for the newer gcc releases
246   o enhancements to the commandline switches (try --help for more details)
247   o bug fixes for tX_global.c
248 - the bigNewThang (TM) is STEREO output. The Pan-Buttons now actually do what
249   you'd expect them to. Therefore your soundcard must have stereo support of
250   course but I guess in 2001 this really shouldn't be a problem, right? 
251   The recorded wavfiles will now be stereo wavfiles of course.
252   Note that stereo output means double audio-bandwith, so if you tuned your
253   old terminatorX setup to smallest latency you might get clicks now. You can
254   easily fix this by increasing the buffer size in the options dialog by one - 
255   this will result in the same latency as before btw.
256 - The echo effect has undergone some enhancements to profit from the new stereo
257   output. It's signal will now be mixed seperately so you can choose a different
258   stereo panorama position for the echo signal. So the new echo effect now 
259   features it's own PAN-knob. This does have some sideeffects though, for more
260   details on this check the manual.
261   Additionally the echo effect now has it's own volume setting to influence
262   the dry/wet ratio of this effect.
263 - Some LADSPA effects tend to create NAN (Not A Number) float values under
264   certain conditions. This is bad as all following operations will result in 
265   NANs, so there will be no audio output no more. Now I will not introduce code
266   to check for NANs as this is a waste of CPU-power, producing NANs is IMHO
267   a faulty behaviour for LADSPA plugins and it should be fixed in there.
268   Now a problem with the previous release was that the echo and lowpass effects
269   "ate" those NANs resulting in NANs in those effects' buffers. So once a NAN
270   got in there these effects caused the whole audio output to mute (forever). 
271   Which is why I now introduced some code to clear the buffers in echo and
272   lowpass whenever you dis- and reenable them.
273 - The GUI does have two master vu-meters now. The turntable's still have one
274   vu-meter only. Note that the echo-signal is *not* included in the turntable's
275   vu-meter now, as it's mixed seperately.
276 - The 3DNow!-Optimizations are gone. And they'll proabably never come back as
277   I don't have time to maintain the same algorithm twice.
278 - The documentation has been updated to meet the new features. A lot of typos
279   have been fixed as well.
281 [v3.70]
282 - this list may be incomplete
283 - This release brings support for LADSPA plugins. These plugins can be inserted
284   into any turntable's effect chain at any position. You can edit the the
285   effect sequence with the two tiny blue arrows. The builtin effects reside in
286   the same effect chain as LADSPA plugins, but unlike LADSPA plugins they cannot
287   be removed (nor multi-instanciated).
288   The LADSPA plugins have to "fit" into the effect chain, which is why
289   terminatorX supports *mono* plugins (plugins that have one audio-in and one
290   audio-out port) only. For the plugin's control ports, termintatorX supports
291   all HINTS except for LADSPA_HINT_LOGARITHMIC. Some control ports might be 
292   hard to handle as LAPDSA control ports can have very wide value ranges. It is
293   possible to enter precise values though.
294   Get LADSPA and the CMT plugins from
295   All parameters for LADSPA-plugins are "sequencable parameters", so you can
296   record parameter-change events for the plugin's knobs just as for the
297   standard parameters.
298 - GUI re-design to support dynamic plugin GUIs. The audiofile-display is now 
299   seperated from the turntable's controls. The groups are split in to panels
300   which can be minimized if not required (orange arrow). The panels'
301   minimized-status will be saved within the set files.
302   To add a plugin effect into the turntables effect chain click on the "FX"-
303   button and choose the plugin of your choice. To get more info on the
304   plugin effects click on their panel's label.
305   NOTE: The panning-control is not working yet. It'll work as soon as stereo
306   is done.
307 - As always when introducing something new, the set-file file-format has
308   changed.
309 - The parameter-to-mouse-axis mapping has been moved from hardcoded to
310   dynamic. You can now map any parameter that's considered "mappable" to the
311   mouse-axis of your choice (for each turntable separately). This is true
312   for the control ports of LADSPA-plugins, too.
313 - Josh Steiner <> has joined terminatorX development. For this 
314   release he has added some startup parameters for terminatorX, some of them
315   aiming for future MIDI support, and therefor not functional yet. Run
316   "terminatorX --help" to get more details.
317 - I know write the "manual" in SGML with the DocBook DTD. The distribution
318   contains the HTML and the postscript version. These transformation have been
319   created using James Clark's jade (DSSSL-processor) and Norman Walsh's DSSSL
320   stylesheets for DocBook.
321 - Removed obsolete "number of vtts"-option from the options dialog.
322 - Applied a patch from Josh that fixes running the soundfile editor for files
323   including a blank in their filename.
324 - New tooltips for the complete GUI.
326 [v3.61] (unreleased)
327 - applied a tiny patch from Atsushi Yamagata <>
328   to set locale on startup.
330 [v3.60]
331 - terminatorX has a sequencer now. Warning: with the current design the
332   sequencer will correctly play back recorded events only when the buffer size
333   (of the audio device) is set to the same size as it was when recording the
334   events. I know this is annoying and I will try to find a solution to this. 
335   Please take a look at the README to find out how the sequencer works.
336 - fixed a bug causing the lowpass filter produce a constant signal
337 - fixed the load file / drag'n'drop segfault bug
338 - fixed the prelisten zombie processes bug
339 - fixed the segfault on termination bug (with the audio engine running)
340 - hacked the mixer code to use 3DNow! too. This improves 3DNow! performance gain
341   from previously ~6% to more than 20% (depending on compiler optimizations)
342 - extended the set-file-format to allow storing of sequencer events. This
343   release allows loading old tX-sets too.
344 - some gui icons. Choose Text/Icon / Icon only / Text only display of these
345   icons in the Options dialog. You'll have to restart tX to see the changes
346   though.
347 - "soundfile-editor support": Enter the soundfile-editor of your choice in the
348   tX-Options dialog (Still looking for an editor? Checkout Dave's Linux
349   Sound and MIDI Pages:
350   Click the edit button in the Main-Panel to start your editor with the
351   turntable's soundfile - edit ;) - save and click the reload button.
352 - big endian bug fixes by Scott C. Knight <>
353 - --enable-benchmark will now produce a benchmark binary. This takes a set file
354   as a parameter (that set file should autotrigger all tables, else the
355   benchmark will measure how fast tX can generate zeros ;) WARNING: the
356   benchmark binary is not a usable terminatorX binary.
357 - a new dial-widget. I created this for the upcoming GUI-redesign - and decided
358   I let you debug it right now ;) If you don't want it run configure with the
359   --disable-dial switch.
360 - some gui redesign. The volume scales are now located near their corresponding
361   "flash"-widget. This release fits into very small windows - so it should be
362   usable on smaller displays as well.
363 - Adrian told me configure doesn�t have to check for glib after checking for
364   gtk+ - I guess he�s right so the glib-test has gone.
365 - more minor fixes
367 [v3.55]
368 - implemented "sequenceable parameters" (see tX_seqpar.*). This means the
369   groundwork for the sequencer is done. Although this release does not yet
370   feature a sequencer - there's still a profit: you can now see the GUI (e.g.
371   the lowpass-freq slider) update while you change that value with your mouse in
372   dga grab mode (e.g. up/down with the default X/Y-Control settings).
373 - fixed (libmmx) mmx.h to work with gcc 2.95 and above
374 - fixed compilation problems for big endian machines. still runtime probs
375   reported though.
376 - fixed configure-script as the new bash complains about == in string compares
377 - fixed some gui segfaults
378 - added an ugly GNOME-mimetype installer. This installs the ".tX"-mime type, an
379   terminatorX-application icon and a ".tX"-icon. I could use some hints on how
380   I could make automake install that instead of an extra script.
381   (see README.GNOME)
382 - added Drag'n Drop support. Works with the great gmc. Drop an audio file over 
383   the filename-button or the wavdisplay of a turntable to load it into that
384   table. Drop an audiofile over the "Add Turntable" Button to create a new 
385   turntable and load that file into that turntable. Drop a tX-set file over the
386   "Load Set" button to load the set. 
388 [v3.51]
389 - fixes the load_piped() compilation error if you use neither sox nor mpg123.
390   Note that you have no "pre-listening" without mpg123 for mp3s and no 
391   "pre-listening" for any other file without sox.
393 [v3.5]
394 - Yet another redesign ;) Oh well this project moved from c++/multithreaded
395   to c++/singlethreaded, to c/multithreaded and now, finally, back to
396   c++/multithreaded. This shows quite some foresight, I'd say ;)
397 - Due to the redesign I had to change a lot (everything?) again so this document
398   can impossibly hold all changes. but let's see:
399 - tX now uses floats instead of doubles for a lot of parameters. Therefore the
400   old .terminatorXrc.bin is now called .terminatorX3rc.bin to allow parallel
401   use of older releases. But you'll have to configure the new release again
402   the first time you run it.
403 - tX now supports an unlimited no of turntables. The only limit is your display
404   really.
405 - Each of these turntables has their own pitch / volume settings and a 
406   dedicated lowpass and echo effect section.
407 - You can now map mouse motion to a function of your choice (scratching/
408   volume/cutoff/echo-feedback and nothing)
409 - Recording will now happen straight to disk. You'll have to specify a filename
410   before you start recording.
411 - You can sync the turntables to one master turntable.
412 - There are two master settings for pitch and volume available to modify all
413   turntables. The turntable pitch is relative to the master pitch.
414 - You can save a complete set (of turntables and settings) to a .tX set file.
415   The audiofile data will *not* be saved within that file, but it'll contain
416   the absolut filename to these files. I know this makes the act of exchanging
417   sets over the net more complex so if somebody wants to code set files with
418   integrated audio data... ;)
419 - The way audiofiles are loaded has been redesigned too: the builtin wav
420   routines, the sox support and mpg123 are no longer connected. This means
421   you can use mpg123 support without sox support and still have the builtin
422   wav routines enabled. If you have the builtin wav reader and sox enabled, tX
423   will try try to use the builtin routines first, and if they fail sox will be
424   used as a fallback which is of course slower as you know... There's some 
425   support for Benno Senoner's brilliant 3.2-mmap() patch but the patch still
426   needs to be ported.
427 - You can now select which parameter to map to a mouse axis.
428 - experimental 3DNow! support (works with gcc < 2.95 only)
429 - tX-windows now have an icon, thanks Michael!
431 [v3.2]
432 - implemented 2D-Scratching ;) You can now use the other axis of your mouse
433   two modify the cutoff frequency of the lowpass filter (if enabled). The
434   resonance factor can be set via the slider underneath "LP Filter". Seems
435   to eat quite some CPU power though...
436 - Updated THANKS, AUTHORS
437 - as most people seem to use sox/mpg123 anyway and as I still get "I want mp3"
438   emails I changed the configure script slightly: It now automatically enables
439   the use of sox and mpg123 if these are available. If you still want 'em good
440   old 16Bit/44.1Khz/Mono builtin routines you have to specify --enable-wavonly
441   with your configure cmdline.
442 - Prepared the tarball for the Win32 port. You can now compile tX with cygwin
443   and the Makefile.cygwin in the src directory if you have all the required
444   libs (gtk, pthreads etc...). The resulting exe will run BUT is completely
445   unusable for now... Stou Sandalski <> and I are planning
446   to make it usable in the future.
447 - The About-Dialog now contains some info on how the binary was compiled
449 [v3.1]
450 - Optimized audio-rendering code for speed (might run on some machines
451   with smaller buffsize (-> lower latency) than pre-3.1) - Hey, tX now uses
452   less than 10% CPU (says kpm) with mixing enabled on my i586-200MMX machine!!  
453 - "fixed" stdout-output. Due to the pipe-buffering realtime schratching can
454   not be considered usable for now :(
455 - Added config option --enable-scheduler, which will cause the terminatorX
456   engine-thread to run with FIFO scheduling policy and highest priority. This
457   might enable some machines to use smaller buffsizes. It requries root
458   privileges though - either run terminatorX as root - or make terminatorX
460   ACCESS THE BINARY ;) You only have to think about this when you experience
461   buffer underruns with your desired latency. And it might not even help...
462 - Rehacked the de-clicking (fading) code. The old one tried to be much more
463   intelligent - and failed fading out the signal sometimes. The new code
464   is much simpler (faster) and is much more reliable.
465 - added common sense to the warp feature (f-key in scratch mode). The warping
466   speed is still connected to the mouse speed but it's now adjusted to the
467   sample size as well: you can warp through any sample completely with the same
468   mouse distance.
469 - added debug configure switch. Enables (very few) debug messages for now. I
470   decided not to enable the old V2.X messages as they are sent to stdout, which
471   would sound pretty strange to people who use the stdout-option.
473 [v3.02] (unreleased)
474 - Fixed Adrian's name in the THANKS file. Sorry, Adrian.
475 - Corrected for license.c that did not build correctly on some 
476   systems - Thanks to Michael Pruett <>
478 [v3.01]
479 - fixed a bug that caused terminatorX to crash without --enable-sox or
480   mpg123input.
482 [v3.0]
483 - Changed everything ;)
484 - switched from C++ to C for gtk's sake
485 - switched back two multithreading
486 - implemented new gtk+ gui and dialogs
487 - new mouse-sampling code now uses DGA's DirectMouse
488 - implemented "initalizing"-support for XInput devices.
489 - new (alpha) "pre-listening" feature in scratch/loop dialogs
490 - hacked vtt for click-free audio. Might be problematic with big
491   kernel level buffersizes but scratching with big buffsize is no
492   fun anyway.
493 - options are now stored in ~/.terminatorXrc.bin automatically (on exit)
494   as well as windowsize and the last used filenames
495 - terminatorX now comes with a configure script - no more Makefile hacking
496   required (nor a good idea ;) )
497 - new wavdisplay-widget update frequency is now configureable
498 - new position-display is much more visible which allows more precise
499   scratching
500 - new mute-feature allows you to silence the scratch-playback completely
501   while the loop keeps playing (press either <m>-key or right mouse-button.
502 - support for mouse buttons:
503   o 1. (left) button: same as <SPACE>, do scratch
504   o 2. (right) button: mute scratch
505   o 3. (middle) button: stop
506 - wrote support for sox and mpg123. This enables terminatorX to read close
507   to any audiofile. You need to have sox and mp3 and this feature (as it is
508   still alpha) needs to be enabled via configure-switches see INSTALL
509 - licmak now is an awk script. Thanks Christian! I was also received two perl
510   scripts (Thanks, guys!) but I now use the awk script as it is the smallest.
511 - introduced <F>-key to "warp" through scratch-sample (just check it out)
512 - dropped commandline arguments
513 - dropped old X-Code + Mouse warping madness
514 - bug fixes (less than bug introduces though ;) )
517 [v2.4] (unreleased)
518 - implemented a time counter
519 - licmak now finally is what it should be: a perl script (
520   it was contributed by: Adam Sj�gren <>. Thanks!
522 [v2.3]
523 - X-Window background fixed
524 - wavfile overreading fixed by Andrew C. Bul+hac?k (
525 - Using portable type definitions now where required. If you don't
526   have a <sys/types.h> on your system and your machines type sizes
527   equal those of an X86-machine you can specify -DUSE_X86_TYPES in
528   Makefile to compile without <sys/types.h>
529 - Slight change in audiodevice-handling that fixes improper buffsize
530   settings on some soundcards (e.g. GUS)
531 - Implemented "keep device open"-feature. Needs to be enabled via the
532   -DKEEP_DEV_OPEN switch in Makefile
533 - Added some comments to the Makefile for easier editing
534 - Added Big Endian support. Use -DBIG_ENDIAN_MACHINE for big endian hosts
535   like ultrapenguin suns or linux ppc. There's also -DBIG_ENDIAN_AUDIO
536   for big endian audio hardware (rare?) available, although proabably
537   nobody will need this.
538 - Changed mix behaviour: Mix is now automatically turned on on startup if
539   the user has specified a proper loop file. (with the --loop or -l switch)
540 - New mixing routine. You can now set the loop to scratch volume ratio with
541   the cursor keys (left/right). If you modify the volumes while recording
542   these action's will not be recorded. Saving happens with the currently
543   set level.
544 - Fixed README-Bug said <m> instead of <x>
546 [v2.2]
547 - first released version
548 - added colors. more standard use of X11.
549 - added loop support.
550 - added statusbar with mode/status display
551 - added commandline options and help (on usage and keys)
552 - added raw/mixed save scratch feature
553 - added licmak to include license into binary
554 - new handling of XAutoRepeat, only turned off now when SPACE pressed.
555 - modified wave display (faster + nicer + incorrect (who cares anyway))
556 - Makefile fixed by Adrian Reber (
557 - bug fixes
559 [prerelease]
561 [v2.1]
562 - added recording, playback of recording functionality
564 [v2.0]
565 - moved from multithreaded to singlethreaded
566 - position feedback
567 - bug fixes
569 [v1.0]
570 - mouse support
571 - no more position display due to pthread/X probs
572 - bug fixes
574 [v0.5]
575 - first version
576 - no mouse handling
577 - accelerating vtt via sinus
578 - multithreaded
579 - sound aliasing