Documentation

How it works, step by step.

Handscore is growing into realistic hands on every family of instruments, with music lessons from the piano, the guitar and the bass to finger drumming, songwriting and song arrangement. This manual grows with it, version by version. Right now it covers what version 0.15.0 does: the pianos and the hands, finger drumming on the pad controller, the drum machine, the drum kit and its drummer, the Drum Map, the guitars and the guitarist's hands, the basses and the bassist's hands, the three views and the hand shots, generating a song, your own recordings and MIDI files, the sheets and the sheet reader, the drag and export, the editor, the classics, the transport, the lessons and their fifteen courses, listening to a real instrument or your voice, the tuner, the mixer, the envelope editor, your own instruments, the Song view and its songwriting tools, and the hit-readiness grade.

Getting started

Handscore runs inside your DAW as a CLAP, VST3 or AU instrument, or on its own as a standalone app. Put it on an instrument track.

There are no downloads before version 1.0.0, and the source code is private.

The licence agreement

The first time Handscore opens, it shows its licence agreement. Until you choose Agree, Handscore does nothing and makes no sound.

Your answer is kept on your computer and shared by every open copy of Handscore, in every DAW and in the standalone app. If you decline, the agreement stays on screen, ready for whenever you agree.

The stage

Below the top bar is the stage: the piano you chose, its 88 keys, A0 to C8, at a real piano's measurements, filling the width of the window. Every key's name is on its front — white keys in dark ink, black keys in white — and hides while the key is down, so you can always see which notes are being played.

If your computer cannot draw in 3D, the stage says so and explains how to turn it on, instead of showing nothing.

Handscore measures how fast your computer draws the stage and settles on the quality it can hold smoothly.

The pianos

Four pianos take the stage one at a time: Grand Piano, Acoustic Piano, Upright Piano and Honky-Tonk Piano, each with its own shape, finish and sound.

The Select Mode button at the top left (or P) opens your choices by category. Under Instruments, Preview plays a short phrase on a piano without switching, and Choose puts it on the stage, crossfading from the last one. Your choice is saved with your project.

Playing the keys

Click a key to hear it, or slide across the keys to play each in turn. Each key goes down on its balance rail, faster the harder it is played, and its name fades while it is down and comes back when it rises.

MIDI from your DAW plays the piano and moves its keys. The sustain pedal holds the notes you let go until you lift it.

The hands

Two realistic hands play every note on the stage, the way a pianist would: each finger chosen for the passage, the thumb passing under on a scale, wide chords reached, and a hand lifting up and over the other when the music crosses. When nothing plays they rest on the keys, ready.

Handscore works out which hand plays each note, and with which finger, before the music plays, so the hands arrive as the keys go down.

Finger drumming

Choose the pad controller in Select Mode under Instruments, or switch on Pad controller on stage in the Drums tab: a controller of sixteen pads takes the stage, and the hands play the loop's drums on it, finger by finger — the index fingers first, each hand keeping to its side — while the other parts are still heard. Every pad lights up as it is hit, in its kit piece's colour, brighter the harder the hit, and fades like a real pad's light; with Reduce motion the colours stay and the fades go. Your project keeps the choice.

Every loop has drums of its own, written with it when you press Generate. The Drums tab, after Bassline, shows its sixteen pads: click them, play them from a pad controller or a keyboard over MIDI, or switch on Keys play pads and play them from the computer keys — 1 2 3 4, Q W E R, A S D F and Z X C V, the top row first. The Default layout puts General MIDI notes 36 to 51 on the pads from the bottom-left; Performance mirrors the kick, the snare and the hats for two hands. Learn maps your own controller: hit each pad as it asks, counting from the bottom-left. Esc cancels, and Forget goes back to the common default.

The drums have a sheet of their own in standard drum notation, each piece on its line or space, the hands' notes stemmed up and the feet's down. With the pad controller on stage it stands first on the desk, and with finger numbers on, each note shows its hand and finger.

To play your own drums in, press Record in the Drums tab. After the count-in the loop plays, and each time it comes round, what you played becomes a layer it plays on with: a kick, then a snare, then the hats. Undo pass takes the last layer back, and Stop keeps the take, snapped to sixteenths if Quantise is on. Your project keeps every take with how tight it was against the beat: pick any one, or go back to the loop's own drums.

The finger-drumming course in lesson mode teaches it from Day 1, on the drum machine: the exercise's pattern is shown in its steps under the stage, the next pads glow before they are due and a wrong pad flashes red, and each take says how far ahead of or behind the beat you played. Your hits sound through the drum machine's pads, your own samples included. Accents and ghost notes are marked only on a take played on pads that feel how hard they are hit, not with the mouse or the computer keys.

The drum machine

The Drums tab is a drum machine. At the top, the switch chooses what plays the drums and the Kit menu picks one of Handscore's four electronic kits — Sub, Floor, Neon and Wire — or the style's own. On the left, One-shots lists the kit's sounds and your own: click one to hear it, and drag it onto a pad (with Alt, it becomes another layer). The sixteen pads are in the middle, Loops on the right holds the loop's own drums and the takes you played in, and Character gives the whole kit its Drive, Snap, Tone and Crush.

Choose a pad to open its sound below. A pad has up to four layers, chosen by velocity or in turn, each with its own sample, gain, pan, tune and start. The sample is drawn as a waveform with handles to trim its start and end and fade it in and out, and Reverse and Normalise change how it plays, never the file. Then the pad's tune and pitch envelope, its amp envelope, a low-, high- or band-pass filter with its own envelope, its gain and pan, a choke group (a hit silences the other pads in its group, as a closed hat cuts an open one), Mute and Solo. Every change is heard at once and is one undo step; Reset gives the pad back the kit's own sound.

Add samples… puts your own sounds in One-shots, and audio files dragged from the file browser go there too: WAV, AIFF or FLAC, up to 30 seconds long. A file that is too long, too big, silent or not audio is refused with the reason. Handscore keeps its own copy, so your project plays the sample even if the file moves, and the Export to PDF lists the samples a project uses.

The step sequencer under the pad's sound shows the loop's drums as steps, a row for each pad and sixteen steps a bar. Click a step to set or clear a hit, drag across to paint, right-drag to take hits away and drag back to put them back, and set each hit's velocity in the lane below. Swing moves the off-beat sixteenths later, from 50 to 75 %. From the keys: the arrows move, Enter sets or clears, Delete clears, and Page Up and Page Down change the velocity. The drums Generate wrote and the takes you played in land in the steps, and every edit is heard, seen and dragged at once.

The drum kit

One switch chooses what plays your drums: the drum machine or the drum kit. It is at the top of the Drums tab, on the Drums strip in the mixer and beside the drums in the sheet tray. Switching while the music plays never stops it: the next hit sounds on the other, and if the drums are on stage, the stage glides from the pad controller to the kit or back. The same hits play either way, your project keeps the choice, and an audio drag plays what you chose.

With the drums on stage and the kit chosen, a professional's kit stands there — snare, kick, two rack toms and two floor toms, hi-hat, two crashes, a ride, a splash, a china and a cowbell — with the drummer's hands holding the sticks and feet on the pedals. Every hit is struck where a drummer would strike it: the right hand crossed over to the hi-hat and the ride, rudiments and fills hand to hand, the kick under the right foot and the hi-hat under the left, heel up for an accent, and a double pedal only when one foot cannot keep up. Jazz and ballads are played with brushes, soft acoustic styles with rods. Heads give under the sticks, and cymbals swing and settle.

The kit has its own acoustic sound, heard through close, overhead and room microphones: Character's three faders mix them. With the kit playing, the drum sheet shows the sticking — R or L on each hand's note, RF or LF on each foot's — with a cross-stick and a rimshot drawn with their own note heads and a ghost note in brackets, and with the kit on stage it stands first on the desk. The pads' sounds you change meanwhile are the drum machine's, heard when you switch back.

The Drum Map

Drag a drum MIDI file from the file browser onto the Drums tab and it becomes the loop's drums, every note as it came. The Drum Map beside it lists each note the file uses, how many hits it has and what it plays. Read as picks the layout your DAW wrote it in — General MIDI, Ableton Drum Rack, FL Studio FPC, Logic Drummer, EZdrummer / Superior Drummer or Addictive Drums — and each row can be set to any kit piece, to Not on the kit, or to the 808 bassline. The drummer plays every change at once. Save as preset keeps a map of your own on this computer for the next file, and your project keeps the map it uses.

The guitars

Six guitars can take the stage: the Guitar (steel-string), the Nylon Guitar, the Electric Guitar, the Muted Guitar, and two rock guitars, the Overdriven Guitar and the Distortion Guitar. In Select Mode under Instruments, the Guitars tab lists them: Preview strums a C, an A minor, an F and a G on one before you choose it, and Choose puts it on the stage. Switching while the song plays never stops it.

A guitarist's two hands play your loop, and only the hands are drawn. The fretting hand plays from the chord shapes a guitarist learns — open chords, the E- and A-shape barres, power chords, triads and shell voicings — each chord near the last, and a line in the position where it lies best on the neck, the fingertips pressed just behind the fret wire. The picking hand strums down and up in time, picks single notes, plays fingerstyle with the thumb and fingers, or rests its palm on the strings for the Muted Guitar. On a fast line the hand slurs with hammer-ons and pull-offs where a guitarist would, and a slide carries the finger along the string, heard as one note gliding fret by fret. Each string is pressed down onto its fret where it is fretted and vibrates while its note rings, a strong stroke more than a soft one and a muted string barely at all.

The Overdriven Guitar and the Distortion Guitar play through Handscore's own amp: a tube-style preamp, a tone stack, a power amp and a speaker cabinet. The Overdriven Guitar has the crunch of classic hard rock, the Distortion Guitar the high gain of metal. Through an amp a full chord turns to mud, so both play the Chords as power chords, the Distortion Guitar's palm-muted, and a melody as the Electric Guitar plays it. They stand on a rock guitar of their own.

A guitar plays one part of your song. In Select Mode, Plays chooses the Chords, the Melody or the Counter, and Backing chooses what happens to the others: with Backing off, the parts the guitar does not play are silent and their sheets dimmed; with Backing on, they play on the Grand Piano. Your project keeps the choice.

The three views work for the guitar too. Front faces the player, Top looks down the neck as the player does, and Side shows the picking hand and the neck in profile. The music stand stands beside the player, its sheets turning to face each view.

A guitar's sheet shows the notes on the staff over six-line TAB, with a chord diagram at each change, strum arrows, slides, the slurs of the hammer-ons and pull-offs, and the fingering when finger numbers are on. The Export to PDF prints the TAB too.

Press the comma key (,) or the Settings key in the top bar, and on the Instrument page choose the fret wire of the Electric Guitar, the rock guitars or the bass guitars, each kept on its own: its Profile, Vintage, Narrow-tall, Medium-jumbo or Jumbo, and its Material, Nickel-silver or Stainless steel. It changes how the neck looks, never how it sounds.

To play a guitar yourself, switch Hands visible off in Settings. With the hands hidden, press a string at a fret to pluck that note: it is held until you let go, and its name shows on the neck. A MIDI key plays the nearest string and fret.

Two courses in lesson mode teach the guitar, from Day 1 to Day 150 each. Guitar, on the steel-string, the electric and the muted guitar, teaches shapes and TAB first: open chords and strumming, riffs with alternate picking, palm muting, power chords, barre chords, legato and the pentatonic scales, fingerpicking, and reading the treble clef. Classical Guitar, on the Nylon Guitar, reads from the staff with the TAB underneath: rest strokes, the bass strings and the thumb, keys and sharps, arpeggios, chords, free strokes, slurs and studies. Switch Listen on, and the lessons hear your own guitar.

In a guitar lesson, each coming note shows as a coloured dot on its string and fret, its finger's number inside, fading in before it sounds and lit on the beat. When the lesson waits for you, the dots show the notes it is waiting for, and before you play they show the whole shape of the exercise. The Dots … ms ahead setting beside the tempo sets how early they appear.

The basses

Three basses can take the stage: the Pluck Bass and the Slap Bass, two electric bass guitars, and the Upright Bass, a double bass played pizzicato. In Select Mode under Instruments, the Basses tab lists them: Preview plays a short bassline on one before you choose it, and Choose puts it on the stage. A bass plays the Bass part of your song, and Backing chooses what happens to the others: silent and dimmed, or played on the Grand Piano.

A bassist's two hands play the bassline, and only the hands are drawn. Low on the neck the fretting hand plays with the index, middle and little fingers, a fret apart, and higher up one finger a fret, moving position on a guide finger as bassists are taught; the Upright Bass keeps the index, middle and little fingers everywhere, the fingertip stopping the string on its fretless fingerboard at the note's own place. The plucking hand walks two fingers in turn, rakes one finger across to the next string, plays ghost notes, and on the Slap Bass slaps the low strings with the thumb and pops the high ones with a finger. On the Upright Bass it plucks with the side of the finger.

A generated 808 bassline's slides are played as a bassist would play them: the note is plucked once and the finger slides along the string to its target, heard gliding fret by fret. Dragged into your DAW or exported, the bass part writes each slide as a pair of overlapping notes, which a sampler plays as a glide.

The Pluck Bass and the Slap Bass play on four strings or five. Press the comma key (,) or the Settings key in the top bar, and on the Instrument page choose Strings, 4 or 5. Five strings add a low B, so a low 808 line plays at its own pitch; on four strings a phrase that reaches below the low E is played an octave higher, the whole phrase together. Either way, the bass part you drag or export is the bassline as it was generated.

A bass's sheet shows the notes on the bass clef over four-line TAB, five lines on five strings, with ghost notes marked x, the slides, and T and P under the TAB for the slap and the pop. The three views, the music stand and playing by hand work as they do for the guitars: with the hands hidden, press a string at a fret to pluck that note.

The Bass course in lesson mode teaches the bass from Day 1 to Day 180. On the Pluck Bass it begins with the open strings and roots on the beat, then fifths and octaves locked to the kick drum, the notes up the neck, scales and arpeggios, grooves from country and the waltz to bossa nova, gospel and the blues, and walking lines; from Day 151, slap and pop on the Slap Bass. Dots on the neck show where your fingers go next, as in a guitar lesson, and with Listen on the lessons hear your own bass.

The views

Watch the stage from the front, from overhead or from the side. Turn the view knob in the stage's top-right corner, or press V for the next view and Shift+V for the one before. The camera glides from one view to the next while the music plays on, and every key, hand and lit note stays exactly in time. Your project remembers the view.

Front is the player's view, the keyboard filling the window. Top looks straight down on the keys and the hands: a grand closes its lid for it, and the sheets lie flat on the lid, side by side, so you can read them; an upright's lie on its top lid. Side looks along the keyboard from the treble end, at the height of the keys, to show the shape of the hands — how each finger curves and how far each key goes down — with the sheets turned on the desk toward you. In Side, the From the left switch under the view knob looks from the bass end instead. Click a sheet, or press 1 to 6, to read it up close in any view.

After Side, the knob turns on to each instrument's hand shots: a piano's Left hand and Right hand, a guitar's or a bass's Fretting hand and Picking hand, the pad controller's Hands, and the drum kit's Hands and Feet. The camera comes in close on the hand and follows it along the keys or the neck as it plays, so you can see where each finger goes.

Generating a song

The panel on the left (its tab on the window's edge shows and hides it) searches 73 genres, 1,507 artists and 833 producers. Choose one and press Generate, or G: four parts — chords, melody, counter-melody and bassline — are written in that style, 4 or 8 bars long, and the hands play them on the piano.

The chips beside Generate set the key, the scale (41 of them), the mood, the tempo (20 to 999 BPM; drag up or down on the number), the complexity and 4 or 8 bars, and each shows what the song was made in. In a DAW, Follow DAW writes at your project's tempo, and while it is on the tempo chip stays at that tempo: switch it off to set your own. The standalone has no Follow DAW. Playable voices the parts for two hands; Raw keeps them exactly as written.

Your own audio and MIDI

Drag a recording — WAV, AIFF, FLAC, MP3, M4A, MP4 or OGG — or a MIDI file from your desktop or any folder onto Handscore's window, or press Open… in the top bar and choose one. While a file is over the window the stage says it will take it; then a bar shows how far the reading has got, with Cancel. Its parts come on stage as the loop, in the file's own tempo and key, the notes as they were played. A file on a network share is refused, and a file that is not music says so and leaves the stage as it was.

Only the parts the file really holds come on stage — usually its melody and chords, sometimes a bass or a counter-melody — each with its sheet, its strip and its hands, the sheets laid out for however many there are. A file with no melody, chords or bass in it says so; a file longer than 32 bars is cut to its first 32, and says so; a sung line is left alone, and you are told. Where the music asks for more than two hands can play, the key goes down with no finger on it, and the tray counts the notes out of reach.

After a recording comes on stage, the Audio ↔ MIDI slider on the sheet tray plays the recording itself under its parts, in time: all the way left the recording alone, all the way right the parts alone, and any blend between. Your project keeps the blend, and Handscore keeps its own copy of the recording on your computer, so the project plays it again even if the file has moved. The recording plays only at its own tempo: change the tempo and it falls silent.

An imported song is checked like any other: if its melody, counter-melody or bass matches a classic or a well-known tune, it plays in Handscore and only its chords leave. Drag an imported part into your DAW and it is named for its file.

The sheets

Each part is printed as a page of sheet music on the piano's music desk, with its title and page number, and a full score of all the parts stands beside them. Every note head lights as it sounds under a moving playhead, and a long part turns its pages as it plays. Click a sheet, or press 1 to 6, to read it up close.

Up close, the sheet opens flat across the whole window, engraved again at that size so every note head is sharp. It lights the notes as they sound, and the page moves on as the song goes down it; the full score is drawn narrower so its whole line fits. Press Esc, the same number again, or the page's × to go back to the stage. Each sheet's name on the tray brings it up close too.

The sheet tray

Under the stage, the tray holds each part with Solo, Mute, Lock and a new take. A locked part stays when you generate again. Take, Dream 1–3 and Re-Dream offer three new versions of a part beside the one you have: pick one and keep it.

The drums have the same keys, on their chip and on the Drums tab: Re-roll writes new drums in the song's style, every other part kept — and on a song whose 808 plays its bassline, the bassline comes new with its kick; Re-Dream offers three variations beside the take; Lock keeps them when you generate again. A song with no drums — a classic, an imported file, a song built by hand — has Add drums on the Drums tab, in its own style or the style picked in the left panel.

Into your DAW

Drag a part from its sheet, or the whole song with Drag all, straight into your DAW as MIDI. Export saves the MIDI of a part or the whole song to a file you name, with every note's velocity, each part's level and pan, the tempo and the time signature.

Export to PDF writes the sheets with a cover page: the title, tempo, key and scale, length, bars, the notes in total, per part and per page, and the instruments. Add credits — writers, vocalists, producers, the samples you used and where they came from, the record label — with names suggested as you type.

Editing the notes

Stage, Melody, Chords, Counter and Bassline run along the top. A part's tab opens its own piano roll, with a mute dot, Solo and a × that clears the part. Select, move, lengthen, delete, copy, paste and clone notes; right-click and drag to take notes away and bring them back. Each part has its own gain and pan.

Record from a MIDI keyboard into the roll after a count-in of one or two bars. Fold a roll to the song's scale, or to the rows that hold notes: the scale's rows are tinted and a note outside it is marked. As you draw, the next note or chord is suggested faintly; Tab keeps it, a click keeps one, and drawing elsewhere clears it.

Switch on Chords beside the transport and one key plays a chord of 3, 4 or 5 notes in the song's key, from the mouse, the computer keyboard or a MIDI keyboard.

Lyrics

Type words under the melody or the counter-melody, the syllables marked: they are printed on the sheet and lit as they are sung. A counter beside each line shows whether it fits its bar. As you type, the rest of the word is suggested (Tab takes it) and a misspelling is corrected, unless you tap the checkmark or press Shift+Tab to keep your word.

Seeds and history

Every generation shows its seed, and each part its take seed, with Copy. Paste a song's seed to make that song again, or a part's take seed to bring that take back. Back and Forward step through every generation you have made, each brought back exactly and kept across restarts; a new generation never repeats an old one.

The classics

Select Mode's Classics hold sixty-two public-domain songs to learn: nursery songs, Christmas songs and carols, folk songs, spirituals and anthems, classical themes and piano favourites. Each is arranged for two hands, the melody in the right and the chords in the left. Search by title or composer, then choose Play.

A classic is yours to learn, never to take: only its chords may leave Handscore. A generated song whose melody, counter-melody or bassline matches a well-known tune keeps that part in, and says why.

The transport

Under the stage: rewind, play or pause, stop and fast-forward, and a timeline with the song's time and a mark at every bar. Hover over the timeline to see the hands at that moment in a small preview; click or drag to go there. Hold rewind or fast-forward to move quickly. Either way you hear every note you pass. Space plays and pauses, and the arrow keys on the timeline step a bar.

The M beside the keys is the metronome. Switch it on and a click marks each beat, the first of every bar higher, while its two dots show the beat.

When a song has words, the timeline's preview shows the ones being sung at that moment.

The lessons

Select Mode → Lessons opens lesson mode inside the studio: the course map and the Day's steps on the left, the stage in the middle and the lesson's text under it. The Course key above the map picks one of fifteen courses: Piano, Reading, Rhythm, Ear training, Theory for producers, Songwriting, Lyric Writing, Rap & Flow, Song Arrangement, Mixing, Finger drumming, Drum Kit, Guitar, Classical Guitar and Bass. Each goes Day by Day through its sections, each Day a guided session, with a review Day every week; the piano course runs from Beginner (Days 1 to 90) through Elementary (91 to 400) to Intermediate (401 to 1,300), finger drumming and the drum kit from Beginner (Days 1 to 30) to Elementary (31 to 150), the two guitar courses from Day 1 to Day 150 each, and the bass course from Day 1 to Day 180. The first time, a course opens at Day 1; after that, Continue takes you straight back to the course, the Day, the step and the word where you stopped. Any Day can be opened from the map, and Exit lessons goes back to the song you left.

Each step reads, shows or listens. Watch: the hands play the exercise in the view the step names, slowly if it says so, with the finger numbers. Try: the keys to play light up and the music waits for them. In time: in tempo after a count-in, every note checked against the beat. Perform: play it through, with a summary at the end. Every take names the bar and the beat and gives the fix. A step passes after a few correct takes in a row, and a Day passes when its main exercise is played whole — in tempo, if the Day plays it in time. To practise, loop a few bars, play one hand while the stage plays the other, or change the tempo; on a tempo ladder the beat rises after three clean takes and steps back after three misses. Try also works with the mouse on the stage's keys; In time and Perform want a MIDI keyboard, or Listen switched on.

Read Aloud is off until you switch it on. Then your computer's own voice reads the lesson, each word lit as it is spoken. Space plays and pauses, ⏹ stops, and holding ⏪ or ⏩ runs back or ahead; set the pace from half speed to double and choose the voice from those installed. The clocks show the time spent in this Day and in all of them, and how many days you have practised. Your progress stays on this computer, the same in the standalone and in every DAW, and never goes into a project.

Ear training asks one question at a time: the stage plays it once, you answer on the keys, and the next one comes. In the rhythm course the click drops out in stages, from every beat to none, until you keep time on your own. Theory for producers shows any generated song as a Nashville number chart.

The creative courses have making steps: you work in the Song view, its lyric lane or flow grid, the Mixer or a notebook page, and Check says what it found against each of the step's targets, in a songwriter's or an engineer's terms. A target you broke on purpose can be marked intended, and then it passes. These lessons work on your own learning song, kept with your progress, and on lesson loops: your project's song and mix are exactly as they were when you leave lesson mode.

The drum-kit course puts the kit on stage and is played on an electronic drum kit over MIDI, on an acoustic kit with Listen switched on, or with the mouse and the computer keys: the grip and the stroke, the rudiments from single strokes to the rolls, the feet, the backbeat, ghost notes, the open hi-hat and the ride, shuffles and swing, brushes, the double pedal, fills and whole forms, and grooves from rock and funk to one-drop, bossa nova and jazz, with the click dropping out in stages. Your project's own drums and instrument are back when you leave.

Every step that plays notes has Show me beside Start: the stage plays the step for you first, close on the hand that matters — a pianist's hand, a guitarist's or bassist's fretting hand, the drummer's hands — with the transport bar as its timeline. Play and pause it, drag along it, step a bar at a time with ← and →, slow it to half or three-quarter speed, and loop the bars you choose; with Read Aloud on, the words follow along. Back to the step returns you to where you were.

Listening

The lessons can hear a real instrument or your voice. Press L or the Listen key in the top bar to open the Listen dialog: choose the input and its channel, or every channel mixed, and watch its level move as you play, with a light for clipping and the chord you strum named. If nothing is coming in, the dialog says so, and on Windows and macOS where to allow the microphone. Headphones help: the lessons hear you, not the speakers.

In a DAW, Handscore listens on its own sidechain input, Listen, and its outputs stay as they are. Nothing is heard until a track is sent to it: the dialog shows how in Ableton Live, FL Studio and Reaper.

Each course that can listen has a Listen switch on the lesson's bar, off until you turn it on. The piano, reading and theory courses then hear your notes and chords in Try, In time, Perform and the questions; the drum-kit course hears an acoustic kit's kick, snare and hi-hat and times every other piece; the rhythm and Rap & Flow drills time your claps, taps or syllables against the click; and ear training takes your answers sung, in any octave. A take heard this way is judged on the notes and the time, and says so: the touch, the pedal and how long a note was held are judged only on MIDI. While Listen is on, your MIDI keys still sound but are not judged.

In Rap & Flow's flow-grid steps, Rap it plays the song after a count-in while you rap over it; stop, and your take is timed against the syllables you placed: how many were heard, your pocket, and how early or late each one came.

The dialog's tuner shows the note and how many cents sharp or flat it is, steady as it rings, with A4 anywhere from 415 to 466 Hz and the guitar's and the bass's open strings named. Calibrate measures how long a sound takes to leave Handscore and come back in, looped back through a cable or your speakers into the microphone, or by playing along with the click, so what you play lands on time; the number is kept for that input on this computer.

Everything is heard on this computer, and only while the light with the word Listening is on. Nothing is recorded, kept or sent: Handscore keeps only your listening settings, such as the input you chose and its latency.

The mixer

Press M, or the Mixer tab, to see every part's channel strip side by side and the master. Each strip has a fader, a pan knob, a three-band EQ, Room, Echo and Heat, a compressor (off until you switch it on) and the Granular knob, with an LED meter and a clip light; the master has its own fader, Granular knob and meter. Drag a fader with Shift for fine moves, or double-click it for 0 dB. Mute and solo glide rather than cut; Ctrl+click a solo to add a part to it. Every change is heard while you move it and becomes one undo step when you let go, and the project keeps the mix.

Under the sheets, each part's audio grip drags it into your DAW as a WAV, printed through its strip at the song's tempo; the full mix drags as you hear it and names the parts it leaves out. A MIDI drag carries the part's fader and pan as controllers and says what MIDI cannot carry.

The envelope editor

On a part's tab, the Envelopes key opens the part's envelopes: volume, filter, pitch, pan and Granular, each off until you switch it on. Drag a point, or drag a segment's diamond to bend it; double-click to add a point, or a point to take it away; choose a point to type its numbers, or move it with the arrow keys. Each envelope has a depth, a time scale, velocity and key tracking, a held loop, tempo-locked times, retrigger, legato or a reset each bar, and an A/B morph. Start from a shape, copy an envelope to another part, undo and redo, or reset to none; while the song plays, a dot for each note rides the curve.

Your own instruments

Each part can play one of your own VST3 or CLAP instruments instead of Handscore's. On the part's tab or its mixer strip, its instrument key opens the picker: Handscore's own first, then every instrument a scan found in the standard plugin folders and in folders you add. Choose one and the part plays through it, its window a click away; the project keeps the plugin and its sound. Each plugin runs in a process of its own, so one that crashes stops only itself, and its latency is compensated. The hands stay on Handscore's instrument, and that part drags as MIDI. A plugin your project names that this computer does not have is replaced by Handscore's own, and the part says so. Plugin windows open on Windows in this version.

The Song view

Press A, or the Arrangement tab, to open the song's timeline under the stage: the piano, the hands and the sheets stay in view while you build, and the song plays while the tab is open, or from any tab while it is soloed. Generate song gives the style's whole song in its own form; pick one of its forms or its empty form, start a blank song, or drag a style from the left panel onto the timeline. Each row is a part, the Drums last, and each cell a clip.

Add, insert, move, rename and resize sections from their headers and menus; copy and paste clips, make a shared clip unique, fade a clip in and out from its corners, set how many bars it loops, and lock the clips a new take keeps. Re-roll a section, loop it with ↻, or double-click a clip to hear it alone. Fill a cell by sending the loop on stage to it, by dropping a .mid or an audio file on it from the file browser in the left panel, or by playing a take into it on your MIDI keyboard. A clip's ✎ opens its notes in the part editor under the timeline, where every edit changes every section that shares the clip. Every change is one step of Undo.

The sheets mark each section and turn their pages as the song plays, and Go to a section in the tray turns them all there. Drag the whole song into your DAW with its sections as markers, a section by its header's grip or a clip by its own, as MIDI or as audio. Re-Dream gives three new versions of the whole song, and Export MIDI and Export to PDF work from the Song view too.

The songwriting tools

On the Arrangement tab, the Lyric lane key lays the song's words under the melody, a syllable under each note: the stressed syllables are marked, the line ends coloured by how they rhyme, each section labelled with its rhyme scheme, and common phrases flagged. The Flow grid key lays the words out for rap: each bar's syllables on its sixteenths, the rhymes coloured, the count beside each bar and how far the words sit from the grid.

Give the song a title above its words. Versions keeps the song under a name and shows what changed since: the words line by line, the sections that came, went, moved, were renamed or resized, and the notes each part gained or lost. A section's menu switches a part off there and on again, and each section's header shows its energy. In a lesson, Portfolio PDF prints the lead sheet with its chord symbols and words, the lyric sheet and the craft report as one PDF.

The hit-readiness grade

The Hit-readiness key on the Arrangement tab opens the song's grade beside the timeline: a letter and a score out of 100 from twelve checks on its form, its parts and its words, each saying what it found and what it aims for. Type the melody's words in its box, a line to a bar from bar 1, to grade them too. It is a songwriter's checklist measured on the song's own notes, and it is printed on the PDF's cover.

Keyboard shortcuts

Press ? or the Shortcuts key in the top bar to see every shortcut.

Your project

Saving your DAW project keeps the song, its edits, its mix, its words, the piano, the view and the credits, and reopening it brings them back as they were.

Light and dark

The Dark theme switch at the top right turns the window light or dark. Handscore remembers your choice, and so do the other Freally apps on your computer.

Languages

Handscore speaks eighteen languages and starts in your system's language.

Your privacy

The plugin and the standalone app never use the network. If Handscore ever stops unexpectedly, a short report is kept on your computer and offered the next time it opens; nothing is sent unless you choose to report it.

When a lesson listens, the tuner shows or a calibration runs, what Handscore hears is analysed on your computer and never recorded, kept or sent, and a light says when it is listening.