EKO Manual


Table of contents



Why EKO?
MP3 and video files support.
Important! Basic setup
Playback and looping
Recording
Mixer
Interface
File manager
Menus:
File
Edit
Markup
Search
Functions
Nav
Fm
Zoom
View
Options tab (Preferences)
Notes
Other author's projects
Donate

Why "EKO"?

There are two reasons behind this. The first one is that "eko" is sounds just like "echo", thus related to the sound domain. And another reason was the idea of animal rights promotion. I don't know how exactly EKO can help with that, but is is obviously for me that the freedom of software or music just a one step to the more global freedom, the freedom of the personality - and not just a human personality, but also of all animals. From the my point of view there is no difference of the life value between the human or a small mouse. They are equal.

MP3, videofiles, etc.

EKO can open MP3, import the sound from videofiles, and export the sound to MP3. There are not so much FOSS developers who like to deal with software patents, etc., so we like to use the external tools like lame, ffmpeg and others.

EKO needs FFMPEG or Mplayer to open MP3 and videofiles. Linux users can install them from the OS distro software repository. Windows users need to download them and put the binary (exe) files (ffmpeg.exe or/and mplayer.exe) to the directory there eko.exe is installed. Windows version of Mplayer is available here and here. If you want to use FFMPEG with EKO, then download FFMPEG 32bit static build at this page.

To MP3 export, EKO need LAME. Some Linux distros includes this encoder. Some does not. But LAME is very simple to compile from the source. Of course, Windows users needs the binary lame.exe. It can be build from the source using MinGW, or obtaine from here. Just download Lame_VERSION_for_Windows.exe, install it, then copy lame.exe from the installation directory to the EKO folder, where the eko.exe.

It is really sad that I'm simply afraid to distribute ffmpeg.exe and lame.exe with EKO.

Basic setup

Before using EKO, set up the input and output devices/ports at Options - Sound devices page. If recording or playback does not work (usually the error log is "Invalid number of channels"), try another option. It's important to choose the proper pair of the ports. They are must be on the same sound card, and use the same API. For example, on my M-Audio Audiophile 24/96 I use the ALSA API device "M-Audio Audio Audiophile 24/96: ICE1712 multi (hw:0,0)" as the input and the output device. On Win32 you can try, for example, MME API device "Sound Mapper - Input" and "Sound Mapper - Output", or some DirectX options.

The "Invalid number of channels" error message can also appear if the sound device is currently used by another application (web browser, etc.).

EKO is a very simple sound editor. Unlike some other editors, it has no disk caching system, so all files will be loaded directly into the memory. It means that EKO needs a lot of memory if you work with large files or with many files simultaneously.

EKO internals is 32 bit floating point mixing and DSP engine. All recording and playback uses Portaudio library to access the underlying sound system (ALSA, OSS, MME, etc.).


Playback and looping

EKO does not have tons of options of playback. When you press the magic key Space, EKO starts to play the current file. If you press the Space again, EKO pauses, not stops. To stop, you can press the Stop button on the toolbar. The "Stop" stops the sound and moves the cursor to the beginning of the file.

There also a "Looped" checkbox at the toolbar. When it is checked, EKO plays the current selection (if some area is selected) or the whole file.

You can select sound data by the mouse, and, in addition to that, move the selection border using Shift-cursor or Alt-cursor (move the right border or the left border). "[" and "]" sets the left or the right selection border to the cursor position. To deselect, just click somewhere out of the selection


Recording

To record a sound file, use File - Record, Press "Stop" button when done. To set up sound format, go to the Options - Common page, and there press "Set default format for new files" button. Due to some Portaudio issues with ALSA, EKO opens the input sound device in stereo mode. But then, if the "mono recording" option is selected, on saving file EKO takes just one channel, left or right. Customize this on Options - Sound devices.

When recording, EKO uses temporary file at the temporary directory, system's by default. You can redefine EKO temp directory at Options - Common. So the maximum length of the recording depends on the free space of the disk partition where your temporary directory is located.

To hear what you record while recording turn on the Options - Sound devices - Monitor input option.


Mixer

EKO has the rack for realtime effects, combined with a simple mixer. Here you can add or delete some effects. They can be tweaked in the realtime and it will sounds. When you'll decide to apply them "offline" to the selected area or the whole file, press the "Apply" button at the middle of Mixer. Also you can rearrange effects via "up" and "down". The "Apply" button, after all data has been processed, sets all effects to the bypass state.

Currently there are no so much built-in realtime effects. The external plugins will be supported in the future. Probably maybe.

The "Volume" knob is virtual, i.e. his settings sounds, but not renders when you push "Apply".


Interface

From the top to bottom, there are:

1. The main menu. Note that you can tear submenus off and place them somewhere over the desktop. Menu items are depended on the current task or even the editor mode. Some menus can be visible or hidden according to the task (editing, file browsing, etc.).

2. The toolbars area. Toolbars can be parked at the any side of EKO window. Positions are saved between sessions. To turn the toolbar on and off, use the context menu for the toolbar (right click on the toolbar). If no toolbar is visible, do the right click on the menu bar.

3. The tabbed area. It contains four main tabs - editor, files, options and manual. Editor - that where you see opened documents. Files - the built-in file manager. Options - here you can change EKO preferences. All changes will be applied immediately. Manual - the built-in User manual. This one.

4. Logmemo. It is the notification area. Destination: all warnings, information messages, etc.

5. The Famous input field (FIF). The input text field that is used for Find (read about a Search menu for details). FIF has three buttons - Find, Find previous and Find next. FIF is used also for a search in the EKO manual, menu items list (at the hotkeys customization page) and even the built-in file manager.

6. The status bar.


File manager

The EKO's file manager is hidden under the Files tab. It is not an additional bloatware tool, but the essential part of the editor. It replaces the standard File save/open dialogs (by the way, you can bring them back using Options > Interface > Use traditional File Save/Open dialogs option).

Let's see on the shining force of EKO's file manager.

At the top the directory bar is located. There are an entry with the current directory path, and a nice toolbar with following weird-looking buttons:

Go - navigates to the directory with the path from the text entry.

Home - teleports you to your cozy home directory.

Refresh - refreshes the files list.

File operations button with the submenu. It contains some utility actions such as Create new directory, Rename and Delete file. Please note that EKO cannot delete the directories.

The right panel of the file manager.

At the top you see the file name field. Here you can name a file to open or save it. To save the current file under some name, just write the filename into the Name text entry and press the Save as button. To open a file, double click on the file name at the files list, or put the file name into the Name entry and press the Open button. You can use the Enter key inside of this input field. The action is related to the menu item (File open or Save as) that you used to open the file manager tab.

You can also select multiply files (Ctrl-click) and then press the Open button.

Bookmarks list. You can easily add and remove the directory bookmarks using the "+" and "-" buttons. The "+" button adds a bookmark to the file system tree's current directory. The "-" button removes the selected bookmark. To activate the bookmark and navigate to the according directory, double click on the bookmark.


File

New. This menu item creates an empty file with parameters those defined under Options - Common - Set default format for new files. EKO holds internally all sound data at 32-bit floating point sample values, and external conversion to other formats happens on saving or loading.

Open - if you are using the build-in file manager, read the File manager chapter. Otherwise, use the standard "File open" dialog window.

EKO supports many sound formats using the libsndfile library: WAV, AIFF, AU, RAW, PAF, SVX, NIST, VOC, IRCAM, W64, MAT4, MAT5, PVF, XI, HTK, SDS, AVR, SD2, FLAC, CAF, WVE, OGG and others. WAV PCM is supported from signed 8 bit up to 64 bit double, with any sample rate.

EKO can open, at the read-only mode, MP3 and videofiles (as audio tracks). EKO uses the external tools for that, FFMPEG or Mplayer. You can select the decoder engine at Options - Common - MP3 and video decoder. FFMPEG is faster. When open such files, EKO uses the temporary wav-file at the temporary directory that you need to set up at Options - Common - Temp directory, so there are must be enough of available free space.

Opening the large videofiles consumes a much of time, because the decoder will decode, and EKO will calculate the sound peak data. So be patient.

Save - if your file is already saved, this menu item saves it again. That is how it works. But, if the file is not saved, you shall see File manager. There, write the file name into to Name entry and press Save as button.

To save a file in a different format and file name use File - Change format window, choose some format, then do Save As. To save a file under the same filename with the different format, use File - Change format, and then Save. In this case, if the file extension is not the same as extension of the selected format, the proper extension will be given to the resulting file name. EKO do not make format conversion if you just change the file extension by file saving.

Some examples:

Let's assume that you have WAV at 16 bit PCM, test.wav. If you select the AIFF format at then Save, you'll get the "test.aiff" file.

If you have a new file and try to save it without the file extension, EKO add the file extension according to the file format.

Last closed file - opens the last closed file.

Save as different > Save timestamped version - saves a content of the current document with name, where the timestamp is added. So you shall know the date and time related to the saved version. Note about timestamp format. It is yyyy-MM-dd-hh-mm-ss. So the first comes the year, then the month, then the days, the hours, the minutes and the seconds.

Import/Export > Import from RAW - allows to open any file as the sound data, using the manually selected data format.

Import/Export > Export to MP3 - encodes current document's sound data to the MP3-file using the external encoder defined by the command at Options - Common - MP3 encode command parameter. LAME is used by default.

Recent files. From here you can open one of the dozen recently opened files.

Sessions - at this menu sessions are available. The session is a simple list of opened files. To load them all, just choose the session name. To save the session use File > Save different > Save session. At the preferences Common page you can check the Restore the last session on start-up option. If this option is turned on, EKO will save the session on exit (under the name def-session-777), and then load this session when starting.

File actions submenu. Reload is a function to reload the current file's content from the disk.

Exit - closes EKO. To reduce the annoyance, EKO doesn't ask to confirm it.



Edit

Cut, Copy, Paste - works similar as in any other sound editor. When you paste sound data into the other file, the data from clipboard will be resampled to the destination file sample rate and channels count will be reduced or expanded according to the destination file channels count.

Copy to new - copy the selected data to the new file. The new file will have sound format as the source data.

Copy to new (default format) - copy the selected data to the new file. The new file will have sound format as the default sound format for a new file (you can set it at the Options - Common).



Search

EKO has no dialog windows for the search. EKO uses the Famous input field (FIF) and menu-driven interface. FIF works in Options - Keyboard and the manual panel. Type+enter=search, F3 - search next from the cursor position.


Functions

This menu holds "offline"-processing functions such as reverse, fade, RMS calculation, channel management and others.

Dynamics - Apply volume envelope - applies the off-line volume automation envelope that you can create with right-clicking on the waveform. The volume envelope effect is not heard when playing. You need to create the envelope and then apply it.

The right-click creates the new envelope point. Shift + left click on the point sets its value to zero. Ctrl + left click deletes the point.

There are two automatically created points at the beginning and the end of the envelope (the ending point is not always visible). You cannot delete them. To control the last point, use the previous one.

The dynamic range of the envelope is from -90 db (when the point is under the axis) to +6 dB (if the point is below). To make sound louder, move the point higher, and vice versa. With the volume envelope you can control the volume precisely. The envelope time range is the whole file, not the selection.

To delete the envelope, use the Remove volume envelope menu item.

DC offset - this menu contains functions to fix the DC offset. In most cases you can use Fix DC offset auto and you can do it multiply times on the same portion of data to set the correct DC. Another way is to apply two functions - Detect DC offset first, then copy offset value from Logmemo, then use Fix DC offset manually and enter that offset value into the input entry. The best result for Detect DC offset is calculate when you scan the shifted "silence" (which looks like a completely solid waveform).


Nav


Fm

Fm means the File manager. This menu contains the functions related to EKO file manager and visible when the browse tab is active.

Fm > Select by regexp/Deselect by regexp - use this functions to select or deselect files by regexp pattern. For example, to select all txt-files at the current dir, put the following regexps into the FIF:".*\.txt$" (without quotes!). Then, use Select by regexp. Then you can press Open button to open all selected files.


View

Themes - EKO has some built-in GUI themes.

Palettes - from this submenu you can select the color scheme that affects the wave editing area.

Profiles - this menu allows you to switch between view profiles (they includes parameters such as window position, size, etc.). So you can save your current settings via Save profile function, and named profile will appear at the Profiles menu. In any time you can select it to recall saved settings.


Zoom

Here you can scale waveform to the selected zoom factor, or save up to two factor presets - Zoom A and Zoom B, to switch between them quickly.

Another way to zoom is to use the mouse wheel, but with the large file it can be very slooooooow.


Options tab (Preferences)

On Keyboard tab you can assign the shortcuts with the menu items. To set the new hotkey, select a menu item from the list, then press the hotkey combination at the entry to the right from the list, and press Assign button. To remove the hotkey, select the menu item from the list and press Remove button. To re-assign the hotkey that already in use, do Remove for this shortcut first.


Notes

Nope.


Other author's projects

TEA- small text editor with hundreds of functions.

My home page with the prose and other things.

Atomnaya Smena - my one-person music project. Rock/Indietronica/Neoclassics/Psytrance. All music is in the public domain.

Nesmeyana - the band where I am one of the members. All music is in the public domain.

Drymba studio - the indie film studio that make ultra-low-budget movies and clay/3D cartoons. I'm one of the creators. Public domain.


Donate

If you want to support EKO with donation, better support the Ukrainian dog shelter Lyubas House - www.ukraineanimalrescue.org/#!lyubas-house/cxfj. There are lot of dogs with disabilities, and they need help more than EKO.