Check for Unlinked Media

Checks all the media files in the media folder are linked to media records in the Project and optionally can delete or move unlinked files.

Note deleted or moved files can not be recovered using the Undo option in Family Historian as the deletes are done directly on the disk. It is therefore recommended you do a FULL Family Historian Project Backup prior to running.

V1.2 Added Move files
V1.3 Handles problems where users have the media incorrectly linked to the media folder (e.g using full path names)
V1.4 Correct Issue where Project has special characters in the name,
V1.5 Check for Locally Linked Files in the media folder.
V1.6 Add more robust dirtree function (to handle Mac Directories with invalid windows characters in filenames.
V1.7 Use newer dirtree version
V1.8 Corrections to Media detection (Thanks Mike Tate)
V1.9 Exclude thumbs.db and picassi.ini from list.

Rating: Not Rated

+ Add Comment and optionally Rate the Plugin

This will not be displayed
please rate this plugin, 1 = Poor, 5=Excellent


A very useful plugin. May I make a request for an additional facility, please?

I use Picasa to edit my multimedia images but Picasa creates thumbnails which are then picked up by this plugin as "Unlinked" media files. Would it be possible to extend the plugin to exclude any Picasa folders? On my iMac the folders are all called ".picasaoriginals" (including the leading full stop). I don't know what they would be called on a PC.


Gerry Newnham, April 12, 2013 at 11:35 am

Extremely useful.  the Check for External Media is invaluable to keep orphans from appearing in your media folders. For me, this plugin in combination with Where Used plugin and External file links tool gives total control to keep my media and notes organized and orphan free.

Ron Krzmarzick, March 1, 2016 at 11:02 pm

Could I suggest a mod to the 'Checked for Unlinked Media' plugin please?

For users with Macs there is an extra file which is put into each folder, called .DS_Store
If, like me, you have a lot of folders, it can be a bit of a pain.
However by modding line 92 as follows, it stops them being returned in the results

if file ~= 'thumbs.db' and file ~='.picasa.ini' and file ~= '.ds_store' then

Many thanks

Dave Simpson, November 28, 2019 at 12:44 pm