Skip to content

Song Editor

Creating a song folder

song files

To create a new song, you start by creating a new folder insideletras/songs. This folder can be named whatever you want, on the image it's named "sample song".

Inside your song folder you must put the song in MP3 format.

Adding a background

If you want to add a background image you can either use a PNG or JPG file. This file is recommended to be 1280x720 resolution and it must be called background.

If you want to add a background video it must be a WEBM file with no sound and it must be named video.

INFO

Background image and video are completely optional. I highly recommend at least using a background image.

TIP

I recommend using Handbrake for converting videos to the WEBM format.

WARNING

Remember, naming the files "background" and "video" is important. They won't be recognized if you don't.

New song

Let's say we want to create a lyricmap for Flashback of 秋赤音.

After creating the folder and putting the song, background image and video inside. We should click/press EDIT from the Title screen.

song to edit

This is what we should see. We select it and we will go to the next screen.

Properties

song to edit

This is the first screen you will see once you enter edit mode.

  • Song name: The actual name of the song.
  • Artist: The original artist of the song.
  • Preview time: Which part of the song will play on the selection screen.
  • Map author: Name of whoever created the lyricmap.
  • Version name: This could be anything, but you should use words like: easy, hard, insane, etc.
  • Version color: Choose the most suitable color for your version name.

On the bottom left corner, you can see the name of the file you're editing. In this case it's "lyricmap.json". This is useful when you're editing different difficulties.

When you're finish click Save on the bottom right corner.

Example of how it should look like:

song information

Lyric insertion

Click on the Input and click the Insert lyrics button. You should paste the lyrics on the pop-up window.

lyric insertion

You can edit them if needed. Click the Insert button to insert the lyrics.
This is how it should look like:

inserted lyrics

If you see a line turning red, it means it contains non-typeable characters such as? ! @ , . ' - /etc. The only characters you can put in these boxes are letters from A to Z.

Subtitles

subtitle insertion

You should insert the subtitles before timing the lyrics. Since they are most likely to be in the same order and have the same amount of lines. When you create or remove lines, they will be removed in both Input and Subtitle tab.

Insert them using the Insert subtitles button just like before.

INFO

You can put any kind of character you want on these lines. But stick to punctuation and supported languages such as: English, Spanish, Japanese, Chinese and Korean. If you paste something and is not showing up, it means it's not supported.

Timing

Press the play button on the top to listen to the song. The timestamp on the right will start running. You should use the buttons Set start and Set end on each line to set up the timings. You can also use F9 and F10 keys respectively.

WARNING

Whenever you press Set start, you will advance to the line below. This means that pressing Set end will affect the line above your current line.

The -/+ buttons on the right remove the current line or inserts one new line below.

DANGER

There is no Undo button so be careful when removing lines.

After you synchronize the lyrics it should look something like this:

lyric insertion

Try to break the lines apart according to how the song goes.

Keep an eye on the CPM on the right of each line. If It's too high you can try splitting the lines differently or using the special characters.

Remember to make sure the subtitles are aligned with the lyrics.

synchronized subtitles

TIP

Duplicating the subtitles instead of splitting them just like the lyrics give a better result.

WARNING

If you don't SAVE before leaving the screen, your progress will be lost. Save before clicking on the Position button.

Relative and Absolute

lyrics timing

The last update brought the possibility of changing absolute for relative timing.

In absolute timing you have to enter the timing according to the song time stamp. In relative mode you can just add the amount of time to the last line.

The end time will add the time to the start time. While the start time will add the time to the last line's start time.

lock icon

There is a lock button on the right side of the set end button.

If the lock is closed the end time will be set automatically while you're timing the song pressing "set start" or F9.

The end time will be exactly the start time of the next line.

Position

position edition

This is the easier part. Just drag the lines horizontally with the mouse. The whole idea is to make them readable.

You can adjust their position pixel by pixel by using the LEFT/RIGHT arrows while cliking a line.

Click the Hotkeys button to display all the shortcuts you can use.

Click the gear button on the top right to change background opacity or line speed.

Play testing

On the same position screen, you can play test the song just by typing as if you were playing.

TIP

You can pause the song with SPACEBAR and go forwards/backwards 1 second using the UP/DOWN keys respectively.

Difficulties

To create a new difficulty for the same song, go to the song folder and duplicate the lyricmap.json file. Name it differently like lyricmap[insane].json. Go to the edit song selection, search for your song and select the other version.

The versions may look the same, since they are duplicates. Make sure to check the filename on the bottom of the Properties tab so you know which file are you editing.

different lyricmap

Remember to change the name version and color to make them distinct.

Fast lyrics

If you think the song is too fast, or the lines you created have too much CPM. You can try using the special characters[and].

After entering the special characters, you will only need to type what's inside the brackets.

Examples of how it works:

Input lineWhat you need to type
This is a line of lyricsThis is a line of lyrics
[This is a line of lyrics]This is a line of lyrics
[T]his [is a line of lyrics]T is a line of lyrics
[T]his [i]s [a] [l]ine [o]f [l]yricsT i a l o l

Never do this:

  • This [is a line of lyrics]

Doing this will imply that the word This cannot ever be typed.

INFO

The CPM calculation will also ignore whatever is outside the brackets [ ].

TIP

You can know your CPM speed online, just search for typing tests.