Welcome to REW

REW (Room EQ Wizard) is a Java application for measuring room responses and countering room modal resonances. It includes tools for generating test signals; measuring SPL; measuring frequency and impulse responses; generating phase, group delay, spectral decay plots, waterfalls, spectrograms and energy-time curves; generating real time analyser (RTA) plots; calculating reverberation times; displaying equaliser responses and automatically adjusting the settings of parametric equalisers to counter the effects of room modes and adjust responses to match a target.

REW uses a logarithmically swept sine signal for its measurements. This is much faster than manual measurements, more accurate, less likely to suffer from clipping at resonances, less sensitive to system non-linearity than MLS and allows the impulse response of the room to be determined, which in turn is the basis for many additional features. When using the Real Time Analyser displays REW can generate Pink Periodic Noise sequences for much better visibility of low frequency behaviour than obtained using random Pink Noise without the need for lengthy averaging.

The REW home page is at . For hints, tips and help visit the REW forum at .

The REW home page is at www.roomeqwizard.com. For hints, tips and help visit the REW forum at www.avnirvana.com.

Requirements

Windows XP Pro x64, Vista, 7, 8 or 8.1

When installing REW on Windows XP Pro x64, Vista, 7, 8 or 8.1 you may encounter a somewhat cryptic error message:

"The program can't start because api-ms-win-core-timezone-l1-1-0.dll is missing from your computer. Try reinstalling the program to fix this problem.".

This is caused by the Java runtime using components from the Windows Universal C Runtime which are not present on older Windows installations. To fix it see this Microsoft knowledge base article, KB2999226 at https://support.microsoft.com/en-us/help/2999226/update-for-universal-c-runtime-in-windows.

Linux installation

Diagnostics

REW saves diagnostic logs in the user's home directory in a folder called REW, the location is displayed in the Help → About REW window. The logs contain information from the last 10 startups, including any error messages or warnings that may have been generated. On macOS the logs are in an REW folder in the user library folder, which no longer appears in Finder by default. To display it either browse to ~/Library/Logs or open your Home folder in Finder (Shift Command + H), select View > Show View Options then select the checkbox to show the library folder.

REW saves a temporary copy of each measurement in a /temp sub-folder of the logs folder. Seven days of measurements are retained, any older than 7 days are deleted on shutdown. If REW did not shut down normally it will offer to load any measurements made since it last started up.

Java Runtime Environment options

The roomeqwizard.vmoptions file in the REW program directory on Windows or REW.vmoptions in the REW Applications folder on mac contains settings for the Java Runtime Environment (JRE). The REW installer makes an entry in the file to define the amount of memory to request fore the JRE on startup using the -Xmx option, for example -Xmx1024m for 1 GB. The file could be edited to request a memory size larger than the installer offers, such as -Xmx4096m for 4 GB, but note that if the OS refuses the request for the memory size specified in the file REW will not start.

On Windows Admin privileges are required to change the roomeqwizard.vmoptions file: copy it to a user-accessible directory, make the edits, then copy it back using Admin privileges.

As an alternative to editing the roomeqwizard.vmoptions file parameters can be passed to the runtime via the command line (e.g. by editing the Target of a shortcut). To do that they must be preceded by -J, so to force REW to start with 4 GB allocation (for example) regardless of the contents of the vmoptions file the shortcut target on Windows could be
"C:\Program Files\REW\roomeqwizard.exe" -J-Xmx4096m

REW Preferences

By default the preferences for REW on Windows systems are stored in this registry key:

HKEY_CURRENT_USER\Software\JavaSoft\Prefs\room eq wizard

On macOS the preferences are stored under a key called room eq wizard in:

~/Library/Preferences/com.apple.java.util.prefs.plist

Linux preferences are typically stored in:

~/.java/.userPrefs/room eq wizard/prefs.xml

REW can alternatively use a file for its preferences. There are three ways to configure that, The easiest is to put a file in the REW log files folder with the name rewprefs.txt. If that file is found on startup REW will use it to store all preferences. To use a different file run REW with a -prefs argument or make a -Drew.preferences.file entry in the roomeqwizard.vmoptions file. The -prefs argument is checked first, then the -Drew.preferences.file entry and finally REW looks for rewprefs.txt. Switching to file-based preferences can be done quickly by saving preferences to rewprefs.txt in the log files folder using the entry in the Preferences menu and restarting REW. On Windows systems startup is faster with file-based preferences.

On Windows with the default REW installation a preferences file could be specified by launching REW using

C:\Program Files\REW\roomeqwizard.exe -prefs "C:\Users\johnm\Documents\myrewprefs.txt"

or editing the Target field of the properties of an REW Windows shortcut to add the prefs argument, so the target would look like

"C:\Program Files\REW\roomeqwizard.exe" -prefs "C:\Users\johnm\Documents\myrewprefs.txt"

On macOS it could be done from a terminal using

open -a REW.app --args -prefs "/Users/johnm/Documents/myrewprefs.txt"

To use the roomeqwizard.vmoptions file add an entry to specify the path to the file, for example:

-Drew.preferences.file=C:\Users\johnm\Documents\myrewprefs.txt

If a preferences file is being used the file name will be shown in the About REW dialog. If the specified file cannot be accessed, created or written to REW will instead use a file called rewprefs.txt in the REW log files folder and show a warning to that effect.

A preferences file can be created from an existing installation using the Preferences → Save preferences to file menu entry.

Preferences can be deleted with the Preferences → Delete preferences and shut down menu entry or by running the REW uninstaller.

Initial preferences

REW can be made to always start with an initial set of preferences by specifying a file with those initial values. There are three ways to do that. The easiest is to put the file in the REW log files folder with the name initialprefs.txt. If that file is found on startup REW will use it to initialise all preferences. To force preferences to be initialised from a different file run REW with a -initialprefs argument specifying the file name for the starting preferences, or add a -Drew.initialpreferences.file entry in the roomeqwizard.vmoptions file. The -initialprefs argument is checked first, then the -Drew.initialpreferences.file entry and finally REW looks for initialprefs.txt. If a preferences file has also been specified REW will copy the initial preferences to that file, if not it will create a preferences file and copy the initial preferences into it. Any file specified as the initial preferences should be different to the file specified for the preferences. Note that the initial preferences file does not need to contain all preference settings. It can be edited to contain only those preferences which are to be initialised, any not included in the file will not be altered.

No Warranty

THIS SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE

Acknowledgements

REW uses the JTransforms pure Java FFT library available at .

ASIO interfaces are supported using Martin Roth's JAsioHost, available at .

WASAPI exclusive on Windows and ALSA PCM on Linux AMD64 are supported using Pavel Hofman's csjsound-provider, available at .

REW's installers are built with the Install4J multi-platform installer builder, available at .

Thanks to Gerrit Grunwald for ideas and elements from his Steel Series components, available at .

REW uses the Hola Multicast DNS Service Discovery library available at .

REW uses the Java WebSocket client available at .

REW uses the FormDev FlatLaf look and feel available at .

The Airy CWT and Morlet CWT spectrogram modes are Java implementations of a continuous wavelet transform using the algorithm described in Arts, L., & van den Broek, E. (2022). The fast continuous wavelet transformation (fCWT) for real-time, high-quality, noise-resistant time–frequency analysis. Nat Comput Sci, 2(1), 47–58. .



REW uses the JTransforms pure Java FFT library available at JTransforms

ASIO interfaces are supported using Martin Roth's JAsioHost, available at JAsioHost

WASAPI exclusive on Windows and ALSA PCM on Linux AMD64 are supported using Pavel Hofman's csjsound-provider, available at csjsound-provider

REW's installers are built with the Install4J multi-platform installer builder, available at ej-technologies

Thanks to Gerrit Grunwald for ideas and elements from his Steel Series components, available at Harmonic Code

REW uses the Hola Multicast DNS Service Discovery library available at Hola

REW uses the Java WebSocket client available at Java WebSocket

REW uses the FormDev FlatLaf look and feel available at FlatLaf

The Airy CWT and Morlet CWT spectrogram modes are Java implementations of a continuous wavelet transform using the algorithm described in Arts, L., & van den Broek, E. (2022). The fast continuous wavelet transformation (fCWT) for real-time, high-quality, noise-resistant time–frequency analysis. Nat Comput Sci, 2(1), 47–58. https://doi.org/10.1038/s43588-021-00183-z

Copyright © 2004-2023 John Mulcahy All Rights Reserved

Get started with REW

Send feedback to [email protected]

Help Index