Copyright 2021 - HappyOtterScripts by The Happy Otter
MediaFinder is a tool that is designed to easily search for and replace project media. It can also be used for finding new media that can be added to the project.
1. What to Search For.
a. Selected Media. Search for media that have been selected in the Project Window.
b. All Media. Search for all project media except for generated media such as Text and Titles.
c. Missing Media. Only search for missing media that have been identified as "Offline".
d. New Media. Search for new media that can be added to the project. If selected, "Click to Enter Search Name" is enabled. Once clicked, you can enter the name to be searched. A wildcard * is permitted for use in both the file name and its extension. A green checkbox and red X appear which permit the user to enter the search name or cancel. If the "check" is clicked, the name will be entered in the first available row of the grid. Additional names can be subsequently entered.
e. Add Wildcard To: A wildcard can automatically be added to the search name. If the Name checkbox is ticked, a wildcard will be added both as a prefix and suffix. If the Ext checkbox is ticked, the extension will be replaced with a wildcard indicating that the search results will include any extension.
f. Reload. If clicked, the Selected Media, All Media, or Missing Media will be reloaded. If New Media had selected, the search name(s) will be reset and must be re-entered.
2. Where to Search. Identifies folders to be searched, folders to be excluded from the search, the order of folders to be searched, and whether the search should include subdirectories. Each time the script launches, a scan is performed for existing logical drives and their names. Those folders become the Default folders to be searched. There are also Default folders to be excluded including Program Files, Program Data, Users, and Windows on the system drive. The easiest way of populating the folders listbox is by dragging and dropping selected folders from Windows Explorer.
a. Check/Uncheck Checkbox. Ticking/unticking the checkbox will toggle between all folders selected and no folders selected.
b. Include . If checked, the listbox with checkboxes will show folders to be included. Folders will be included only if they are checked.
c. Exclude . If checked, the listbox with checkboxes will show folders to be excluded. Folders will be excluded only if they are checked.
d. Template Dropdown List . Templates may be created which are a combination of folders included and folders excluded for a given search. The dropdown list shows available templates. Each time MediaFinder starts the template shown is the Last Used.
e. Add Template Button. A template may be added or saved by first entering text into the template dropdown list and then clicking on the green plus button.
f. Delete Template Button. A template may be deleted by first selecting from the dropdown list and then clicking on the red X button.
g. Up Down Buttons. The order of folder search may be changed by use of the up and down buttons. First select the folder in the listbox and then click on the up arrow or down arrow buttons to change its order.
h. Folder Delete Button. Folders to be deleted from the list must first be checked. Then click on the red X button beneath the up/down buttons to remove those folders from the listbox.
i. Add Folder Dialog. The add folder dialog can be opened by clicking on the folder button.
j. Rescan Logical Drives. Logical drives and their associated names will be rescanned and shown as the Default template.
k. Search Subdirectories Checkbox. If checked, subdirectories of the folders shown in the list will also be searched recursively.
3. How to Filter. Search results may be filtered by date, file size, type of extension, and parts of the file name (referred to as Substrings) such as a prefix or suffix. Like folders, the user may define a list of items to include as well as exclude in setting up the desired filter package. Templates of filter settings may also be created and saved for future use.
a. Add Filters Checkbox. If checked, the How to Filter dialog is enabled and the filter settings will be applied during the initial search. Until the user becomes familiar with how these filters operate, it is recommended that the initial search be done with the Add Filters checkbox "unticked". It is also recommended that wildcards be added during the initial search to produce a fairly large initial set of potential matches since it is the initial search that takes most time. Once the initial search is completed, the addition of different filter options is very quick.
b. Dates. Results may be filtered by date. The date used for filtering is "Date Modified" in Windows Explorer. To include media files created after a specific date, tick the "From" checkbox and enter the date. To include media files created before a specific date, tick the "To" checkbox and enter the date. To specify a date range, tick both checkboxes. To reset the dates to the current date, click on the Date Reset button.
c. Include . If checked, the listbox with checkboxes will show extensions or substrings to be included. These extensions or substrings will be used during filtering only if they are checked.
d. Exclude . If checked, the listbox with checkboxes will show extensions or substrings to be excluded. These extensions or substrings will be used during filtering only if they are checked.
e. Extensions. The most common way of filtering is use of filetype extensions. The most common extensions have been included as the default and can be seen above. Ticking "All" will yield matches with any type of extension. Clicking "Exclude" will show the default extensions to be excluded. These include only .sfk and .sfl filetypes. There is also a "None" option which, if ticked, will not exclude any files based on the list of excluded extensions. New extensions may be added by clicking on the "Click to Add Extension" button. The name of the new extension may then be entered. A green checkbox and red X also appear which permit the user to enter the search name or cancel. If the "check" is clicked, the new extension is added. If the "X" is clicked, the operation is canceled.
f. Substring 1 . A substring of the filename may be entered as a rule for inclusion or exclusion . E.g. if proxy files were created using the default filetag name "Proxy", that term may be used as a filter for including or excluding matches. New substrings may be added by clicking on the "Click to Add Substring" button. When either Substring 1 or Substring 2 is selected, the button name changes from "Click to Add Extension" to "Click to Add Substring". The name of the new substring may then be entered. A green checkbox and red X also appear which permit the user to enter the search name or cancel. If the "check" is clicked, the new substring is added. If the "X" is clicked, the operation is canceled.
g. Substring 2 . Works the same as Substring 1. If a second string is added, it becomes possible to increase the complexity of your search by adding "AND" or "OR" conditions.
h. File Size Only . If checked, matches will be based on file size only, thus enabling potential matches when the file name has changed.
i. Check/Uncheck Checkbox . ◻ Ticking/unticking the checkbox will toggle between all extensions or substrings selected and no extensions or substrings selected.
j. Template Dropdown List . Templates may be created which are a combination of extensions and substrings included and extensions and substrings excluded for a given search. The dropdown list shows available templates. Each time MediaFinder starts the template shown is the Last Used.
k. Add Template Button. A template may be added or saved by first entering text into the template dropdown list and then clicking on the green plus button.
l. Delete Template Button. A template may be deleted by first selecting from the dropdown list and then clicking on the red X button.
m. Extensions/Substrings Delete Button. Extensions or substrings to be deleted from the list must first be checked. Then click on the red X button to remove those extensions or substrings from the listbox.
n. Click to Add Extension Button . See e and f above for information on this button.
o. Update Button. Once filter settings have been changed, click the "Update" button and the new matches will be displayed in the main datagrid.
4. What to Do. Following a successful search, there are two options.
a. Replace Media. Project media will be replaced by the new media. To replace a media file, both the first and last checkbox in the datagrid must be ticked.
b. Add to Project Media. If ticked, the selected matches will simply be added to the project media.
c. Checkbox. If ticked, the media will also be added to the media bin selected in the dropdown list.
5. Search Button. Starts the search process.
6. Commit Button. Starts the process of replacing media or adding media to the project.
7. Cancel Button. Exits the script.
8. Search Datagrid. Search names and file matches are displayed in tabular form. There are six columns within the datagrid which can be resized. A row is created for each potential "match".
a. Column 1. The checkbox in the Header Row toggles between all rows being checked and all rows being unchecked. Right-clicking on the checkbox brings up a context menu that allows one to delete rows that are selected. NOTE: Selected does not mean checked. To select a row, the user must click on the first column (blank) in the cell corresponding to the row that is to be selected. When selected, the entire row turns gray.
b. Column 2 - Project Media Files. Displays the full file path of the project media. This column cannot be edited.
c. Column 3 - Media Search Name. Displays the search name along with wildcards if selected. Note that this column CAN be edited. As such, a media file can be replaced by another file having a name that is completely different from the original name.
d. Column 4 - Ext. Displays the search name extension or the wildcard symbol if selected. Note that this column CAN also be edited thus permitting a change of extensions during the initial search.
e. Column 5 - Media File Matches. Displays the resulting matches from a search. This column cannot be edited.
f. Column 6. Like Column 1, the checkbox in the Header Row toggles between all rows being checked and all rows being unchecked.
9. Media File Context Menu. Right-clicking on a selected item in the Project Media Files column or Media File Matches column results in the following dialog.
a. Show MediaInfo. If the 64bit GUI version of MediaInfo is installed, it will be launched the the media file information displayed. For example:
b. Show File Properties. If selected, the following message box will be shown.
c. Go To File Location. If selected, a new Windows Explorer dialog will be opened to the folder location and the file will be selected. For example:
d. Open with Default. If selected, the default app for the media file will be opened according to the user's file associations.
e. Open with MPC-HC. Opens media files with Media Player Classic-Home Cinema that was included as part of the Happy Otter Scripts installation. For example, an audio file:
f. Send to Recyle Bin. Selected items from ONLY Media File Matches may be sent to the recyle bin. Project Media Files cannot be recycled.