UltraStar song
The song files of UltraStar, Vocaluxe, Performous and the other karaoke games that score how well you sing: every syllable a note, with its beat, its length and its pitch. Subtitld opens them as subtitles, a line each, with the timing of every syllable.
At a glance
| Extension | .txt |
|---|---|
| Media type | None registered: plain text |
| Specification | The UltraStar format, version 1.1.0 (2023), written by the games' developers together |
| Time precision | A beat: a quarter of the beat #BPM counts, after a gap in milliseconds |
| Text encoding | UTF-8, as version 1.1.0 asks. Older songs use others; Subtitld detects them. |
| Styling | None. Golden, freestyle and rap notes score differently. |
| Positioning | None |
| Speakers | Two singers in a duet, P1 and P2 |
| In containers | None. The .txt names the song's audio, video and pictures, which sit beside it. |
Anatomy of a file
Headers, then a note a line. A song Subtitld opens:
#TITLE:Tears of Steel #ARTIST:The Blender Foundation #MP3:Tears of Steel.mp3 #BPM:300 #GAP:1200 : 0 4 5 Hold : 6 3 7 on : 10 2 7 to * 14 6 9 the : 22 8 4 light - 34 F 40 4 0 We : 46 6 0 sing E
- 1 · Headers
What the song is, and the files that go with it: its audio, video, cover and background.
- 2 · Clock
The beats a minute, and the milliseconds before beat 0.
- 3 · Notes
Its kind, the beat it starts on, how many beats it lasts, its pitch, and the syllable.
- 4 · Breaks
-ends a line of lyrics, at the beat after it.Eends the song.
Beats into seconds
Times are beats, not seconds. A file's beat is a quarter of the beat #BPM counts: at #BPM:300, 1,200 beats a minute, 0.05 seconds each. Beat 0 is #GAP milliseconds into the song.
| Note | Beat | Seconds |
|---|---|---|
: 0 4 5 Hold |
0 to 4 | 1.20 to 1.40 |
: 22 8 4 light |
22 to 30 | 2.30 to 2.70 |
- 34 |
34 | 2.90: the line ends |
Both #BPM and #GAP may have a decimal comma: #BPM:271,5.
Notes
| Kind | What it is |
|---|---|
: |
A note, scored on its pitch |
* |
A golden note, worth twice as much |
F |
Freestyle: not scored |
R |
Rap: the words scored, not the pitch |
G |
Golden rap |
The pitch counts semitones from middle C: 0 is C4, 7 the G above it. The syllable after it carries its own spaces: Hold, then on.
UltraStar in Subtitld
- A subtitle a line of lyrics
- The moment and length of each syllable, as word timing
- From the first note to the last, or to the line's break
- The title and artist, and the language as the project's
- Both singers' lines in a duet, in order of time
- The singing game's notes: each note's kind and pitch, once the project is closed
- The other headers: audio, video, cover, BPM and gap
- Empty syllables
Subtitld has no way to save a song yet.
Subtitld keeps each syllable's moment in the subtitle's text, as ASS writes karaoke: a code before it with its length in hundredths of a second, {\k20}Hold{\k10}{\k15} on. A code with no text after it is the pause between two notes.
Opening an UltraStar file
UltraStar songs are .txt, as many other formats are. Subtitld opens a .txt as UltraStar when it has a #BPM header and notes, and reads:
- every kind of note: normal, golden, freestyle, rap and golden rap;
#BPMand#GAP, with a decimal point or a comma;#RELATIVE:yes, where the beats of each line count from its start;- duets,
P1andP2before each singer's lines; - the notes up to
E, and nothing after it; #TITLEand#ARTISTas the song's title and artist, and#LANGUAGEas the project's language;- any encoding.
Export, then Subtitles and LRC, writes the song as enhanced LRC, with its title and artist.
Trivia
UltraStar began as a free clone of Sony's SingStar, by the Polish developer Patryk Cebula, known as Corvus5. UltraStar Deluxe, Performous and Vocaluxe grew from it.
Version 1.1.0 of the format, in 2023, called itself the biggest update to UltraStar's song files in fifteen years. It made UTF-8 a must and #AUDIO the name for #MP3.
Four of the file's beats to each beat #BPM counts. When #BPM is the song's own tempo, a note can be as short as a sixteenth.
Related formats
Open it in Subtitld with the video and retime it on the waveform.