# Tags

Tags contain various metadata related to the song. They are written at the beginning of the TXT file in format:

```
#KEY:VALUE
```

e.g.

```
#ARTIST:Freddie Mercury
#TITLE:We will rock you
...
```

## Standard tags

The bolded tags are required or it is strongly recommended to set them for every song.

<table><thead><tr><th width="209.33333333333331">Key</th><th>Description</th><th>Example value</th></tr></thead><tbody><tr><td><strong>ARTIST</strong></td><td>Artist that performs the song</td><td><em>Freddie Mercury</em></td></tr><tr><td>AUDIO*</td><td>Same as MP3 tag</td><td><em>Freddie Mercury - We will rock you.mp3</em></td></tr><tr><td>BACKGROUND</td><td>Name of the file with background to be displayed during singing</td><td><em>Freddie Mercury - We will rock you [BG].jpg</em></td></tr><tr><td><a href="/pages/vs2VMOmgwWAHUCjFwHNH"><strong>BPM</strong></a></td><td>Beats per minute</td><td><em>230.56</em></td></tr><tr><td><strong>COVER</strong></td><td>Name of the file with album/song cover</td><td><em>Freddie Mercury - We will rock you [CO].jpg</em></td></tr><tr><td>CREATOR</td><td>Nick of the person who created this TXT file</td><td><em>Nianna</em></td></tr><tr><td>DUETSINGERP1**</td><td>In duet txt files - name of the artist performing first track</td><td><em>Whitney Houston</em></td></tr><tr><td>DUETSINGERP2**</td><td>In duet txt files - name of the artist performing second track</td><td><em>Mariah Carey</em></td></tr><tr><td>ENCODING</td><td>The encoding of the TXT file (default is UTF-8)</td><td><em>CP1250</em></td></tr><tr><td>END</td><td>Moment in milliseconds in which the program should exit the song</td><td>200000</td></tr><tr><td><a href="/pages/dpTuE1txbN4475SDqxuG"><strong>GAP</strong></a></td><td>First note offset in milliseconds</td><td><em>7456</em></td></tr><tr><td>GENRE</td><td>Genre of the song</td><td><em>rock</em></td></tr><tr><td>LANGUAGE</td><td>Main language of the song </td><td><em>English</em></td></tr><tr><td><a href="/pages/lVeXM6plQQ0uRDMCLOAX">MEDLEYENDBEAT</a></td><td>Beat in which the medley ends</td><td><em>1000</em></td></tr><tr><td><a href="/pages/VnYD1QDJiupSkCpshGGn">MEDLEYSTARTBEAT</a></td><td>Beat in which the medley starts</td><td><em>500</em></td></tr><tr><td><strong>MP3*</strong></td><td>Name of the audio file</td><td><em>Freddie Mercury - We will rock you.mp3</em></td></tr><tr><td>P1**</td><td>In multiplayer txt files - name of the artist performing first track</td><td><em>Whitney Houston</em></td></tr><tr><td>P2**</td><td>In multiplayer txt files - name of the artist performing second track</td><td>M<em>ariah Carey</em></td></tr><tr><td>START</td><td>From which second should the playback of this song be started</td><td><em>4.5</em></td></tr><tr><td><strong>TITLE</strong></td><td>Title of the song</td><td><em>We will rock you</em></td></tr><tr><td><a href="/pages/AUpdoVJq7JNyAKt0ftGA">VERSION</a></td><td>Version of the TXT file format</td><td>1.1.0</td></tr><tr><td>VIDEO</td><td>Name of the video file that will be played during singing</td><td><em>Freddie Mercury - We will rock you.mp4</em></td></tr><tr><td><a href="/pages/YpcjIaZB6HS2O8cWb7xT">VIDEOGAP</a></td><td>Difference in seconds between when video and audio should be started</td><td><em>3.5</em></td></tr><tr><td>YEAR</td><td>Year in which the song was released</td><td><em>1977</em></td></tr></tbody></table>

\*MP3 tag is going to be replaced by AUDIO tag since format version 2.0.0.

\*\* DUETSINGERP1/DUETSINGERP2 are deprecated and were replaced by P1/P2 tags


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://karedi.gitbook.io/karedi/next-level/txt-file-format/tags.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
