Docs | ELNS Audio Tool

The toolbar is located on the left side.

Show application information, copyright and license information.

Open application settings

Open check for updates dialog

Open URL to the donation page

Enable repeat of the input file. Disabled if reading audio from a sound card.

Restart the playback from the start. Disabled if reading audio from a sound card.

Stop the processing. It can also clear an error.

Start or pause the processing. While running and in pause, any of the configuration cannot be changed. The DSP function parameters and the audio control buttons on the right can be used.

The input/output section determines the source and destination for the audio and it sets the number of audio channels.

Selects the sound card device to use for audio input or output. The sound card will be used as input source if the input file is empty and it will be used as an output destination if the output file is empty. The suffix "(in=X, out=Y)" indicates the maximum number of input channels and output channels that this sound card supports. The prefix in "[brackets]" indicates the audio system. Windows sound systems provides information about the choices.

Sets the number of input channels and input file name. If the filename field is blank, audio will be fetched from the audio device. If reading from a file, the number of input channels is read from the file and the number of channels cannot be altered.

Sets the number of output channels and output file name. If the filename field is blank, the audio will be sent to the audio device output. Some functions requires equal number of input channels and output channels and in these cases the number of output channels cannot be set.

The background color indicates if the configuration is valid. Green background indicates valid configuration, and a green background indicates an incorrect or missing configuration.

The audio processing function is selected with the function drop-down box. Each function performs a specific type of processing and can have an optional GUI for setting parameters. Please see Functions page for more information about the functions and their parameters.

Hovering over the function drop-down box will show a simple function description and its parameters.

The audio control located on the right side allows for live adjustments of the audio while running. Some functions present additional controls in addition to the controls shown here.

The current function parameters can be saved and recalled by pressing a preset button. Selecting a preset will save the current settings into the active preset and activate the clicked preset.

Bypass will stop processing of the function and pass unaltered audio from input directly to output.

Mute will silence the audio output, but the stream is still kept running.

Reset will set the current function parameters back to default values.

From left to right, the status bar contains the following elements:

The progress bar shows the current progress position when reading from an input file. The progress bar can be clicked to move the playback position during running and pause.

If the input is read from a file, this shows the length of the file.

The info field will show info about the audio processing: Samplerate / Encoding / Latency. Hovering over the field will show additional technical information about the processing. See program info section for more information.

The rightmost icon shows the current program status. Hover over or clicking the icon will show a popup with information about the current status. Clicking on the icon will show a dialog with additional buttons. Close will close the dialog. Clear (only errors) will dismiss and clear the current error. Send diagnostics allows sending diagnostics information to the author. See diagnostics dialog documentation for more information.

The bottom right icon shows the current status of the application. Hovering over the status icon can display additional supplemental information.

Configuration is incomplete and needs to be fixed. Hovering over the icon will show hints why the configuration is incomplete and suggest what needs to be fixed.

Configuration is valid and ready to process audio

Audio processing in progress. The configuration settings cannot be altered during processing and pause, and the input and output fields have been disabled.

Processing audio has been suspended.

Application has failed. Hovering over the icon will show the error message. To resume after an error either click the stop button or the Clear button in the status dialog. Status will then go back to the ready state.

An unrecoverable fatal error has occurred. Hovering over the icon will show the technical info about the failure. No recovery is possible and the application can only be exited.

This section is advanced topic and not essential for the basic usage of ELNS.

The info area on the status bar next to the status icon shows three fields: Samplerate / Encoding / Latency.

The current processing samplerate

shows the sample type and width which the processing is running at. E.g. pcm32 indicates a 32-bit PCM integer type, while float32is using 32-bit floating-point encoding.

shows the overall processing latency, which is the time delay from input to output.

Hovering over the info area during processing will show additional technical information and statistics from the processing.

From left to right, these fields are

Delta represents the number of blocks processed since last log entry

The time of audio data represented in one block. The number of samples per block is listed in parenthesis.

The total amount of time ELNS used for processing one block. The %RT (real-time) figure in parenthesis indicates how big fraction of the time spent processing. It is an indicator if the computer is capable of keeping up with processing the data in real-time.

The amount of time spent in the core function DSP processing algorithm.

When pausing or stopping processing, a processing summary information will be shown. It contains additional aggregated statistics about the processing.

User interface

This page gives an walkthrough of the main window user interface.

Main Toolbar

Input and output configuration

Function selection and interface

Audio controls

Status bar

Program status

Audio processing info