UltraStar song

OpenPlain textLyricsKaraoke

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 typeNone registered: plain text
SpecificationThe UltraStar format, version 1.1.0 (2023), written by the games' developers together
Time precisionA beat: a quarter of the beat #BPM counts, after a gap in milliseconds
Text encodingUTF-8, as version 1.1.0 asks. Older songs use others; Subtitld detects them.
StylingNone. Golden, freestyle and rap notes score differently.
PositioningNone
SpeakersTwo singers in a duet, P1 and P2
In containersNone. 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. 1 · Headers

    What the song is, and the files that go with it: its audio, video, cover and background.

  2. 2 · Clock

    The beats a minute, and the milliseconds before beat 0.

  3. 3 · Notes

    Its kind, the beat it starts on, how many beats it lasts, its pitch, and the syllable.

  4. 4 · Breaks

    - ends a line of lyrics, at the beat after it. E ends 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

Read from the .txt
  • 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
Not kept
  • 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.

Subtitld opens UltraStar songs; it does not save them. UltraStar is not among the export dialog's formats. To keep the timing you edit, export LRC, whose word stamps hold each syllable's moment, or ASS, as karaoke. A .usfx project does not keep word timing yet.

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;
  • #BPM and #GAP, with a decimal point or a comma;
  • #RELATIVE:yes, where the beats of each line count from its start;
  • duets, P1 and P2 before each singer's lines;
  • the notes up to E, and nothing after it;
  • #TITLE and #ARTIST as the song's title and artist, and #LANGUAGE as the project's language;
  • any encoding.

Export, then Subtitles and LRC, writes the song as enhanced LRC, with its title and artist.

Trivia

SingStar

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.

15 years

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.

×4

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

Have a .txt to fix?

Open it in Subtitld with the video and retime it on the waveform.

Download Subtitld