Foobar2000:Titleformat Playback Statistics: Difference between revisions

Latest revision as of 12:41, 30 September 2018

This page details the title formatting fields made available by the foobar2000 Playback Statistics component.

Special fields

%play_count%

Returns how many times this tracks has been played. If the track has not been played yet, the field does not exist.

%first_played%

Returns the date and time when the track was first played. If the track has not been played yet, the field does not exist.

%last_played%

Returns the date and time when the track was last played. If the track has not been played yet, the field does not exist.

%played_per_day%

Returns the average of how many times per day track has been played, based on time first played, time last played and times played (average daily playcount between %first_played% and %last_played%). If the track has not been played yet, the field does not exist.

%added%

Returns the date and time at which track has been added to Media Library. Even if the track has not been played yet, the field exists, logically.

%rating%

Returns Rating Value (can be integer from 1 to 5). If the track has not been rated yet, the field does not exist.

%rating_stars%

Returns Song's Rating Value, formatted as up to five stars, e.g. ★★★. If the track has not been rated yet, the field does not exist.

%rating_stars_fixed%

Returns Song's Rating Value, formatted as five stars, e.g. ★★★☆☆. If the track has not been rated yet, the field does not exist.

Notes

The format of the returned values for both %first_played% and %last_played% are

 YYYY-MM-DD hh:mm:ss

The different parts of the format have the following meaning:

YYYY: year (four digits)
MM: month (two digits)
DD: day of month (two digits)
hh: hour (two digits)
mm: minute (two digits)
ss: second (two digits)

@@ Line 1: / Line 1: @@
-= Playback statistics =
+{{fb2k}}
+This page details the title formatting fields made available by the foobar2000 [[Foobar2000:Components/Playback Statistics v3.x (foo playcount)|Playback Statistics]] component.
 == Special fields ==
@@ Line 17: / Line 18: @@
 === %played_per_day% ===
-Returns the average of how many times per day track has been played, from the moment it was added to media library. If the track has not been played yet, the field does not exist.
+Returns the average of how many times per day track has been played, based on time first played, time last played and times played (average daily playcount between %first_played% and %last_played%). If the track has not been played yet, the field does not exist.
 === %added% ===
-Returns the date and time at which track has been added to media library. Even if the track has not been played yet, the field exists, logically.
+Returns the date and time at which track has been added to Media Library. Even if the track has not been played yet, the field exists, logically.
 === %rating% ===
+Returns Rating Value (can be integer from 1 to 5). If the track has not been rated yet, the field does not exist.
+=== %rating_stars% ===
+Returns Song's Rating Value, formatted as up to five stars, e.g. ★★★. If the track has not been rated yet, the field does not exist.
+=== %rating_stars_fixed% ===
+Returns Song's Rating Value, formatted as five stars, e.g. ★★★☆☆. If the track has not been rated yet, the field does not exist.
+==Notes==
 The format of the returned values for both ''%first_played%'' and ''%last_played%'' are
@@ Line 40: / Line 45: @@
 * mm: minute (two digits)
 * ss: second (two digits)
-= Disclaimer =
-The official playback statistics component is only intended to be a test case for a new API in foobar2000 0.9 beta 13. A more complete version is expected to be created by third parties once the SDK for fooba2000 0.9 is publicly released.