Skip to main content

Editing

When in song edit view, you see the song source on the left side and the render on the right side. You can resize the ratio of the split view.

In mobile view, use button on the sidebar to switch between them.

Renderer​

The song renders from the information you've given it. The information is divided into two parts:

  • content - source code, all text that will be rendered
  • settings - extra information that changes the render behavior

Content​

You put all text for the song into the editor. The information is labeled by custom markup syntax. You can read about every option on syntax page.

Editor actions​

There are action buttons to help you with editing:

  • insert syntax - buttons for chord, title, subtitle, bold, italic, a new block, and an escape
  • label - gives the current block a label
  • transpose up / down - transpose all valid chords in the song
  • sharp / flat - raise or lower just the one chord under the cursor
  • undo / redo - history only from current session

The transpose and sharp/flat buttons are two different reaches: transpose moves every chord in the song at once, while sharp/flat nudge only the chord the cursor is sitting in, so they light up only when the caret is inside a chord.

The chord button has three states

Pressing it off a chord brackets the selection, or opens an empty [] for you to type into when nothing is selected. Pressing it with the caret already in a chord makes that chord inline, and pressing it once more takes the brackets off again - so three presses come back to where you started.

Valid chord

A valid chord is a root + accidental + quality, with an optional /bass. Brackets that are not a valid chord are never transposed.

The editor marks them for you with a dotted underline, and hovering explains that the text prints exactly as written. It reads every name in a bracket, so the Gmimi in [Em Am Gmimi] is underlined on its own while the two chords beside it are not. It is not a warning - [Solo] and [x2] are meant to be written that way - but it is how you spot a chord you mistyped.

note

Every action here has a keyboard shortcut, i.e. alt + c for inserting chord. There are two kinds: alt + a key acts on the text under the cursor and works while you are writing, while a bare key like n or g then s only works where you are not typing. Press ? - or g then h, which is the same key on every layout - for the list of every shortcut the screen you are on has. That list is the one to trust, so this page does not repeat it. Every button names its own key at the end of its tooltip, and Settings > About opens the same list.

danger

Let the shortcuts be rebound in settings.

Settings​

The renderer allows you to customize the output. You can change it globally or for one song only.

Song actions​

You can call more actions from the list:

  • favorite
  • download
  • export