From e8debd2e454f9a7399104b5c77e44d5dce6aa203 Mon Sep 17 00:00:00 2001 From: Max Kellermann Date: Sat, 10 Jan 2015 08:58:31 +0100 Subject: output/recorder: dynamic file name --- doc/user.xml | 44 ++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 44 insertions(+) (limited to 'doc') diff --git a/doc/user.xml b/doc/user.xml index e5b89e27d..74c169c11 100644 --- a/doc/user.xml +++ b/doc/user.xml @@ -3091,6 +3091,50 @@ buffer_size: 16384 Write to this file. + + + + format_path + P + + + + An alternative to path which + provides a format string referring to tag values. + Every time a new song starts or a new tag gets + received from a radio station, a new file is + opened. If the format does not render a file + name, nothing is recorded. + + + + A tag name enclosed in percent signs ('%') is + replaced with the tag value. Example: + ~/.mpd/recorder/%artist% - + %title%.ogg + + + + Square brackets can be used to group a substring. + If none of the tags referred in the group can be + found, the whole group is omitted. Example: + [~/.mpd/recorder/[%artist% - + ]%title%.ogg] (this omits the dash + when no artist tag exists; if title also doesn't + exist, no file is written) + + + + The operators "|" (logical "or") and "&" + (logical "and") can be used to select portions of + the format string depending on the existing tag + values. Example: + ~/.mpd/recorder/[%title|%name%].ogg + (use the "name" tag if no title exists) + + + + encoder -- cgit v1.2.3