Problems between the N4's link with the Universal Acqua Engine (or UAE) can generate errors and crashes in the N4 or libraries. If you have in mind to change the factory settings, be very careful, wrong paths can cause serious problems and troubles in the product performance.


Below are details on how to solve N4 link problems with the Universal Acqua Engine (or UAE) and some typical errors in users who decide to change the factory settings.



Before proceeding with the N4 installation on the Aquarius application we recommend you check carefully the Aquarius settings in the installation tab.

When you load an N4 instance in your audio host (DAW or NLE), N4 will call the Universal Acqua Engine (or UAE), if the Universal Acqua Engine path is declared  wrongly N4 will load a black empty window. In order to fix this behavior the best procedure is to uninstall and delete completely your N4 and libraries content, and then set correctly the installation path on the Aquarius application to finally reinstall N4 with a correct and valid path for the Nebula4folder on macOS or nebulatemprepository folder on Windows.


NOTE: We suggest to use the factory default path for N4, custom path(s) could not work due diverse reasons.

You can verify if the black window issue is related to a wrong path by checking in the Nebula4 folder path declared in the N4.XML file with the tag DATAPATH on macOS operating system. On Windows operating systems DATAPATH tag is not in use anymore and the nebulatemprepository folder is declared in a Windows registry key.


For example the Windows registry key should be for the factory default path:

[HKEY_LOCAL_MACHINE\SOFTWARE\Acustica Audio]
"N4TempRepository"="c:\\nebulatemprepository\\"


This means the nebulatemprepository folder path is "c:\nebulatemprepository\" without the quotes.




List of typical N4 and the UAE ((Universal Acqua Engine) errors:

  1. Wrong settings between Aquarius applications and the N4 Windows registry key: The link between the N4 plug-in in the N4.XML file is done through a key in the windows registry, if the path information is different between the Aquarius application and the Windows registry key. N4 will not be able to load the UAE (Universal Acqua Engine). This problem was described in detail at the beginning of this solution. Be very careful, a wrong settings can cause serious problems in the operation of the product.
  2. Wrong settings between Aquarius applications and the N4 XML file in macOS operating systems: The link between the N4 plug-in in the N4.XML file is done through path in the DATAPATH tag, if the path information is different between the Aquarius application and the N4.xml. N4 will not be able to load load the UAE (Universal Acqua Engine). This problem was described in detail at the beginning of this solution. Be very careful, a wrong settings can cause serious problems in the operation of the product.
  3. Incompatible file system on macOS and Windows operating systems: The file system where the N4 shared repository folder, and also UAE, is located operating system main drive must have the same file system.
    Avoid using case sensitive file system because are not supported. Keep in mind that help-desk agents do not provide support on operating system configurations.
  4. Incompatible paths using special characters or spaces on macOS and Windows operating systems: The path where the N4 repository folder is located must not contain any special characters (click here for more details) or spaces. Keep in mind that help-desk agents do not provide about customs paths settings.
  5. Path(s) with permission problems on macOS and Windows operating systems: The path where the N4 repository folder located must have the appropriate permissions. Keep in mind that help-desk agents do not provide support on operating system configurations.

Do not send us emails or reply to the help-desk solutions, since the ticket will be created without any property and our help-desk agents will not answer them.


To contact the Acustica Audio support go to the ‘Support and Help-desk Section’ in your Acustica Audio account. We do not provide support via social networks, public forums, Acustica Audio forums, or email accounts.