Locations: Libraries

Libraries are folders on your harddrive that have been analyzed by the software.

The libraries tab

The libraries tab

  1. Libraries - list of libraries that are currently available
  2. Folder tree - displays folders for the selected library
  3. Search Results - a table displaying your search results

Technically, a library is a small database containing additional information about the samples. This includes properties such as tempo, pitch, brightness and so on. These data provide the foundation for similarity-search and many other features.

List of libraries

The list of active libraries appear in the topmost part of the Location sidepanel, while the “Libraries” tab is active. Click to select a library, or right-click/press the “gear” icon to bring up the context-menu.

The list can contain any number of libraries, but does not necessarily contain all your libraries, as you can add and remove them at will. Use the explore tab if you wish to locate all your libraries.

The panel allows you to drag items around in order to re-arrange them:

Dragging items to re-arrange

Dragging items to re-arrange

In addition to re-arranging by dragging, you can also sort libraries by name or path via the context menu.

Creating & Opening

If you’ve used Sononym for more than a few minutes, you will probably already have created a library. Even the introduction to the software (shown the first time the software is run) will encourage you to create a library right away.

Creating a new library is meant to be as easy as possible - you can simply drag a folder on top of the application. Alternatively, you can pick a folder using the “Add library” button, or by choosing “Create Library” from the File menu.

If the selected folder is already a library (containing a file named sononym.db), it will be made accessible right away. Otherwise, the application will start to index the contents and shortly, samples will begin to appear. You can track the indexing progress in the upper part of the sidepanel, as well as in the status bar.

Upgrading a library

If a library was created with an older version of Sononym than the one you’re using, the library might need to be ‘upgraded’.

Upgrading is simple: press the button and wait until the upgrade process has finished. The process can be aborted and resumed, so you don’t have to worry about possible loss of data.

Removing libraries

To remove a library, choose “Remove” from it’s context-menu (the library itself is located in the list of libraries). The following prompt will appear:

  • Remove - choose this option to remove the library from the list of currently active libraries in Sononym, but leave the collected data untouched.
  • Delete - choose this to remove the library from Sononym and delete all collected data.

Common Questions

Q: Where is the data kept?

The library is stored as a SQLite database which sit alongside your samples. This means that the collected information is retained even if you should decide to move the folder to a different location.

You can easily spot the file, named sononym.db. A few additional files (e.g. sononym.db-wal or sononym.db-shm) might also be present, depending on whether the database is currently opened, or was left open when the program quit.

Q: Can any folder become a library?

Yes, with one condition: the software requires write-access to that folder, as the collected data are stored in the folder itself. We figured that any folder on a computer which has been write-protected usually is so for a good reason - for example, to ensure that the operating system is working properly.

Q: Can I turn a folder into a library, and later on, add subfolders to it?

Yes, although changes to the file structure are not automatically detected, you can manually ask Sononym to re-index the content. Simply right-click your library and choose Refresh (Reindex). Doing this will only analyze newly arrived and/or changed files.

Q: I’ve removed my library from Sononym, how do I re-attach it?

As long as you know where the folder is located and it contains a sononym.db file, you’re good to go.
In order to open the library, you have several options:
1. “Open” a library by choosing “Add” from the Location sidepanel.
2. Choose File > Create Library from the application menu.
3. Drag the folder on top of the application window.

Q: I’ve got a library somewhere, but I’ve forgotten where. Can Sononym help me to find it?

Yes - switch to the Explore tab and choose a folder which is approximately the location where you think your library was located. The path will be scanned - this might take a while - but once it’s done, your library should be featured in the library pop-out menu

Next Chapter: Locations: Explore