Changes

Jump to: navigation, search

Addon:MediaMerge

128 bytes added, 01:03, 31 January 2022
m
no edit summary
The tool then scans your family tree and depending on the result you are then presented with the:
* {{man label|[[Addon:MediaMerge#No_modifications_made|No modifications made]]}} dialog - if no media needs to be merged.
* {{man label|[[Addon:MediaMerge#Number_of_merges_done|Number of merges done]]}} dialog with the result of the automatic merge?
===Number of merges done===
==What is it For?==
The {{man menulabel|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 {{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.
For Windows users, differences in capitalization on the path are ignored, as are differences in the path separators '''"\"''' vs. '''"/"'''.
 
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 '''"../"''' 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 '''"\\MyPC\d"''' is assigned to the drive letter '''"D:"''', 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.
 
{{-}}
== See also==
* The builtin {{man label|[[Gramps_{{man version}}_Wiki_Manual_-_Tools#Media_Manager|Media Manager]]}} which is group of four separate tools that allows you to do the following:
** {{man label|[[Gramps_{{man version}}_Wiki_Manual_-_Tools#Add_images_not_included_in_database|Add images not included in database]]}}
* The Third-party Addon {{man label|[[Addon:Media Verify Tool|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]]

Navigation menu