Back to Matcha Guide

How to play.

Matcha is meant to be picked up, not studied. Here is the whole thing in a few minutes — a pack, some chords, a loop, a video. No theory needed.

01First loop

Your first loop 前奏

The short path from opening the app to something you can share:

  1. Choose a pack — a mood to play in. Tokyo Rain is an easy place to start.
  2. Tap the big chord buttons. The keyboard picks the root; the buttons pick the colour.
  3. Press play. Drums and bass come in, and your four chords loop.
  4. Tap the red circle to catch four bars, then save it or turn it into a video.

That is the entire loop. Everything below is just the same four moves, in more detail.

02Packs

Pick a mood 気分

A pack is a complete kit — synth, bass, drums, swing, tempo, chord palette and colour, chosen to sit together. There are eight: Tokyo Rain, Study Session, Sunset Drive, Midnight Jazz, Rainy Cafe, Neon Sleep, Saturday Cartoon and Late Bus.

To switch, tap PACK in the row above the transport and choose another. The whole instrument follows — you can change it whenever, and it never loses your place.

The pack picker — eight mood packs as coloured tiles
Eight packs, eight moods
03Chords

Play by feel 和音

Every chord is three small choices working together:

  • The keyboard sets the root. Press A, and you are playing an A chord.
  • The top row sets the typedim min maj sus.
  • The bottom row adds a colour6 m7 M7 9.

So A with min and m7 gives you Am7. Change any of the three and the chord updates as it plays. Voice-leading is built in, so moving from one chord to the next stays smooth on its own.

The slider above the buttons is the voicing — drag it to open the chord up or draw it in tighter.

The chord grid — type on the top row, colour on the bottom, showing Am7
Type + colour = the chord
A note

You do not need to read music. If a change sounds good, it is good — that is the whole idea.

04Keyboard

The keyboard leads 鍵盤

One octave, C to B. As a chord sounds, its notes light up, so you can always see what you are playing.

The keyboard also sets the register: press low for a warm, rounded voicing; press high for a brighter one. It is a feel control as much as a way to choose the root — the same chord can sit deep or float, depending on where you touch.

05Sound

Shape the tone 音色

Five tabs sit just above the transport. Tap any one to open its controls:

  • Sound — the lead voice: Rhodes, Pad, Bell or Organ. An experimental sampler can be switched on in Settings.
  • Bass — Root, Walking, Octave, 5th, 3rd, Arp, or Silent when you want none.
  • Drum — Boom Bap, Jazz, Lofi or Dilla, with swing and level to taste.
  • FX — reverb and chorus to set the room, and tone to soften the top end.

Start from a pack you like and nudge one thing at a time. Small moves go a long way here.

06Record

Catch four bars 録音

  1. Press play. The drums and bass join, and your four chords begin to loop.
  2. Play along — change chords, drag the voicing, find something you like.
  3. Tap the red circle. Matcha records your next four bars as they play.
  4. Tap it again to stop. The bar count and tempo sit to the right of the transport.
The playing screen with the transport bar showing PLAYING and the bar count
Play, then catch four bars
07Library

Keep your loops 保存

Save the current loop and it lands in your library with its pack, key and tempo remembered. Re-open one any time to keep playing, or to export it.

Everything stays on your device — no account, no cloud, no sign-in. To remove a loop, delete it in the library; to remove everything, delete the app.

The loop library, with a saved loop showing its pack, key and tempo
Your loops, on your device
08Share

Turn it into a video 分かち合い

From a saved loop, export a video where the ink-wash background blooms with every chord. Save it straight to Photos, or send it anywhere with the share sheet.

Matcha only asks for photo-library permission at the moment you save a video — it never looks at the photos you already have.

On the Lock Screen

While a loop plays, your jam appears as a Live Activity on the Lock Screen and in the Dynamic Island — pack, key and tempo at a glance.

A few extras

In Settings you will find an experimental sampler, MIDI out and sync to an external clock, and a switch for the animated background. There is also a way to re-run this walkthrough inside the app whenever you like.

Matcha collects no data and works entirely offline — see the Privacy Policy. If something is not clear or not working, Support is one message away.