Application icon

Remove Items from Database

This statement is used to remove items from a specified Album or Track database or all open databases.

If a path is not specified, the current items will be removed from all open databases. When running stepwise, the current items are all selected files. When running grouped, the current items are a single track.

The path may contain any of the escape sequences described in Escape Sequences. At runtime, the path to a database must be absolute (/) or relative to the home folder (~/).

Album and Track databases associate entries with open files by either a folder path or file path. When tracks are moved and possibly when renamed, these paths are invalidated. In order to solve the problem you can use this statement to remove the database items associated with the current selected files before you move or rename files. After the move or rename statement you can use an Update Database statement to repopulate the moved files. Note that most of these issues can be avoided by using Yate Album and Track database IDs.

You cannot use this functionality to remove individual tracks from an Album Database. Removing any track in an album in an Album database will remove the entire album row.

If a specified database is not open this statement will be ignored.

You can optionally save a database after updating via the Save after removing option.

This statement ignores tha lock status of a database.