Eisenkraut -- version 0.70 (built 04-jul-08) --

statement

Eisenkraut is a standalone, cross-platform audio file editor using the SuperCollider 3 server application. Eisenkraut is (C)opyright 2004–2008 by Hanns Holger Rutz. All rights reserved. This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but without any warranty; without even the implied warranty of merchantability or fitness for a particular purpose. See the GNU General Public License for more details.

For project status and current version, visit www.sciss.de/eisenkraut.
To contact the author, send an email to contact at sciss.de

Eisenkraut uses the JCollider library which is licensed under the GNU General Public License, the NetUtil OSC library, which is licensed under the GNU Lesser General Public License (LGPL), and Steve Roy's MRJAdapter which is published under the artistic license.

please note that you are not allowed to use this software if you are a member of a military or pharmaceutical or governmental institution (excluding public service in general and civil science/education). if you have sympathies for bad governments (applies to most countries), you should also opt to not use this software. thank you.

requirements / installation

Note: when you are updating from a previous version of Eisenkraut, it is advised to trash the old preferences. The preferences file's location depends on your platform. On Mac OS X, this file is ~/Library/Preferences/de.sciss.eisenkraut.plist.

Installing is simple. Just unpack the (g)zip archive and place it in your favourite folder.

Ok, get yourself a cooled Jever^tm or any other of your favourite beers, and double click on the appropriate icon:

• Eisenkraut[.app] on Mac OS X
• Eisenkraut.jar on Linux and Window

Eisenkraut requires a Java^tm SE 1.4 (or higher) runtime environment. On the Mac, you should already have an apppropriate version installed. Some linux distributions come with GCJ installed which unfortunately will probably not suffice due to the incomplete and buggy class library. Some newer distributions might come with OpenJDK which should be fine. Eisenkraut has been successfully tested with Sun's VM 1.5.0 on Linux and Windows, and Apple's VMs 1.5.0 on Mac OS X 10.4.

Eisenkraut uses the SuperCollider server as the audio playback engine. You need to install a recent SuperCollider 3 version to run this software. The recommended version is SuperCollider 3.2. supercollider.sf.net is the main SuperCollider portal and has download links for all platforms. After launching Eisenkraut for the first time, make sure that the "SuperCollider Server (scsynth)" field in the audio preferences is pointing to the valid scsynth[.exe]) file! Also note that, by default, the audio server is not automatically booted, so you need to press the "Boot" button in the main window to launch the server and be able to actually hear the soundfile when playing it back.

compilation / usage

Please read the DevelopersNeeded note.

The project can be edited with Eclipse 3.2+, the project and settings files are included in the main folder. The easiest way to compile Eisenkraut is to run the ant builder. For Linux and Windows, a clean build is done like this:

$ cd <eisenkrautInstallationFolder>
$ ant clean jar

For Mac OS X use:

$ cd <eisenkrautInstallationFolder>
$ ant clean osx-app

To package the folder for distribution, use the dist Ant target.

download

The current version can be downloaded here:

• sourceforge.net/project/eisenkraut

Either go to the regular download section for stable builds, or use SVN to grab the latest developer sourcecode version.

documentation

Please refer to the help index page for a list of manual topics.

make sure you read the bugs-and-known-issues list before you use the software.
you have been warned!

to-do's

A lot. Here are some suggestions:

• Still need to integrate FScape (more a job about FScape than about Eisenkraut)
• Finding a way to edit with simultaneous video display (might be a separate app synchronized through some kind of OSC transport)
• Optionally saving meta-information with the soundfiles (e.g. a separate XML file), like panorama settings, window bounds etc.
• Finishing sonagramme functionality (needs decimation and must be editable)
• Improving SuperCollider interface and classes
• etc. etc.

change history

v0.70 (jul 2008 ; svn rev. 120)

• support for multi-mono files
• support for independant channel editing
• experimental sonagramme display mode
• OSC server for basic scripting functionality (e.g. from SuperCollider language). includes SwingOSC bridge for populating windows.
• updated JCollider and NetUtil with TCP support
• switchable editing mode (insert, overwrite, mix) for cut and paste operations
• sample accurate loop playback without gaps
• processes are marker-aware now
• new functions: save selection as, play selection
• many gui beautifications and improvements (pop-up panorama, blend-settings popup and history, higher contrast SPL and wave colours, control room meters, list of switchable audio-interfaces, optional internal-frames-mode ("MDI"), faster waveform display, collapsable waveform view, asynchronous waveform calculation, logarithmic waveform display)
• many internal architectural changes (simplified and less buggy lock mechanism, unified timebased package, unified application framework, improved level meter management)
• dozens of bug fixes, fixed some memory leaks
• using Eclipse 3.2 IDE now with Apache ant task
• no more jar installer, double-clickable jar application

v0.63 (dec 2005)

• added audio recorder
• minor bugfixes and gui improvements

v0.62 (nov 2005)

• minor bugfixes
• locks for timeline selection, reveal-in-finder (mac-only), new help buttons

v0.61 (oct 2005)

• completed transition to new parameter gadgets
• bugfixes including the corrupted playlist after saving
• fixes and normalize mode in Needhole process; better progress bar display

v0.59 (oct 2005)

• added channel meter display and sample value cursor information
• waveform is shown in sample-and-hold style when zooming in close enough
• fixed again non working keyboard shortcuts (cursor keys)
• worked a bit on the fscape integration

v0.58 (sep 2005)

• changed waveform view double buffering, fixes a bug with slow display and memory leak
• fixed bugs with supercollider boot and audio bus de-allocation
• fixed non working keyboard shortcuts on PCs
• minor improvements (zoom tool, keyboard access)

v0.57 (sep 2005)

• fixed linux incompatible server options bug
• introduces new param field with switchable units (foreshadowing the fscape integration ;-)
• added limiter option to allow volume boosting without distortion, useful when cutting high dynamic material using headphones
• new-document-from-selection

v0.55 (sep 2005)

• improved audio file performance, marker support for WAV files
• preliminary marker import function, new-empty-document item, mix-clipboard process
• improved undo manager (lazy redo buffer destruction)
• small things like: warns you when you open a write-protected file; bug fixes

v0.5 (aug 2005)

• converted into a multi-document application. this is not very well tested yet, 0.4 might be more stable.
• the waveform window now includes the transport (every sound has separate transport).
• supercollider window has become the main window used for closing the application.
• supercollider now controlled using basic jcollider classes, a small server stat display in the main window.
• markers can be moved ;-)
• more keyboard shortcuts, more help files, bug fixes

v0.4 (jul 2005)

• I/OSetup window and panorama settings for each channel.
• Automatic SC boot feature. No need to quit and re-launch SC when configuration changes.
• Automatic sample rate conversion.
• Basic marker support.
• A couple of bug fixes

v0.3 (jul 2005)

• variable blending curve, blending support in practially all editing steps
• basic dsp functions (fade in, fade out, adjust gain, invert, reverse, swap channels, crop)
• waveform overviews are optionally cached
• view options (time units, vertical ruler, null linie). timeline-insertion-follows-playback
• lot's of bug fixes. source code more modularized. custom icons and info.plist settings.

v0.2 (may 2005)

• fixes problems with clicks between edited regions.
• duplicates some new features of meloncillo, e.g. improved transport, improved timeline tools, solo+mute. master-volume slider.

v0.1 (mar 2005)

• really the first alpha version, beware

(*) according to paragraph 6 b) of the LGPL, libraries are used in a fashion that allow you to replace them by modified versions if they confirm to the original library's interface. The libraries are placed in the 'libraries' folder. Current versions of the libraries as well as their machine readable sourcecode can be downloaded at the specified URLs. If you have problems downloading the sourcecodes, I will email you these sourcecodes on request, according to the LGPL paragraph 6 c).