<?xml version="1.0" encoding="utf-8"?>
<page xmlns="http://projectmallard.org/1.0/" xmlns:its="http://www.w3.org/2005/11/its" type="topic" id="format-strings" its:version="2.0" xml:lang="uk">
<info>
	<link type="guide" xref="index"/>
	<title type="link">Format Strings ✍️</title>
	<credit type="author copyright">
		<name>Nicholas Logozzo</name>
		<years its:translate="no">2023</years>
	</credit>
	<credit type="publisher copyright">
		<name>Nicholas Logozzo</name>
		<years its:translate="no">2023</years>
	</credit>
	<license href="http://creativecommons.org/licenses/by/4.0/" its:translate="no"><p>Creative Commons Attribution 4.0 International License</p></license>
</info>

<title>Format Strings</title>
<p>This page explains the use of format strings for <code>File Name to Tag</code> and <code>Tag to File Name</code> conversions.</p>
<section>
    <title>Format</title>
    <p>Strings of any format with properties wrapped in percent signs (%).</p>
    <note>
        <title>Example</title>
        <p>Format String: <code>%artist%- %title%</code></p>
        <p>Filename: <code>Artist1 - Song1.mp3</code></p>
        <p>When running <code>File Name to Tag</code> conversion, this format string and this file name will create a tag with an artist of <code>Artist1</code> and a title of <code>Song1</code>.</p>
    </note>
</section>
<section>
    <title>Supported Properties</title>
    <list>
        <item><p><code>title</code></p></item>
        <item><p><code>artist</code></p></item>
        <item><p><code>album</code></p></item>
        <item><p><code>year</code></p></item>
        <item><p><code>track</code></p></item>
        <item><p><code>tracktotal</code></p></item>
        <item><p><code>albumartist</code></p></item>
        <item><p><code>genre</code></p></item>
        <item><p><code>comment</code></p></item>
        <item><p><code>beatsperminute (bpm)</code></p></item>
        <item><p><code>composer</code></p></item>
        <item><p><code>description</code></p></item>
        <item><p><code>discnumber</code></p></item>
        <item><p><code>disctotal</code></p></item>
        <item><p><code>publisher</code></p></item>
        <item><p><code>publishingdate</code></p></item>
    </list>
    <note>
        <p>When using conversions, custom property names can also be used.</p>
        <p>For example, a custom property who's name is <code>ENCODER</code> can be used as <code>%encoder%</code>.</p>
    </note>
</section>
<section>
    <title>Ignoring in File Name to Tag Conversion</title>
    <p>When running <code>File Name to Tag</code> conversion, an empty <code>%%</code> can be specified to ignore part of the file name when reading it.</p>
    <note>
        <title>Example</title>
        <p>Format String: <code>%%- %track%. %%</code></p>
        <p>Filename: <code>Artist1- 05. Song1.mp3</code></p>
        <p>This format string and this file name will create a tag with a track of <code>05</code> and ignore the rest of the file name.</p>
    </note>
</section>
</page>
