Separate references from music
Moving an XML or NML file does not move the songs it references. Plan where the actual audio will live on the destination machine, copy it separately and retain a source backup. The library workbench can replace a folder prefix inside metadata, but it has no access to arbitrary local files and cannot confirm that the replacement location contains the expected song.
Inspect several original paths before editing. Windows drive paths and absolute POSIX paths are supported. Relative filenames, UNC shares and remote links need an explicit supported export from the source application first. File URI encoding matters: spaces, accented characters and literal hash signs must remain valid parts of a filename rather than becoming URI control syntax.
Preview the exact boundary
Enter the existing absolute folder and the intended replacement folder. Preview shows a count and examples before any in-memory change is applied. Matching is case-sensitive and respects a directory boundary, so replacing a Music folder does not also replace a neighbouring folder called Music Old.
Apply the reviewed change, inspect the resulting paths and prepare a fresh handoff. If the preview used the wrong prefix, edit it and preview again. Undo restores the preceding remap, while restoring the imported library returns all paths to the initial supported model. None of these actions rewrites the original file.
Resolve named volumes explicitly
Some NML exports identify a disk by name and store its directory separately. A volume called DJ Drive might be mounted under /Volumes/DJ Drive, while a startup volume uses the filesystem root. These locations cannot be inferred reliably from the volume name alone. Supply the actual source mount root when prompted.
For POSIX NML output, supply both the target volume name and the absolute target volume root. The writer removes that explicit root from the NML directory reference and refuses paths outside it. Test the import in the receiving application and verify the actual music files before treating the migration as complete.