夜光 MML Workshop

Writing Music on a Phone or Tablet

Draw notes, move them, change their length — all with your fingers

  1. Who this page is for
  2. One finger: tap, drag, press and hold
  3. Two fingers: panning and zooming
  4. Once something is selected: the control panel
  5. Typing and screen space
  6. Install it as an app
  7. Everything else is the same as on a desktop

Who this page is for

The test is whether you are using your fingers, not how small the screen is. A tablet held sideways is wide, and it still works this way; a phone held upright works this way too. Conversely, squashing a desktop window flat does fold the layout up, but you still have a mouse in your hand, so this page is not for you — that one is narrow screens and phones.

A phone can do just as much as a desktop: draw notes, move them, change lengths, change instruments, insert and delete bars, triplets, export, share — it is all there. A long score does go faster on a desktop, but for a short piece, fixing a few notes, or adjusting something that occurred to you while you were out, a phone is entirely enough.

If you have never used this editor before, walk through the editor quick start first — that page is one continuous route from opening the site to pasting a score into the game. Its third section is written for a mouse; read it alongside this page and the rest applies either way.

One finger: tap, drag, press and hold

A single finger has three ways down, and what they mean depends on where you put it and on which mode the toolbar is in (Select only, or holding a note length — see the roll toolbar):

Select onlyHolding a note length
Empty space Tap = clear the selection and put the playback start line there
Drag = pan the view
Press and hold = open the empty-space menu
Tap = draw a note in that cell
Drag = pan the view
Press and hold = pull out a dashed box, drag to size it, it is only drawn when you let go
On a note Tap = select it (tap again to deselect)
Drag = pan the view
Press and hold = pick it up and move it; it follows your finger and is only written when you let go
The keys on the left, the bar ruler on top These respond the moment you touch them — audition that note, or set the playback line — without waiting to see whether you meant to drag

Three things worth knowing up front:

Two fingers: panning and zooming

Once two fingers are down, whichever you do first wins:

What you doWhat happens
Move both fingers togetherPan the view
Spread or pinch horizontallyChanges cell width — see more bars, or open a passage out to line things up
Spread or pinch verticallyChanges row height — see more octaves, or open the pitches out to read them

The two axes are judged separately, so spreading horizontally with your fingers sitting at an angle is recognised perfectly well — it watches what you are actually doing, not how you happen to be holding your hand.

Once something is selected: the control panel

Select a note (or a group) and a panel rises from the very bottom of the screen. It is where you adjust notes on a phone, and it is the only way in to the note menu and to Delete.

Letting go will cover 2 notes Multi Menu Deselect Delete Warning line — appears only when letting go would cover other notes Position stick push it to move the note Length stick left and right only The panel sits at the bottom of the screen; it appears when a note is selected and folds away when you deselect

While the panel is up, the MML text area below it steps aside, and comes back when you deselect. That is deliberate: at that moment there are only two things you are working between — the note on the roll and the stick under your thumb — and hiding the text area is what brings those two close together. Nothing has been lost, and nothing has been changed.

The position stick: moving a note

The round pad on the left: push it in a direction and the note goes that way — left and right for position, up and down for pitch, exactly as if you had dragged it with your finger. One touch covers both axes; you do not have to fix the pitch first and the position second.

While you push, a crosshair appears on the roll showing where you have pushed to. Push past the edge of the view and the roll follows on its own, so there is no need to let go and scroll.

With several notes selected, the position stick moves the whole group at once, keeping their relationships intact.

If you push and the note does not move, nothing is broken. Notes snap to the grid — the crosshair has moved, but it has not crossed the next grid line yet, so the note is still sitting where it was. Push a little further and it jumps across.

The harder you push the faster it goes, and not in proportion: a light push is very slow and very fine, which is what you want when you are aiming at one particular cell; pushing all the way is still a steady walk rather than a bolt across the score. This is a tool for lining things up, so if you need to move something a long way, pan there with two fingers first.

Nothing is written until you let go. Everything while you push is a preview; the edit happens the moment you release, and Undo takes it back.

The length stick: changing length

The long horizontal one at the bottom right only moves left and right: right to lengthen, left to shorten. It is a little slower than the position stick, because overshooting a length affects the next note along (lengthening one can shorten or swallow what follows), whereas overshooting a position only misplaces the note you are holding.

When something would be covered, the top line of the panel tells you how many notes letting go would cover. Push back and that line disappears.

With several notes selected the length stick dims and does nothing. A group of notes with different lengths cannot be resized together — that rule holds on a desktop too, it is not something missing from the phone. Select them one at a time to change them.

The four buttons

ButtonWhat it does
MultiLight it up and tapping a note adds it to the selection instead of replacing it; tapping an already-selected note takes it out. Press the button again to turn it off. Once you have a group you can move it, delete it, or apply anything from the menu in one go
MenuBrings up the note menu — copy, cut, make into a triplet, delete note and so on. It is the same menu as right-clicking a note on a desktop; the contents are in right-click menus (on a note). The menu opens over this button
DeselectLets the selection go. The panel folds away with it and the text area comes back
DeleteDeletes the selected notes (the whole group at once, if several). It deletes on the first press, with no second question — the red has already said everything, and Undo takes it back

The bottom row is deliberately set apart from the two above it, and Delete has the far right corner to itself: those two are leaving and destroying while the rows above are adjusting, and a finger should not slip between the two kinds.

Only one stick at a time. Moving a note while also resizing it is not a meaningful action, so while one stick is held the other ignores you.

Typing and screen space

The four display toggles

On a narrow screen the title bar gains four toggles (invisible in an ordinary desktop window):

ToggleWhat turning it off does
Show toolbarFolds away the mode, note lengths, zoom, undo, tempo and velocity buttons
Show piano rollLeaves only text, for concentrating on typing MML
Show editorLeaves only the roll, for concentrating on drawing notes
Show status barFolds away the line of status text at the bottom

Lit means currently visible. On a phone vertical space is the scarcest thing there is, and turning an area off gives its space to the rest — these four are what you will reach for most on a small screen.

When the system keyboard comes up

Touch the MML text area and the system keyboard covers half the screen. The editor makes room by itself: the back half of the toolbar, the instrument row and the status bar fold away for the moment, and the roll stays — because while you are typing, the result on the roll is exactly what you want to watch. Dismiss the keyboard and the three come back.

Those toggles stay lit while their areas are off screen, and that is deliberate. A toggle always reflects the choice you made, and the system keyboard coming and going never overrides it — so if you turned the toolbar off yourself, typing and then leaving will not helpfully put it back; and if you press a toggle while typing, that is what you get once the keyboard is dismissed.

One more thing: tapping a tab does not raise the keyboard. On a small screen, tapping another tab usually means you want to look at that track's notes, not type — so switching tabs, adding a score and renaming one all leave the cursor alone. When you do want to type, tap the text area.

Install it as an app

You can add this site to your home screen. Once installed it opens without an address bar, just like a normal app. And once installed it works offline—with no connection it still opens, still edits, and still plays sound.

Chrome on Android usually offers to install it by itself; if you do not see the prompt, look for "Install app" or "Add to Home screen" in the browser menu. On desktop Chrome and Edge an install button appears at the right-hand end of the address bar.

iPhone and iPad give you no prompt, so you do it yourself: the share button in Safari's bottom bar, then scroll down to "Add to Home Screen".

Sound while offline needs the sound bank kept on the device. That file is 15 MB, but there is nothing for you to do: normally it stays behind by itself the second time you open the site, and installing checks again and fetches it if it is missing. To see where it stands right now, open the Settings drawer and look at Offline sound bank—it tells you plainly whether it is ready.

A few things differ on iPhone and iPad. When storage runs low the system may clear those 15 MB; it comes back on its own once you are online again, but until then there is no sound offline. Also, when you launch it from the home screen, signing in with Google may fail to bring you back—if that happens, open the site in Safari to sign in instead. These are iOS limitations, not a setting you got wrong.

Everything else is the same as on a desktop

The rest is all present on a phone and works the same way, just tucked inside the hamburger button at the right of the title bar: Clipboard, File (import / export / clear), Share, Settings, About. The toolbar's Tempo, Velocity, Transpose, Optimise and Merge, the instrument row, the score tabs and the status bar are all as they are on a desktop.

Those are all written up in the reference and shortcuts page. How the layout folds up on a narrow screen is in narrow screens and phones on that same page.

Still stuck? Try the editor quick start, the MML syntax guide, MIDI to MML, or the FAQ.