Difference between revisions of "Addon:Media Verify Tool"

From Gramps
Jump to: navigation, search
(Description)
Line 5: Line 5:
 
== Preparation ==
 
== Preparation ==
  
This tool assumes that you are using relative media paths and have a base path setIn the "General" tab, under the Edit->Preferences menu option, you can set the "Base path for relative media paths".
+
This tool assumes that you store all your media files under a media directoryYou can specify this directory by setting the "Base path for relative media paths" in the "General" tab, under the Edit->Preferences menu option.
  
 
== Description ==
 
== Description ==
Line 19: Line 19:
 
Clicking the "Verify" button will perform various checks against your media objects in Gramps and media files under your media directory.
 
Clicking the "Verify" button will perform various checks against your media objects in Gramps and media files under your media directory.
  
* Files that have moved are listed in the "Moved Files" section.  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 are listed in the "Moved/Renamed Files" section.  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.
  
 
* Media objects are listed in the "Missing Files" section, when there is no file found with a matching checksum.
 
* Media objects are listed in the "Missing Files" section, when there is no file found with a matching checksum.
Line 31: Line 31:
 
=== Fix ===
 
=== Fix ===
  
Clicking the "Fix" button will fix the paths in the media objects to match the new paths listed in the "Moved Files" section.
+
Clicking the "Fix" button will fix the paths in the media objects to match the new paths listed in the "Moved/Renamed Files" section.
 +
 
 +
=== Export ===
 +
 
 +
Clicking the "Export" button will export the report as a text file.

Revision as of 17:10, 8 May 2013

Purpose

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.

Preparation

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

Description

MediaVerifyTool1.png

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.

Verify

Clicking the "Verify" button will perform various checks against your media objects in Gramps and media files under your media directory.

  • Files that have moved are listed in the "Moved/Renamed Files" section. 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.
  • Media objects are listed in the "Missing Files" section, when there is no file found with a matching checksum.
  • Files with duplicate checksums are listed in the "Duplicate Files" section.
  • Files that are under the media directory, but not yet in Gramps are listed in the "Extra Files" section.
  • Media objects with no checksum are listed in the "No md5 Generated" section.

Fix

Clicking the "Fix" button will fix the paths in the media objects to match the new paths listed in the "Moved/Renamed Files" section.

Export

Clicking the "Export" button will export the report as a text file.