diff --git a/docs/changelog.rst b/docs/changelog.rst index fe186bf71..a16046940 100644 --- a/docs/changelog.rst +++ b/docs/changelog.rst @@ -4,8 +4,12 @@ Changelog 1.1.1 (in development) ---------------------- -* New :doc:`/plugins/missing`: Find albums in your library that are missing - tracks. Thanks to Pedro Silva. +* New :doc:`/plugins/missing`: Find albums in your library that are **missing + tracks**. Thanks to Pedro Silva. +* Your library now keeps track of **when music was added** to it. The new + ``added`` field is a timestamp reflecting when each item and album was + imported and the new ``%time{}`` template function lets you format this + timestamp for humans. Thanks to Lucas Duailibe. * When using queries to match on quantitative fields, you can now use **numeric ranges**. For example, you can get a list of albums from the '90s by typing ``beet ls year:1990..1999`` or find high-bitrate music with diff --git a/docs/reference/pathformat.rst b/docs/reference/pathformat.rst index 2474c97d5..723819182 100644 --- a/docs/reference/pathformat.rst +++ b/docs/reference/pathformat.rst @@ -70,12 +70,12 @@ These functions are built in to beets: `unidecode module`_. * ``%aunique{identifiers,disambiguators}``: Provides a unique string to disambiguate similar albums in the database. See :ref:`aunique`, below. -* ``%format{date_time,format}``: Return the date and time in any format accepted - by the `time.strfime() method`_. Should probably be used together with the - ``itime`` field (import time). +* ``%time{date_time,format}``: Return the date and time in any format accepted + by `strfime`_. For example, to get the year some music was added to your + library, use ``%time{$added,%Y}``. .. _unidecode module: http://pypi.python.org/pypi/Unidecode -.. _time.strftime() method: http://docs.python.org/2/library/time.html#time.strftime +.. _strftime: http://docs.python.org/2/library/time.html#time.strftime Plugins can extend beets with more template functions (see :ref:`writing-plugins`). @@ -219,3 +219,8 @@ MusicBrainz and fingerprint information: * mb_releasegroupid * acoustid_fingerprint * acoustid_id + +Library metadata: + +* mtime: The modification time of the audio file. +* added: The date and time that the music was added to your library.