Difference between revisions of "Addon:Media Verify Tool"
(→Verify) |
m |
||
| (25 intermediate revisions by 3 users not shown) | |||
| Line 1: | Line 1: | ||
{{Third-party plugin}} | {{Third-party plugin}} | ||
[[File:MediaVerifyTool-default-51.png|thumb|right|450px|Media Verify Tool - dialog - default]] | [[File:MediaVerifyTool-default-51.png|thumb|right|450px|Media Verify Tool - dialog - default]] | ||
| − | The {{man label|Media Verify Tool}} is used verify a one-to-one relationship between media objects and files in the media directory | + | The {{man label|Media Verify Tool}} is used verify a one-to-one relationship between media objects and files in the media directory. |
| − | + | The main purpose of the tool is to locate files that have been moved and fix the paths. | |
This tool uses [https://en.wikipedia.org/wiki/MD5 MD5 checksums] to verify the integrity of files under the media directory. It also allows users to use a file manager of their choice to manage media objects. | This tool uses [https://en.wikipedia.org/wiki/MD5 MD5 checksums] to verify the integrity of files under the media directory. It also allows users to use a file manager of their choice to manage media objects. | ||
== Preparation == | == Preparation == | ||
| + | [[File:EditPreferences-General-tab-example-51.png|Right|thumb|450px|Preferences - General tab showing the "Base path for relative media paths" setting ]] | ||
| − | + | The {{man label|Media Verify Tool}} tool assumes that you store all your media files under a media directory. You can specify this directory by setting the {{man label|[[Gramps_{{man version}}_Wiki_Manual_-_Settings#General|Base path for relative media paths]]}} in the {{man label|General}} tab, under the {{man menu|Edit->Preferences}} menu option. | |
| + | {{-}} | ||
== Usage == | == Usage == | ||
| Line 17: | Line 19: | ||
The {{man label|Media Verify Tool}} dialog is display with the following choices: | The {{man label|Media Verify Tool}} dialog is display with the following choices: | ||
* The {{man button|Close}} button when selected will exit the tool. | * The {{man button|Close}} button when selected will exit the tool. | ||
| − | * The {{man button|[[ | + | * The {{man button|[[Addon:Media Verify Tool#Generate|Generate]]}} button will generate MD5 checksums for all media objects. |
| − | * The {{man button|[[ | + | * The {{man button|[[Addon:Media Verify Tool#Verify|Verify]]}} button will perform various checks against your media objects in Gramps and media files under your media directory. |
| − | * The {{man button|[[ | + | * The {{man button|[[Addon:Media Verify Tool#Export|Export]]}} button when selected will export the report as a text file. |
| − | * The {{man button|[[ | + | * The {{man button|[[Addon:Media Verify Tool#Fix|Fix]]}} button will fix the paths in the media objects to match the new paths listed in the {{man button|Verify}} - {{man label|[[Addon:Media Verify Tool#Moved.2FRenamed_Files|Moved/Renamed Files]]}} section tab. |
{{-}} | {{-}} | ||
=== Generate === | === Generate === | ||
| − | [[File:Results-from-generate-media-verify-tool.png|right|thumb| | + | [[File:Results-from-generate-media-verify-tool.png|right|thumb|550px]] |
Clicking the {{man button|Generate}} button will generate MD5 checksums for all media objects. You should run this after you have added or changed any media files. Media objects without MD5 checksums will be listed as part of the media verification. Resulting {{man label|Errors}} will be displayed in the tab if any. | Clicking the {{man button|Generate}} button will generate MD5 checksums for all media objects. You should run this after you have added or changed any media files. Media objects without MD5 checksums will be listed as part of the media verification. Resulting {{man label|Errors}} will be displayed in the tab if any. | ||
{{-}} | {{-}} | ||
=== Verify === | === Verify === | ||
| − | + | Clicking the {{man button|Verify}} button will perform various checks against your media objects in Gramps and media files under your media directory and display the following section tabs only if that type of issue is present eg: | |
| − | Clicking the {{man button|Verify}} button will perform various checks against your media objects in Gramps and media files under your media directory | + | * {{man label|[[Addon:Media Verify Tool#Moved.2FRenamed_Files|Moved/Renamed Files]]}} - |
| − | * {{man label|[[ | + | * {{man label|[[Addon:Media Verify Tool#Missing_Files|Missing Files]]}} - |
| − | * {{man label|[[ | + | * {{man label|[[Addon:Media Verify Tool#Duplicate_Files|Duplicate Files]]}} - |
| − | * {{man label|[[ | + | * {{man label|[[Addon:Media_Verify_Tool#Extra_Files|Extra Files Files]]}} - |
| − | * {{man label|Extra Files Files}} - | + | * {{man label|[[Addon:Media Verify Tool#No_MD5_Generated|No MD5 Generated]]}} - |
| − | * {{man label|No MD5 Generated}} - | ||
{{-}} | {{-}} | ||
==== Moved/Renamed Files ==== | ==== Moved/Renamed Files ==== | ||
| − | + | [[File:MediaVerifyTool1.png|thumb|right|550px|]] | |
| − | [[ | ||
Files that have moved or renamed are listed in the {{man label|Moved/Renamed Files}} tab. Where there are multiple files with the same checksum under the media directory, the first one listed with the same name as the original will be displayed. | Files that have moved or renamed are listed in the {{man label|Moved/Renamed Files}} tab. Where there are multiple files with the same checksum under the media directory, the first one listed with the same name as the original will be displayed. | ||
Double clicking on a row will edit the associated media object. | Double clicking on a row will edit the associated media object. | ||
| − | + | {{-}} | |
==== Missing Files ==== | ==== Missing Files ==== | ||
| − | + | [[File:MediaVerifyTool2.png|thumb|right|550px|]] | |
| − | [[ | ||
Media objects are listed in the {{man label|Missing Files}} tab, when there is no file found with a matching checksum. | Media objects are listed in the {{man label|Missing Files}} tab, when there is no file found with a matching checksum. | ||
Double clicking on a row will edit the associated media object. | Double clicking on a row will edit the associated media object. | ||
| − | + | {{-}} | |
==== Duplicate Files ==== | ==== Duplicate Files ==== | ||
| − | + | [[File:MediaVerifyTool3.png|thumb|right|550px|]] | |
| − | [[ | ||
Files with duplicate checksums are listed in the {{man label|Duplicate Files}} tab. | Files with duplicate checksums are listed in the {{man label|Duplicate Files}} tab. | ||
Double clicking on a row will display the image in the default viewer. | Double clicking on a row will display the image in the default viewer. | ||
| − | + | {{-}} | |
| − | ==== Extra | + | ==== Extra Files ==== |
| − | + | [[File:MediaVerifyTool4.png|thumb|right|550px|]] | |
| − | [[ | ||
Files that are under the media directory, but not yet in Gramps are listed in the {{man label|Extra Files}} tab. | Files that are under the media directory, but not yet in Gramps are listed in the {{man label|Extra Files}} tab. | ||
Double clicking on a row will display the image in the default viewer. | Double clicking on a row will display the image in the default viewer. | ||
| + | {{-}} | ||
==== No MD5 Generated ==== | ==== No MD5 Generated ==== | ||
| − | + | [[File:MediaVerifyTool5.png|thumb|right|550px|]] | |
| − | [[ | ||
Media objects with no checksum are listed in the {{man label|No MD5 Generated}} tab. | Media objects with no checksum are listed in the {{man label|No MD5 Generated}} tab. | ||
Double clicking on a row will edit the associated media object. | Double clicking on a row will edit the associated media object. | ||
| + | {{-}} | ||
=== Export === | === Export === | ||
| − | Clicking the {{man button|Export}} button will | + | Clicking the {{man button|Export}} button will show the {{man label|Export results to a text file}} dialog so you can save the report. |
| + | |||
| + | ==== Example results text file ==== | ||
| + | The results text file when viewed will show each type of issue displayed in its own section. | ||
| + | |||
| + | <pre> | ||
| + | Missing Files | ||
| + | 1897_expeditionsmannschaft_rio_a.jpg | ||
| + | Gunnlaugur_Larusson_-_Yawn.jpg | ||
| + | 654px-Aksel_Andersson.jpg | ||
| + | Alimehemet.jpg | ||
| + | E_W_Dahlgren.jpg | ||
| + | AntoineClaudet.png | ||
| + | scanned_microfilm.png | ||
| + | </pre> | ||
=== Fix === | === Fix === | ||
| − | Clicking the {{man button|Fix}} button will fix the paths in the media objects to match the new paths listed in the listed in the {{man button|Verify}} - {{man label|[[ | + | Clicking the {{man button|Fix}} button will fix the paths in the media objects to match the new paths listed in the listed in the {{man button|Verify}} - {{man label|[[Addon:Media Verify Tool#Moved.2FRenamed_Files|Moved/Renamed Files]]}} section tab. |
| + | |||
| + | == 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#Replace_substrings_in_the_path|Replace substrings in the path]]}} | ||
| + | ** {{man label|[[Gramps_{{man version}}_Wiki_Manual_-_Tools#Convert_paths_from_relative_to_absolute|Convert paths from relative to absolute]]}} | ||
| + | ** {{man label|[[Gramps_{{man version}}_Wiki_Manual_-_Tools#Convert_paths_from_absolute_to_relative|Convert paths from absolute to relative]]}} | ||
| + | ** {{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:MediaMerge|Merge Media]]}} that searches your database for media file entries that are pointing to the same actual file and when found, they can be merged together. | ||
| + | |||
| + | * [[Media Management]] | ||
== Issues == | == Issues == | ||
| + | * Add a help button pointing here | ||
* {{bug|7144}} Media Verify: wrong handling of non-ascii characters | * {{bug|7144}} Media Verify: wrong handling of non-ascii characters | ||
* {{bug|6744}} Add Merge for Media Verify Plugin | * {{bug|6744}} Add Merge for Media Verify Plugin | ||
| Line 97: | Line 121: | ||
* Removing unused duplicate files. | * Removing unused duplicate files. | ||
* Creating media objects for unused files. | * Creating media objects for unused files. | ||
| − | |||
| − | |||
[[Category:Plugins]] | [[Category:Plugins]] | ||
[[Category:Developers/General]] | [[Category:Developers/General]] | ||
| + | [[Category:Media]] | ||
Latest revision as of 01:09, 31 January 2022
|
This is a Third-party Addon. 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 |
The Media Verify Tool is used verify a one-to-one relationship between media objects and files in the media directory.
The main purpose of the tool is to locate files that have been moved and fix the paths.
This tool uses MD5 checksums to verify the integrity of files under the media directory. It also allows users to use a file manager of their choice to manage media objects.
Contents
Preparation
The Media Verify Tool tool assumes that you store all your media files under a media directory. You can specify this directory by setting the Base path for relative media paths in the General tab, under the Edit->Preferences menu option.
Usage
You can access the tool from the Tools > Utilities > Media Verify... menu.
The Media Verify Tool dialog is display with the following choices:
- The Close button when selected will exit the tool.
- The Generate button will generate MD5 checksums for all media objects.
- The Verify button will perform various checks against your media objects in Gramps and media files under your media directory.
- The Export button when selected will export the report as a text file.
- The Fix button will fix the paths in the media objects to match the new paths listed in the Verify - Moved/Renamed Files section tab.
Generate
Clicking the Generate button will generate MD5 checksums for all media objects. You should run this after you have added or changed any media files. Media objects without MD5 checksums will be listed as part of the media verification. Resulting Errors will be displayed in the tab if any.
Verify
Clicking the Verify button will perform various checks against your media objects in Gramps and media files under your media directory and display the following section tabs only if that type of issue is present eg:
Moved/Renamed Files
Files that have moved or renamed are listed in the Moved/Renamed Files tab. Where there are multiple files with the same checksum under the media directory, the first one listed with the same name as the original will be displayed.
Double clicking on a row will edit the associated media object.
Missing Files
Media objects are listed in the Missing Files tab, when there is no file found with a matching checksum.
Double clicking on a row will edit the associated media object.
Duplicate Files
Files with duplicate checksums are listed in the Duplicate Files tab.
Double clicking on a row will display the image in the default viewer.
Extra Files
Files that are under the media directory, but not yet in Gramps are listed in the Extra Files tab.
Double clicking on a row will display the image in the default viewer.
No MD5 Generated
Media objects with no checksum are listed in the No MD5 Generated tab.
Double clicking on a row will edit the associated media object.
Export
Clicking the Export button will show the Export results to a text file dialog so you can save the report.
Example results text file
The results text file when viewed will show each type of issue displayed in its own section.
Missing Files
1897_expeditionsmannschaft_rio_a.jpg
Gunnlaugur_Larusson_-_Yawn.jpg
654px-Aksel_Andersson.jpg
Alimehemet.jpg
E_W_Dahlgren.jpg
AntoineClaudet.png
scanned_microfilm.png
Fix
Clicking the Fix button will fix the paths in the media objects to match the new paths listed in the listed in the Verify - Moved/Renamed Files section tab.
See also
- The builtin Media Manager which is group of four separate tools that allows you to do the following:
- The Third-party Addon Merge Media that searches your database for media file entries that are pointing to the same actual file and when found, they can be merged together.
Issues
- Add a help button pointing here
- 7144 Media Verify: wrong handling of non-ascii characters
- 6744 Add Merge for Media Verify Plugin
Possible future enhancements
This tool could be enhanced to perform other tasks, such as:
- Merging media objects with duplicate files.
- Updating the checksum for modified files.
- Removing unused duplicate files.
- Creating media objects for unused files.
