mirror of
https://github.com/beetbox/beets.git
synced 2025-12-06 16:42:42 +01:00
60 lines
1.9 KiB
ReStructuredText
60 lines
1.9 KiB
ReStructuredText
ImportAdded Plugin
|
|
==================
|
|
|
|
The ``importadded`` plugin is useful when an existing collection is imported
|
|
and the time when albums and items were added should be preserved.
|
|
|
|
To use the ``importadded`` plugin, enable it in your configuration (see
|
|
:ref:`using-plugins`).
|
|
|
|
Usage
|
|
-----
|
|
|
|
The :abbr:`mtime (modification time)` of files that are imported into the
|
|
library are assumed to represent the time when the items were originally
|
|
added.
|
|
|
|
The ``item.added`` field is populated as follows:
|
|
|
|
* For singleton items with no album, ``item.added`` is set to the item's file
|
|
mtime before it was imported.
|
|
* For items that are part of an album, ``album.added`` and ``item.added`` are
|
|
set to the oldest mtime of the files in the album before they were imported.
|
|
The mtime of album directories is ignored.
|
|
|
|
This plugin can optionally be configured to also preserve mtimes at
|
|
import using the ``preserve_mtimes`` option.
|
|
|
|
When ``preserve_write_mtimes`` option is set, this plugin preserves
|
|
mtimes after each write to files using the ``item.added`` attribute.
|
|
|
|
File modification times are preserved as follows:
|
|
|
|
* For all items:
|
|
|
|
* ``item.mtime`` is set to the mtime of the file
|
|
from which the item is imported from.
|
|
* The mtime of the file ``item.path`` is set to ``item.mtime``.
|
|
|
|
Note that there is no ``album.mtime`` field in the database and that the mtime
|
|
of album directories on disk aren't preserved.
|
|
|
|
Configuration
|
|
-------------
|
|
|
|
To configure the plugin, make an ``importadded:`` section in your
|
|
configuration file. There are two options available:
|
|
|
|
- **preserve_mtimes**: After importing files, re-set their mtimes to their
|
|
original value.
|
|
Default: ``no``.
|
|
|
|
- **preserve_write_mtimes**: After writing files, re-set their mtimes to their
|
|
original value.
|
|
Default: ``no``.
|
|
|
|
Reimport
|
|
--------
|
|
|
|
This plugin will skip reimported singleton items and reimported albums and all
|
|
of their items.
|