> For the complete documentation index, see [llms.txt](https://karedi.gitbook.io/karedi/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://karedi.gitbook.io/karedi/next-level/txt-file-format/tags.md).

# Tags

Standard TXT 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="/karedi/next-level/txt-file-format/tags/bpm.md"><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="/karedi/next-level/txt-file-format/tags/gap.md"><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="/karedi/next-level/txt-file-format/tags/medleyendbeat.md">MEDLEYENDBEAT</a></td><td>Beat in which the medley ends</td><td><em>1000</em></td></tr><tr><td><a href="/karedi/next-level/txt-file-format/tags/medleystartbeat.md">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="/karedi/next-level/txt-file-format/format-version.md">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="/karedi/next-level/txt-file-format/tags/videogap.md">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
