Skip to main content

How to Install NDMerge

NDMerge is automatically installed in the Next Design installation folder when you install Next Design.
If you want to use NDMerge without installing Next Design, install it using the following steps.

caution

NDMerge is automatically installed when you install Next Design, but the ".gitattributes file" is not configured.
To safely merge projects, be sure to configure Git merge to work with NDMerge.
If you perform a text merge using another tool without configuring the ".gitattributes file," your project may be corrupted.
Be sure to set up the ".gitattributes file" by following these instructions.

Installation Instructions​

  1. Download the NDMerge zip file from the support site below.

https://www.nextdesign.app/support/auth/downloads/#ndmerge

caution

After downloading the zip file, disable security protection before extracting it.
(1) Right-click the zip file and select "Properties."
(2) Read the "Security" information at the bottom of the "General" tab, check the "Allow" checkbox, and click "OK."

  1. Extract the zip file to the desired installation folder.
  2. Launch Terminal and navigate to the installation folder.
  3. Execute the following command:
.\ndmerge git-setup install

For details on this command, see here.

  1. To ensure that Git merges work with NDMerge, be sure to set up the ".gitattributes file" by following the instructions here.

Please note that this program requires the installation of .NET 8.0.

Post-Installation Verification​

  • When you run the setup command for NDMerge, it is configured in the global gitconfig (for each OS login user).
  • You can check the configured settings by running the following command in the installation folder:
./ndmerge git-setup list

  • If the merge.NDMerge.driver item is added to the configuration, the settings are correct.

  • Example execution for Windows

> ./ndmerge git-setup list
exec: git config merge.NDMerge.name
nd diff merge application
exec: git config merge.NDMerge.driver
'[Absolute path for user environment]/ndmerge.exe' merge -o %A -t %B -b %O -m %A -p %P -l warn
caution
  • NDMerge will not work if the path set in gitconfig and the storage folder location are different.
    If you move the storage folder, run the setup command again to update the gitconfig settings.

Update Procedure​

If you already have NDMerge installed, follow the steps below to update to the new version of NDMerge.

  1. Download the complete set of NDMerge files (zip file) from the support site below.

https://www.nextdesign.app/support/auth/downloads/#ndmerge

Caution After downloading the zip file, disable security protection before extracting it.
(1) Right-click the zip file and select "Properties."
(2) Read the "Security" information at the bottom of the "General" tab, check the "Allow" checkbox on the right, and click "OK."

  1. Delete all existing files in the installation folder.
  2. Extract the new version's zip file to the installation folder.
  3. Launch Terminal and navigate to the installation folder.
  4. Run the following command to verify that the update to the new version was successful.
.\ndmerge --version

Uninstallation Procedure​

  1. Launch Terminal and navigate to the NDMerge installation folder.
  2. Run the following command:
./ndmerge git-setup uninstall
  1. Delete the contents of the .gitattributes file described in .gitattributes Settings.
  2. If the .gitattributes file contains no settings other than NDMerge, run the following command:
git config --global --unset core.attributesfile
  1. Delete all files in the installation folder.
Last updated on