Introduction

Welcome to the SMDB Companion user manual! This software helps you find and remove duplicate audio files from your Soundminer databases. This manual will guide you through the installation process, setup, usage, and advanced features of the application.

Installation and Setup

Follow the steps below to install and set up SMDB Companion:

1. Download the latest version of SMDB Companion from our download page.
2. Unzip the downloaded file and place in your Applications directory on your computer.
3. Ensure that you have Soundminer installed, as SMDB Companion requires it to function properly.
4. Ensure that System Settings -> Privacy & Security is set to allow: "App Store and identified developers"
5. Run the application by double-clicking the executable file (SMDB_Companion).

Registration

You will need to enter your registration code to remove duplicates from your database. If you do not have a registration code, you can purchase one from our website. After purchase, your registration information will be sent to you via the email you use for purchasing.

The registration menu can be found under the "File" menu in the top left. Enter your name, email, and license key and click "Validate" to register.

NOTE: The registration code is CASE SENSITIVE. Please copy and paste the code from the email to avoid any errors.

Upon successful registration, you will see your registered name in the bottom of the application.

Getting Started

After installing SMDB Companion, it *strongly recommended* you back up your Soundminer databases before running the program.

1. Launch SMDB Companion and click "Open Database" to choose the Soundminer database you want to scan.

2. Choose which duplicate search algorithms you wish to enable and adjust any options. Hovering your mouse over an algorithm with reveal a tooltip with a brief description of what it does.
3. Click "Search for Duplicates" to begin finding duplicate audio files in your database.

4. If duplicates are found, a button for "Remove Duplicates" will be enabled. Click to Remove.
5. If you have registered, you will also have to option to see your search results.

For more detailed information on how to use the program, please refer to the "Features and Functionalities" section below.

Features and Functionalities

SMDB Compaion offers two ways to work with your Soundminer Databases:

• Duplicate Search and Removal: Find and remove duplicate audio files from your Soundminer database.
• Metadata Find and Replace: Search for metadata in your database and replace it with new values.

You can choose which feature you want to work with under the "Action" Menu.

Duplicate Search

There are six search algorithms to choose from:

• Basic Search:

  This will search for duplicates based on the criteria you provide in the options. The default match criteria are File Name, File Duration, and number of Channels in the file. This means that for two files to be considered duplicates they must match on all three criteria.

• Similar Filename:

  This will search for filenames that have the same root, but different numbers at the end. For example: example.wav and example.1.wav will be considered a duplicate match. The ignore file types option means: example.wav and example.1.flac will be considered a match.

• Tags:

  This is not a duplicate finder, but rather identifies audio files where the filename contains a string of characters. When Protools processes a file in AudioSuite, it adds a tag to show the plugin used to process the file. This feature is designed to help identify and purge processed audio files where the source already exists in your library.

• Audio Length:

  Similar to tags, this simply looks for files that are less than the duration specified. Useful for finding random short Audio Files. Be careful if you have glitch libraries.

• Audio Content:

  This will analyze the audio content of your files and look for files that have matching content. This will help weed out duplicates that have completely different names, but the same content. This can be very slow on large libraries. It is recommend to run this on a database that has already been examined by the other algorithms.

• Database Compare:

  This algorithm compares the opened database with a different database of the user's selection. Any file name in the open database that exists in the comparison database will be marked for removal. This is useful for combining two databases.

Duplicate Removal

After running the search algorithms, you will be presented with the number of results found and the option to remove them. How SMDB Companion decides which file to keep can be configured under "Preferences -> File Preservation Priority". To learn more about this, please go to Advanced Usage.

Duplicate File Removal Options:

• Create New Database of Thinned Records:

  This will create a new database with the duplicates removed. The original database will be untouched. WARNING: If you disable this, you will remove the duplicates from the currently open database directly.

• Create New Database of Duplicate Records:

  This will create a new database with only the duplicates. The original database will be untouched. If you disable this, this database will simply not be created.

• Remove Duplicate Files from Disk:

  This is off by default as the preferred method is to use your Soundminer databased to manage your audio library. However, if enabled, this will remove the files marked as duplicates from the disk. You have the option to move them to the trashcan or permanently delete. WARNING: Permanent deletion cannot be undone.

Metadata Find and Replace

This is a simple tool to help you quickly find and replace metadata in your database. The intended use was for updating filepaths when you move audio around on your drive, but it has to power to find and replace anything you like.

Advanced Usage

SMDB Companion has the ability to customize the logic used to select which file should be kept in a set of duplicates. This allow you to help it decide which files you prefer to keep in a set of duplicates.

This can be configured under "Preferences -> File Preservation Priority".

• Top Toolbar:

  This will help you create new rules to add to the list.

• Rules List:

  The list represents the rule order SMDB Companion will use to decide which file to keep. If all duplicate candidates match the first criteria, it will move to check the next one, so rules at the top of the list are more important than those below.

• Bottom Toolbar:

  These buttons allow you to change the order of the list or remove a rule.

Tips and Tricks

• Audio Content Algorithm:

  You will be tempted to use this right away, however as it has to scan each file indiviually, it can be quite slow on large databases. The recommended workflow is to use the other algorithms first to create a database with less records, and then run this algorithm on the newly created database.

• Create Thinned Database First:

  It will take some time to get the hang of how SMDB Companion chooses it's duplicates. Preserve your database by enabled the "Create New Database of Thinned Records" feature. Once you have a feel for how it works, then you can uncheck this option to manipulate your databases directly.

• Utilize the Duplicates Database:

  When you are first working with the program, creating the optional database of duplicates is a faster to way to quickly see which files it is choosing to delete. Once you have your settings dialed in, this option can be turned off

• Take some time to configure the Perservation Priority:

  Everyone's library is organized differently, and you will know best which files you want to keep versus which files you want to remove. In our personal library, we found rules based on filepath to be the most effective for teaching SMDB Companion to preserve the files we wanted. File Preservation Priority can be found under the 'Preferences" menu at the top.

• Don't Delete Files:

  While SMDB Companion has the ability to delete files from you disk, the intended work flow is for you to create a new Database without any duplicates and use Soundminer's Mirror function to duplicate it. This will protect your library from data loss.

• Adding New Media to your Library:

  When adding new media to your master library, create a new database just for the media you want to add and then scan and remove duplicates with SMDB Companion. You can use the compare algorithm to ensure you are not adding duplicates back into your library.

Contact/Support Information

If you need further assistance, please contact our support team:

• Email: [email protected]
• Website: www.smdbc.com