2021-12-04 - Sorry the Gramps wiki is currently being upgraded to a newer software version. Please check back after the 2021-12-06.

Difference between revisions of "Addon:MediaMerge"

From Gramps
Jump to: navigation, search
(What is it For?)
 
(4 intermediate revisions by 2 users not shown)
Line 10: Line 10:
 
The tool then scans your family tree and depending on the result you are then presented with the:
 
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#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?
+
* {{man label|[[Addon:MediaMerge#Number_of_merges_done|Number of merges done]]}} dialog with the result of the automatic merge
  
 
===Number of merges done===
 
===Number of merges done===
Line 19: Line 19:
  
 
==What is it For?==
 
==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 {{man label|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 the media 'pathname' values, converting them internally to a common format for comparison.
+
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 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 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.
For all users, paths that contain '''"<code>../</code>"''' forms are also properly collapsed during the comparison.
+
* 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.
All of the above allows the addon to find variations that actually point to the same file.
+
* 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.
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.
 
 
 
{{-}}
 
  
 
== See also==
 
== See also==
Line 50: Line 41:
 
* 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.  
 
* 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:Plugins]]
 
[[Category:Tools]]
 
[[Category:Tools]]
 
[[Category:Developers/General]]
 
[[Category:Developers/General]]
 +
[[Category:Media]]

Latest revision as of 22:34, 2 November 2020

Error creating thumbnail: Unable to save thumbnail to destination

Please use carefully on data that is backed up, and help make it better by reporting any comments or problems to the author, or issues to the bug tracker
Unless otherwise stated on this page, you can download this addon by following these instructions.
Please note that some Addons have prerequisites that need to be installed before they can be used.
This Addon/Plugin system is controlled by the Plugin Manager

Error creating thumbnail: Unable to save thumbnail to destination
Media Merge Tool's "Number of merges done" Results dialog and Before(top) and After(Bottom) screenshots of the Media List View

The 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.

Usage

Select Tools ->Family Tree Processing -> Merge Media from the menu.

The tool will start with an 'Undo history warning' that suggest that you back up your work.

The tool then scans your family tree and depending on the result you are then presented with the:

Number of merges done

If any duplicate media is found and merged you will see the Number of merges done dialog with the resulting number that was merged.

No modifications made

If no duplicate media is found or remain to be merged you will see the No modifications made dialog with the result that "no media media items merged".

What is it For?

The 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 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 "\" vs. "/".
  • For all users paths that are relative (using 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 Third-party Addon Media Verify Tool is used verify a one-to-one relationship between media objects and files in the media directory.