Changes

Jump to: navigation, search

Addon:MediaMerge

1,000 bytes added, 22:34, 2 November 2020
no edit summary
{{Third-party plugin}}
[[File:MediaMerge.png|thumb|right|450px|Media Merge Tool's "Number of merges done" Results dialog and Before(top) and After(Bottom) screenshots of the [[Gramps_5.1_Wiki_Manual_-_Categories#Media_List_View|Media List View]]]]
The {{man label|Merge Media}} tool can search your database for media file entries that are pointing to the same actual file and when found, they can be merged together.
__TOC__
==What is it For?==
The {{man menu|Tools ->Family Tree Processing -> Merge Media}} tool searches your database for media file entries that are pointing to the same actual file. This can occur with certain import types, and can occur if the user adds the same media more than once. When found, they are merged together.
The addon compares all ==Usage==Select {{man menu|Tools ->Family Tree Processing -> Merge Media}} from the media 'pathname' values, converting them internally to a common format for comparisonmenu.
For Windows users, differences in capitalization on the path are ignored, as are differences in the path separators '''"\"''' vs. '''"/"'The tool will start with an 'Undo history warning'that suggest that you back up your work.
For all users paths that The tool then scans your family tree and depending on the result you are relative (using then presented with the:* {{man menulabel|Edit [[Addon:MediaMerge#No_modifications_made|No modifications made]]}} dialog -> Preferences -> Base path for relative if no media pathsneeds to be merged.* {{man label|[[Addon:MediaMerge#Number_of_merges_done|Number of merges done]]}}) are also compared to absolute paths or paths relative to your home directory.dialog with the result of the automatic merge
For all users, paths ===Number of merges done===If any duplicate media is found and merged you will see the {{man label|Number of merges done}} dialog with the resulting number that contain '''"../"''' forms are also properly collapsed during the comparisonwas merged.
All of ===No modifications made===If no duplicate media is found or remain to be merged you will see the above allows {{man label|No modifications made}} dialog with the addon to find variations result that actually point to the same file"no media media items merged".
The addon will NOT find variations that include 'links'.==What is it For?==The addon will NOT find 'UNC' style paths {{man label|Merge Media}} tool searches your database for media file entries that have been assigned are pointing to drive letters (Windows users)the same actual file. For exampleThis can occur with certain import types, and can occur if '''"\\MyPC\d"''' is assigned to the drive letter '''"D:"'''user adds the same media more than once. When found, and files they are entered each way, they will not be matched and mergedtogether.
The {{man label|Merge Media}} tool:* Compares all the media 'pathname' values, converting them internally to a common format for comparison.* For Windows users, differences in capitalization on the path are ignored, as are differences in the path separators '''"<code>\</code>"''' vs. '''"<code>/</code>"'''.* For all users paths that are relative (using {{man menu|Edit -> Preferences -> Base path for relative media paths}}) are also compared to absolute paths or paths relative to your home directory.* For all users, paths that contain '''"<code>../</code>"''' forms are also properly collapsed during the comparison.* All of the above allows the addon to find variations that actually point to the same file.* The addon will NOT find variations that include 'links'.* The addon will NOT find 'UNC' style paths that have been assigned to drive letters (Windows users). For example, if '''"<code>\\MyPC\d</code>"''' is assigned to the drive letter '''"<code>D:</code>"''', and files are entered each way, they will not be matched and merged.* When merges are done, the media with the shortest pathname is kept.* If pathnames have equal length, then the one with the lowest 'ID' is kept. {{-}}If no duplicate media is found or remain to be merged you will see the {{man label|No modifications made}} dialog with the result that "no media media items merged".
== See also==
* The Third-party Addon {{man label|[[Media Verify Tool]]}} is used verify a one-to-one relationship between media objects and files in the media directory.
* [[Media Management]]
[[Category:Plugins]]
[[Category:Tools]]
[[Category:Developers/General]]
[[Category:Media]]
2,102
edits

Navigation menu