1.Installing
Windows. Run the Setup file and follow the steps. The installer can make double-clicking open files in the Timeliner: .t40t projects and .v2t Variations files are ticked; .tim Audio Timeliner files are unticked, so they keep opening in Audio Timeliner unless you tick that box. A last, unticked box adds the Timeliner to the Open with list for audio files.
Mac. Open the .dmg file. In the window that appears, drag the Top40 Theory Timeliner icon onto the Applications folder, then start it from Applications or Launchpad. The app is signed and notarized by Apple, so it opens without a security warning. Afterwards you can eject the disk image. Timeliner projects get their own icon in the Finder and open with a double-click; a Mac can take until its next restart to show the new icon.
Updates
Once a day, when it starts, the Timeliner quietly checks whether a newer version is out. If there is one, a Version … is available button appears at the bottom right of the window: click it to open the download page, then install the new version over the old one (on a Mac, drag it to Applications and choose Replace). Your projects, settings and label sets stay as they are. To check yourself, use Help → Check for Updates; on a Mac it sits in the Top40 Theory Timeliner menu, next to About. Help → Check for Updates Automatically switches the daily check off. The app never downloads or installs anything by itself.
2.Getting started
A project is one song and everything you mark on it. The app opens filling the screen, and the timeline grows to fill the window whenever you resize it. Here is the whole loop, start to finish.
- Add a song. A new project shows a Drag and drop audio here sign: drop the file on it, or click the sign to browse for one. Ctrl/Cmd+Shift+A (File → Add audio track) works too. On Windows you can also right-click an audio file and open it with the Timeliner. WAV, MP3, FLAC, OGG and AIFF all work. The song loads as one bubble spanning its full length, on a layer named after the song, and a project started from a song saves into that song's own folder by default.
- Play and mark. Press Space (or the green Play button at the top left) to play, then tap B at each boundary you hear. The first tap ends the opening bubble and starts the next; keep tapping through the song.
- Name what you marked. New bubbles start blank. Double-click a bubble to name it, press F2 or Ctrl/Cmd+R, or select it and click a label in the Labels panel.
- Save. Ctrl/Cmd+S. The title bar shows a * whenever there is unsaved work, and the app asks before you close with changes.
3.The workspace
The timeline sits in the middle, with the top bar above it and four panels around it: Layers, Bubble, Labels and Shortcuts. The View menu switches each panel on or off.
The top bar
From left to right: the Play button (a green triangle; while the song plays it becomes a dark square that stops it), the Hearing: drop-down for the track you are listening to (§4), the Project notes button (§17), the song overview, and the time.
The song overview is a thin waveform of the whole song, with the playhead on it and a box around the part the timeline is showing. Click anywhere on it to jump there. Drag the box to scroll the timeline, or drag the box's left or right edge to zoom: a narrower box is a closer look. Double-click the overview to see the whole song again.
Zooming and scrolling
Besides the overview, + and - zoom in and out around the playhead, so it stays where it is (the = key works for zooming in too, no Shift needed). Ctrl/Cmd with the mouse wheel or a trackpad scroll zooms around the pointer, and Ctrl/Cmd+0 fits the whole song (or the current excerpt) to the window.
Panels along the bottom or at the sides
The panels start out along the bottom of the window, side by side, with the timeline standing right on top of them: its top layer highest, each new layer pushing the rest upward. The top of the screen stays clear, which is handy when a face cam covers that corner while you record or teach. View → Panels → Sides switches to the classic layout, with Labels and Shortcuts on the left and Layers and Bubble on the right; Bottom switches back. The app remembers your choice.
Along the bottom, drag the line between the timeline and the panels to make the panels taller or shorter. Give them enough height and each panel switches to its tall shape, the one it has at the side of the window, leaving more width for the others. The app remembers the height you leave them at. On a laptop the panels start out taller, since a new project's timeline needs little room.
Folding and popping out
Click any panel's title bar to fold it away, and again to open it. Beside the timeline a panel folds to a flat bar; along the bottom it folds to a thin upright strip and hands its width to the panels beside it. The app remembers which panels you leave folded. The small button at the right end of the Layers, Bubble and Labels title bars pops that panel out as a window of its own, which you can drag anywhere (onto a second screen, say); the same button puts it back.
The app remembers how you arrange the panels: which ones are popped out, where and how big, which ones you've docked somewhere else, and whether the Shortcuts panel is on. Bottom and Sides each keep an arrangement of their own, so switching between them brings each one back as you left it. View → Panels → Reset Arrangement puts the panels back in their standard places, and popped-out ones come back in. A panel left on a screen that's no longer connected, or bigger than the screen you're on now, comes back onto the screen.
Compact panels
View → Compact Panels trims the panels for a laptop screen. The Layers panel narrows to the width of your layer names, its buttons become symbols (+ add, − remove, ✎ rename, ⧉ duplicate, ↑ ↓ move), and the layer's settings open in a small pop-up from the gear button (⚙). Hover over any button to see what it does. On a laptop-sized screen, compact panels are on to begin with and the Shortcuts panel starts folded; once you choose in the View menu, the app keeps to your choice.
The Shortcuts panel
A cheat sheet of the most-used keys. It reads your actual shortcuts, so it shows your own keys if you change them (§18), and Cmd on a Mac. Along the bottom it shows two columns when there is room, or one column that scrolls when there is less; on a screen too narrow even for that, it folds itself to its strip. Click the strip and it opens, and stays open.
Dark mode & playhead color
View → Dark mode turns the timeline area dark, which is easier on the eyes in a dim room. Exports always come out on the light palette, so your Canva work is unchanged. The playhead is navy with a white edge so it reads on any bubble color; View → Playhead color… picks another, and light and dark mode each remember their own.
4.Playback & two tracks
Space stops playback if the song is playing. When it's stopped, Space plays from the start of the selected bubble; with nothing selected, it goes back to where you last started playing, so you can hear the same passage again and again. If you've moved the playhead yourself since then, it plays from there instead. Shift+Space always plays and pauses from wherever the playhead is. The Play button in the top bar does the same as Space.
Moving the playhead. Click an empty spot on the timeline, click or drag along the ruler, or grab the playhead line itself (away from any bubble) and drag it. Clicking the song overview in the top bar works too. Clicking a bubble while the song is playing jumps straight to its start — the fastest way to compare two phrases back to back.
Loading a vocal and an instrumental
Add a second file the same way you added the first, or drop it onto the window and choose Add to this project as a track. The Hearing: dropdown in the top bar shows which track you are listening to, and T flips between them without the playhead skipping a beat — useful for hearing exactly where the vocal sits against the track. If two files were recorded at different sample rates, the app matches them automatically. File → Remove current audio track takes one out again.
5.Working with bubbles
Create and split. B splits the bubble under the playhead on the active layer: the lowest one you can see there, whatever its level. Pressing it inside an earlier bubble splits that one, so you can always go back and add a boundary you missed. In a gap, where no bubble is under the playhead, it starts a new bubble on the lowest level showing, running up to the next one. Levels you've hidden (§6) are never changed. While the song plays, B can take off a measured amount for how late you tend to press: see Tap timing (§10).
Adjust timing. Hover near a bubble's left or right edge until the cursor changes, then drag. Every bubble on the layer that starts or ends at that edge moves with it, on every level, so the boundary stays seamless and a section's edge carries the phrases and beats inside it along (hidden ones too, so nothing is left behind out of sight). Hold Ctrl/Cmd while you drag to move this level only, the bubble and its neighbor on the row, or Alt/Option to move this bubble's edge alone, opening a gap or an overlap. Drag the middle of a bubble to slide the whole thing in time. Dropped onto other bubbles on its row, it replaces the ones whose middle it covers, so it can never hide on top of one; a bubble it only partly overlaps stays, overlapping. A bubble moved clear of its group joins the group it lands in, so pacing shades (§11) count it with its new neighbors. One that still overlaps its group, like a pickup grouped with the next section, stays in it.
Quantize. Boundaries tapped in by ear are rarely exactly on the beat. With a beat grid set (§9), select bubbles and press U (Edit → Quantize selected bubbles), and every start and end moves to the nearest beat. A selected bubble brings the bubbles grouped inside it, so clicking a section's bubble and pressing U lines up everything in it. As with a plain edge drag, every bubble on the layer that shares a moving edge moves with it, so nothing comes apart. Hidden levels and hidden bubbles aren't quantized themselves, only where they share an edge with one that moves, and locked layers (§6) and the very start and end of the song stay put. Shift+U switches the step between beats, 8ths, 16ths and bars, and the app remembers it. A bubble shorter than about half a step can't be quantized without being squashed, so it stays where it is and the message suggests a finer step. Each quantize is one undo. To line up one level without moving the rest, press Ctrl/Cmd+U (Edit → Quantize selected bubbles, this level only): only the selected bubbles and their neighbors on the same row move, so a verse can go onto its downbeat while its first phrase still starts on the pickup.
Select. Click to select one; if it sits on another layer, that layer becomes the active one, so B works there next. Ctrl/Cmd+click adds more. Shift+click selects the whole run between two bubbles — along one row, or across two levels (from a phrase to a section, say), leaving out anything already inside a selected bubble. Or drag across an empty part of the timeline to draw a selection box. It takes every bubble whose middle it covers, on every row it reaches, so a box over a whole section takes the section and everything inside it, ready to copy, move or delete; to leave a level out, keep the box off its row. Hold Ctrl/Cmd or Shift while dragging to add to what's already selected.
Move and duplicate a selection. Drag the middle of a selected bubble and the whole selection moves with it, on any layers and levels, keeping its lengths and spacing; snapping (§13) goes by the edges of the bubble you grabbed and the outer edges of the selection. To copy instead, hold Ctrl (on a Mac, Option) and drag from the middle of a bubble: copies of the selection follow the mouse, and the originals stay where they are. Where you drop them, the copies replace the bubbles on their rows whose middle they cover, the same as a moved bubble, so a Fuel/Core copied onto the next bar can't hide on top of the one already there; the status bar says how many were replaced. Groups inside the copy are kept, and a bubble copied without its group joins the group it lands in. The copy brings along the notes on the tracks its layers show, the way copy and paste does (below). The copy only starts once the mouse has moved 10 pixels, so a slightly shaky Ctrl+click still just selects, and dropping the copies back where they started cancels it. One undo takes the whole drop back. Ctrl/Cmd+D (Edit → Duplicate right after) puts a copy of the selection right where it ends, the way a DAW does: select a two-bar phrase, press it, and the next two bars get the same phrase, notes and all. The copy replaces what it lands on, as a paste does (below), and your last Ctrl/Cmd+C copy stays as it was. The copy ends up selected, so pressing Ctrl/Cmd+D again adds another.
Front and back. Where bubbles on the same row overlap, ] brings the selected ones to the front and [ sends them to the back. A lower level always stays in front of the levels enveloping it, and labels and subheadings are drawn in front of every bubble, so a section's name is never hidden behind its phrases.
Rename, color, level. Double-click, F2 or Ctrl/Cmd+R to rename (on a Mac, F2 needs the fn key, so Cmd+R is handier). C cycles through the layer's color palette (§8); Shift+C opens a full color picker. Ctrl/Cmd+↑ and Ctrl/Cmd+↓ move a bubble up or down a level.
Match colors. Select the bubbles you want to recolor, then Alt+click (on a Mac, Option+click) the bubble whose color you want. Every selected bubble takes its color, on any layer or level, and the selection stays as it is. The bubble you click can be anywhere, on a locked layer too.
One case works row by row instead, for bringing a whole row's colors onto another. Select a run of bubbles with a selection box or Shift+click, reaching past the bubble you're about to click, then Alt/Option+click a bubble right above or below the run: each selected bubble takes the color of the bubble on that row it lines up with. Select a verse's bubbles on the rhythm layer and Alt/Option+click one of the lyric lines above them, and every rhythm bubble takes the color of the lyric line it sits under. The row you click keeps its own colors, so a selection box across both layers is safe. If the whole selection sits under the bubble you click, or you picked the bubbles here and there with Ctrl/Cmd+click, they all take its one color.
A (Edit → Paste colors onto selected bubbles) brings a pattern of colors from elsewhere in the song. Copy Chorus 1's phrases (Ctrl/Cmd+C), select Chorus 2's and press A: each takes the color of the copied bubble in the same place, counting from the start of the selection. Copy a single bubble and they all take its color; copy several levels and the lowest one, the phrases rather than the section, decides. Either way only colors change, never labels or times, and it's one undo.
Build and fade. F cycles a bubble's fill between Solid, Build (swelling like a crescendo) and Fade (the reverse). Shift+F cycles how a build or fade looks: Rising fill (a block of color climbing through the bubble), Rising fill + gradient (the climbing block shaded from pale to full), or Gradient (the whole bubble shaded).
Group. Select several bubbles on one layer and press G to wrap them in a new bubble one level up — a phrase over its beats, a section over its phrases. If a selection box has taken bubbles along with the ones inside them, only the outermost are grouped, and the ones inside keep the groups they're in. Shift+G ungroups.
Move through them. → and ← step to the next and previous bubble, selecting each and moving the playhead. Enter jumps the playhead to the start of the selected bubble.
Merge, hide and delete. Backspace merges the selected bubble into the one before it on the same row (or the one after, if it's first in its group); select several side by side and they merge into one, the first keeping its label and color. Anything grouped under a merged bubble moves to the one that remains. Delete removes the selected bubbles, and so does Ctrl/Cmd+Backspace. H hides them; Shift+H brings all hidden bubbles back. Every one of these is undoable with Ctrl/Cmd+Z; redo with Ctrl/Cmd+Y or Ctrl/Cmd+Shift+Z.
Tidy up. Projects from before 2.2 can hide copies stacked exactly on matching bubbles, left there by Ctrl+drag, and bubbles left out of the group they sit in. Both make pacing shades (§11) come out wrong. When a project like that opens, a box offers to tidy it up. It removes the hidden copies, keeping the bubble you see, and puts each bubble left out of its group into the nearest bubble around it. Choose Not now and it asks again next time. Edit → Tidy up project… does the same whenever you like, and one undo puts it all back. Locked layers are left as they are.
Copy and paste
Filled in the lyrics and chords for the first chorus? Copy them to the others instead of doing them again. Select Chorus 1 on your structure layer and press Ctrl/Cmd+Shift+C (Copy what's under the selected bubble). That copies everything on the other layers that are switched on, within the chorus's span — every lyric, chord and production bubble, with its label, subheading, colors, fonts, notes and grouping. A bubble counts as inside when its middle is, so a pickup that starts just before the downbeat comes along. Then select Chorus 2 and press Ctrl/Cmd+V: the copy lands on the layers it came from, stretched or squeezed to fit Chorus 2, so every change stays lined up with the music. The pasted bubbles are left selected, ready for any changes.
Ctrl/Cmd+C copies just the selected bubbles — one chord, say; select another bubble and paste to put the copy in its place, fitted to its length. With nothing selected, or with the selection still what you copied, Ctrl/Cmd+V pastes at the playhead at the original lengths, and Ctrl/Cmd+Shift+V always does. On the layers being pasted into, a paste replaces only the levels it brings, inside that span: paste a phrase and the section it lands in stays standing, while a copied section that brings its phrases replaces the section there too. Pasted bubbles join the group they land in, and a bubble whose group the paste replaced joins the pasted one it overlaps most, so a pickup stays with its section. So after fixing Chorus 1 you can simply paste again; other layers are never touched, and the whole paste is one undo. A copy lasts until you quit and pastes into other projects too: layers are matched by name, and a missing one is created with the same settings. Locked layers (§6) are left out of both: Ctrl/Cmd+Shift+C doesn't copy from them, and a paste never changes them. In a text box (a label, a note), the same keys copy and paste text as usual.
Notes come along. A copy also takes the notes (§10) on the note tracks its layers show. With Ctrl/Cmd+Shift+C, that's every other layer that's switched on and unlocked, even one with no bubble inside the span. Notes keep their rhythm instead of stretching: a paste moves them by whole beats, from the start of the copied section to the start of the one you paste into, so they land on the same beats of the bar. A pickup comes too when its bubble does, and a quick pickup, a note starting a 16th or so before the section's edge, counts as part of the section. On each track, the stretch the notes cover is replaced, rests and all, the way bubbles are. Pasted into a shorter section, the notes past its end are left out; into a longer one, its own notes after the pasted ones stay. A track with no notes in the copied stretch doesn't come along, so it can't wipe out notes you've already added elsewhere.
In another project, notes go into the track with the same name, made if it isn't there. A layer the paste creates shows that track, and so does a matching layer that shows no notes yet. That project needs a beat grid: without one, the bubbles paste and the app says the notes didn't. A track shown on a locked layer is left alone. Edit → Paste notes too (on to begin with) switches all this off, so a paste brings only bubbles and leaves the notes as they were. A Ctrl+drag copy (above) brings notes the same way, and Paste notes too switches that off as well. A plain drag leaves notes where they are, since they belong to the music.
Typing lyrics
Instead of pasting a lyric into its bubbles phrase by phrase, select the bubble where it starts and press R (Edit → Type lyrics). A box opens beside the layer. Paste the whole lyric, and each line goes to the next bubble along that row, showing on the timeline as you type. OK keeps it as one undo step; Cancel puts every label back.
- Press Enter in the box to split a line over two bubbles, or Backspace at the start of a line to join it to the one before, until the lines match the bubbles.
- Blank lines are skipped, and so are headings in square brackets, the way lyric sites write them: [Chorus], [Verse 2].
- A line with just
.leaves that bubble's label as it is. - Select several bubbles on a row to fill just those. A selection box over a whole verse fills its phrases, not the verse. Hidden bubbles are passed over.
If the bubbles already have labels, the box opens with them, one per line, ready to correct.
The Bubble panel & notes
The Bubble panel shows the selected bubble's label, with an optional subheading in the box under it, its exact start and end times, its level and color (click the color swatch to change it), its opacity, its fill and fill style, its pacing shade (§11), and full font control: family, size, B and I buttons for bold and italic, and whether long text may slide past the bubble's edges. While the fill is Solid, the Style box reads For Build / Fade and stays grayed out, since the style only applies to builds and fades.
A subheading is a second, smaller line under the label — a technique under a section name, a lyric under a chord. It uses the label's font, two points smaller and never bold, and the two lines share the bubble's top row; big text never pokes out above the bubble. Labels exported to PDF and SVG carry it too.
The box beside the color swatch is the bubble's own opacity. While it reads Layer 82% (or Level 40%), the bubble has none of its own and follows its layer or level (§6); the arrows step from there, and stepping below 10% (or typing 0) goes back to following. The Level font button beside the level sets the font for a whole level (§6).
The Notes box takes whatever room is left and holds longer commentary; a note is saved when you click elsewhere. Bubbles with notes show a small dot, and hovering one reveals the note as a tooltip. With several bubbles selected, a change applies to all of them (times and notes, to one bubble at a time). Notes about the whole song go in Project notes (§17).
6.Layers & levels
A layer is an independent horizontal track — Songwriting on one, Production on another. The Layers panel lists them: the tick controls whether a layer is shown, and the highlight marks the active layer, the one B adds to. Click a layer's name, click one of its bubbles, or press 1–9 to make it active. The buttons add, rename and remove layers, and Duplicate copies a layer with all its bubbles and grouping, so you can rework a copy while keeping the original. To change the order, drag a layer by the handle at the right end of its row (three short lines), or use the Up and Down buttons. The list always has room for four layers, and grows to show up to ten before it scrolls.
Levels are the rows within a layer — beats at the bottom, phrases above, sections above those. Higher levels envelop the ones beneath, the way the original Timeliner nests bubbles. Grouping builds these levels for you.
Locking a layer
Lock a layer you've finished, or one that's only there for reference, and it can't be changed by accident. Click the padlock in its row of the Layers panel (just left of the handle), or the one by its name on the timeline (pointing at the name shows an open padlock), or press L to lock the active layer. A locked layer's bubbles can't be selected, dragged, duplicated, split with B, recolored, or brought back with Shift+H, and its notes (§10) can't be changed. Click one and the playhead jumps to its start instead (while the song plays, it carries on from there), so a locked Bars & beats layer is still handy for getting around; dragging from one draws a selection box, as on empty space. Selection boxes pass over it, Ctrl/Cmd+Shift+C leaves it out, and pastes leave it alone. Its settings in the Layers panel still work, so you can still show, hide or restyle it. Click the padlock again, or press L, to unlock; locking can be undone like any change. A new Bars & beats layer (§9) starts out locked.
Layer height
Any layer's rows can be made taller or shorter. In the column of layer names at the left of the timeline, point at the layer's edge (its bottom edge with the panels at the sides, its top edge with them along the bottom; a small grip marks it) until the pointer becomes an up-and-down arrow, then drag. Short rows fit more layers on a laptop screen; tall ones give long labels room. The height is saved with the project and carries into exports.
Per-layer settings
The Selected layer box beside the list holds the active layer's settings; with compact panels (§3), they open from the gear button instead.
- Timestamps — tick the box to show a start-time label under the bubbles of one level, and choose the level in Show at level underneath. Point them at your section level (Verse, Chorus…) rather than the crowded bottom row and you get one clean timestamp per section.
- Notes — which note track the layer shows under its bubbles, if any. The buttons beside it switch between notation and bars or hide the notes, leaving the contour and range bands, and the stairs button shows the melodic contour (§10).
- Bubble shape (or just Shape) — Round or Square; Q switches the active layer. Boxes suit beat- and rhythm-based breakdowns.
- Gap between bubbles (or just Gap) — up to 6 pixels of space between neighboring bubbles, so each boundary stands out (§11).
- Color for new bubbles (or just New bubbles) — the swatch shows the color new bubbles on this layer start with; click it to change it. The Palette… button beside it opens Color palettes (§8).
- Pacing shades (or just Shades) — lightens bubbles in a repeating pattern, every other one or every 3, 4, 5, 6 or 8, so how often the layer changes reads at a glance (§11). To shade only some bubbles, use the Shade box in the Bubble panel instead.
- Opacity — a slider fades the layer's fills, so a translucent Production layer can sit over its own overlaps without hiding them. The drop-down beside it chooses what the slider sets: Whole layer, or one level. A level given its own opacity shows it in the list (Level 1 (40%)) and keeps it when you change the whole layer; the ↺ button sends it back to following the layer. A single bubble can have its own too (§5). The most specific setting wins: the bubble's, then its level's, then the layer's.
- Show levels and Show labels — a column of tick boxes for each level. The first row hides or shows a level's bubbles; with the bottom levels hidden, B and the arrow keys work on the lowest level still showing. The second row hides just a level's text — handy for lyrics or quick Fuel/Core changes that only read once you zoom in. On a layer showing notes, a third row, Show ranges, adds range bands (§10). Exports follow what's on screen.
- Hidden levels keep their space (or keep room) — ticked, hiding a level leaves its row empty, so the levels above it stay exactly where they were; unticked, the rows close up. New layers start with it ticked; layers saved before version 1.4 start unticked, so they look as they always did. While Minimal view is on, hidden levels always close up and the box is grayed out (§11).
- Count for sync lines (or just Sync lines) — whether this layer's changes count toward the sync lines (§11). A Bars & beats layer starts unticked.
Level fonts
Each level can have its own font — big and bold for sections, say. Style one bubble on that level the way you want in the Bubble panel, then open Level font beside its level and choose Use this font for all of level 2. Every bubble on that level updates at once, and new ones there (from splitting or grouping) start in it. If some bubbles already have a font you set by hand, it asks whether to change those too. Changing one bubble's font later gives just that bubble its own; Go back to level 2's font undoes that, and Clear level 2's font removes the level's font.
To keep a level font for every project, choose Save as my default for level 2. New layers, the first layer of a new project, and imported .v2t and .tim files then start with it (the generated Bars & beats layer doesn't, so its numbers stay small). Use my default level fonts gives your defaults to an existing layer in one click, and Forget my default drops one. Defaults go by level number, so they suit songs built the same way — sections on level 2 in every file, say.
7.Label palettes
The Labels panel holds tabbed sets of one-click labels, each with its own color. It starts with a Structure set (Intro, Verse, Pre-chorus, Chorus, and so on) and a Technique set (FuelCore, Fuel, Core, Phrase Syncopation, Space Filler, Flow Phrase, Assonance, Spotlighting, Melodic Preview, Lyrical Preview, Rocket & Feather) that you can extend with your own terms.
Select one or more bubbles, then click a label to apply it — text and color together, or text only if you untick Apply the label's color too (Apply its color too, along the bottom). If the layer already has bubbles with that label, the new one takes their color rather than the label's own, so a layer recolored with a palette (§8) stays consistent. The labels look faded while nothing is selected, as a reminder to pick a bubble first. Hover over a label to see its full name and its key: Alt/Option+1 through Alt/Option+9 apply the first nine labels on the current tab, counting across the rows, so a listen-through becomes: B, Alt/Option+4 for Chorus, B, Alt/Option+2 for Verse.
The Edit sets menu at the corner of the tabs adds a label, starts a new set, or renames and removes sets. Along the bottom, when room is short, a long label shortens to “Phrase Sync…”; hovering shows the whole name. Right-click any label (faded or not) to rename, recolor or remove it. Your sets are saved for you and follow you across every project and session — add a label once and it is there for every song from then on.
8.Color palettes
A palette is a set of colors that go together. Open them with the Palette… button in the Layers panel, or Edit → Color palettes (O). The built-in ones come in three kinds. Sections palettes give each section or technique its own color, with neighbors that contrast: Classic, Top40 Theory, Tropical, Sunset, Pastel and Color-blind safe. Low to high palettes run from one end to the other, for layers that measure something — vocal range, energy, tension: Heat, Aurora, Ember, Sunrise, Tension, Ocean, Forest, Grape, Ink and the Top40 Theory ramp. One per layer palettes give each layer a color of its own, top to bottom, for pacing graphs: Pacing (§11).
Pick one, tick the layers it should go on (All ticks every one; a locked layer can't be ticked and keeps its colors), and choose how:
- Recolor the bubbles now, matched by Current color, a straight swap (every color in use becomes one palette color, so bubbles that share a color now still share one, and a highlight stays different from the rest), by Label (every Verse one color, every Chorus another — “Verse 2” counts as Verse — with unlabeled bubbles grouped by level in paler tints, so the sections stand out), by Level (each level its own color; a low-to-high palette runs from the bottom level up, so Low is blue and High is red in Heat), or Top down (below). Sections palettes start on Current color and low-to-high ones on Level, and the app remembers what you last chose for each kind. A one-per-layer palette needs no matching, since each layer takes its own color. The Levels tick boxes underneath choose which levels get the new colors: untick one to keep its colors, like highlights on the lowest level or sections you've colored by hand.
- Only for new bubbles from now on — the bubbles keep their colors, and the palette becomes the one C cycles through and grouping picks from on those layers.
Either way, each layer's color for new bubbles becomes the palette's first color (with a one-per-layer palette, the layer's own color), and a recolor is one undo.
Top down. This one colors the sections by label, the way Label does, then carries each section's color down through the levels under it, a third lighter each level down: a red chorus over pink phrases over paler beats. Each section reads as one block of color, and its levels still stand apart. A section is any bubble with nothing above it, so an Intro on level 1 and a Verse on level 2 both count, and the first level under each comes out equally light. The Levels tick boxes work here too: untick the top level and the level below it becomes the sections; untick the lowest to keep its colors.
Carry section colors down. To keep the section colors you have and only tint the levels under them, select the sections (click one and Ctrl/Cmd+click more, or draw a box over the whole song) and press D (Edit → Carry section colors down). A box lists the levels under them: untick any that should keep their colors, like a row of Fuel/Core highlights, and it remembers that next time. The sections keep their colors, locked layers are left alone, and it's one undo.
Your own palettes. Duplicate copies any palette for you to change, and From this layer's colors captures the colors a layer uses now — handy for a look you like in an imported file. In your own palettes, click a color to change it, use + and − to add or remove colors, rename them, and set them to Sections, Low to high or One per layer. Like the label sets, they're saved for you across projects; a project keeps its own copy of its colors, so it looks the same on a computer that doesn't have them.
9.The beat grid
Edit → Beat grid (Ctrl/Cmd+T) listens to the song and proposes a tempo and a downbeat. In the dialog you can type a BPM, halve or double it, set the beats per bar, or park the playhead on a downbeat you are sure of and press Downbeat at playhead. Detect again re-runs the analysis.
The grid on the timeline moves as you change anything in the dialog, so you can watch the downbeats line up with the waveform before you press OK; Cancel puts it back. The arrows beside the downbeat, or the mouse wheel over it, move it 5 milliseconds at a time. Line up with the audio keeps your tempo and moves the downbeat onto the beats of the track you're hearing (the instrumental works best), at most half a beat either way, so the bar you marked as bar 1 stays bar 1. The quickest way to an exact grid: type the tempo, park the playhead near a downbeat, press Downbeat at playhead, then Line up with the audio.
Once set, M shows or hides the grid lines — faint on beats, stronger on downbeats — and the ruler picks up bar numbers. Tick Create a Bars & beats layer to turn the grid into real bubbles: numbered bars, with beats nested inside. The new layer starts out locked (§6), so selection boxes, drags and pastes leave it alone, and it's left out of sync lines (§11); click its padlock when you want to change it. Once the project has one, the box reads Update the Bars & beats layer and starts ticked: when you change the grid, OK rebuilds its bars and beats on the new one, keeping their colors. (It goes by the name, so a layer you've renamed is left alone.) Notes always move with the grid by themselves. The grid is also what notes sit on (§10), and what U quantizes bubbles to (§5).
10.Notes & melody
Bubbles show where things change; notes show what happens inside them. Put a melody's rhythm on a layer, written the way a pop lead sheet would write it, then type its scale degrees to draw its contour, the shape of the melody, right over the bubbles.
Note tracks
A project can hold several note tracks: the lead vocal, a backing part, a synth hook. To start one, make a layer active, open the Notes drop-down in its settings in the Layers panel, choose New track… and give it a name. The layer now shows that track in a strip directly under its bubbles. (These are musical notes; written notes about a bubble go in the Bubble panel, §5.) Another layer can show the same track: pick its name in that layer's drop-down. None takes the strip away and leaves the notes as they are.
Rename track… and Delete track… act on the track the layer shows. Deleting a track removes its notes from every layer showing it, and Ctrl/Cmd+Z brings them back.
Adding notes by clicking
Press N (Edit → Edit notes) to start editing notes. A ♪ Notes · 16ths tag in the corner of the ruler shows it's on. Now a click on a layer showing notes, anywhere on it, bubbles included, works on its notes instead of its bubbles:
- Click empty space to add a note one step long at the nearest step. A faint ghost shows where it will land.
- Click and drag for a longer note, in whole steps.
- Click a note to select it (see Selecting notes, below).
The step starts as a 16th. Shift+N steps through 16ths, 8ths and quarters; the tag shows which, and the app remembers your choice. Notes on a track never overlap: a new one fits into the room between its neighbors. Every change can be undone. When the steps are too close together to aim at, the app says so: zoom in with +. Press N again when you're done, and clicks select bubbles again.
Tapping notes in time
For a whole phrase, tapping is faster. With note editing on, make the layer active, play the song and tap K along with the melody: press when a note starts, hold it for as long as the note lasts, and let go when it ends. Each note snaps to the current step, counted from the moment you pressed or let go of the key, even if the app was busy just then, less your tap timing (below), so the notes land where you heard them.
A tapping pass replaces the old notes it covers, from its first tap on, so a phrase that came out wrong can simply be tapped again. While you tap, the new notes show as bars; the notation catches up when the song stops, and if your taps leaned early or late, the whole pass slides onto the grid (see Tap timing, below). The pass ends when the song stops (or when you undo, open a file or switch note editing off), and Ctrl/Cmd+Z takes back the whole pass in one step. K isn't in a menu, since it needs a press and a release, but it is on the Shortcuts panel.
Your finger has to come up between taps, which would leave a sliver of rest between notes that should touch. Edit → Tapping: close short gaps (on to begin with) takes care of it: a note lasts right up to the next tap when the gap is an 8th or less, or when you held it for more than half the time until the next tap. So two quarter notes tapped a little short come out as quarters, while a quarter followed by a real quarter rest, or a short stab, keeps its rest. Switch it off to keep every rest exactly as tapped, for a staccato verse, say, where every note is short and detached.
Tap timing
Sound reaches you a little after the app plays it, and everyone presses a key a little after the beat, or before it, by an amount of their own. Edit → Tap timing… holds how much is taken off where K taps land. Until you set it, K uses your sound card's own figure for its delay. Calibrating measures you instead:
- Set a beat grid lined up with the song (§9), and put the playhead a bar or two before a stretch with a steady beat.
- Click Calibrate… beside K. The song plays: tap K on every beat, 8 times in a row. It stops by itself and fills in how far from the beat your taps landed.
- Click OK to keep it. You can also type an amount, or nudge it 5 ms at a time.
After each pass. Tapping a melody, most people press a little later (or earlier) than when they tap along to the beat. So when a tapping pass ends, the app checks whether its notes leaned early or late on the whole. If they did, the whole pass slides onto the grid, every note by the same amount, so the rhythm keeps its shape. The message says how much, and K takes that amount from then on, so your next pass lands in place as you tap. A pass of only a few notes, or one that doesn't sit on 16ths (triplets, say), is left as tapped.
B has its own amount in the same box, for bubbles split while the song plays. It starts at 0 ms, so B cuts right at the playhead until you calibrate it, tapping B on the beats the same way; with the song stopped, B always cuts at the playhead. The amounts are remembered on this computer, so calibrate again on another computer or with other headphones or speakers. If the taps were too uneven to measure, the box says so: try again, tapping steadily. Esc or Stop ends a calibration early.
The playhead. The last amount in the box holds the playhead back while the song plays, by as long as the sound takes to reach you, so the playhead crosses each hit just as you hear it. When you stop, it stops where you heard the music stop, so stopping on a hit by ear puts the playhead right on it, which helps with Downbeat at playhead (§9). It starts at your sound card's own figure. If the playhead still runs ahead of the sound or behind it, click Play beside the amount and change it until the playhead crosses the hits on the waveform as you hear them, then click OK.
Selecting notes
Tapped notes can come out a 16th early, or a note a little too long. To fix them without entering them again, turn on note editing (N) and click a note to select it; it turns blue. Ctrl/Cmd+click adds a note or takes it away, Shift+click selects the run from the last note you clicked, and Shift+drag draws a box that selects every note it touches (start it anywhere on the layer, even on a note). Esc lets go. Then:
- ← and → move the selected notes a step earlier or later (the note step, Shift+N); dragging one moves them all.
- Shift+← and Shift+→ make them a step shorter or longer, and dragging a note's right end changes its length: trim two tied 16ths down to one, or stretch a 16th to an 8th.
- U quantizes them to the note step: every start and end goes to the nearest step (one exactly halfway goes later). No note is deleted and none end up overlapping; when that can't be done, the message suggests a smaller step.
- ↑ and ↓ move their pitches a scale step, Shift+↑ and Shift+↓ an octave. Sharps and flats stay sharp or flat, and notes with no pitch yet are left alone.
- P types pitches for just these notes, and \ (backslash) breaks or joins the contour before them (both below).
- Delete or Backspace (on a Mac, delete) removes them.
Moving and lengthening stop at the next note, so notes never run into each other. While no notes are selected, the arrow keys step through bubbles as usual.
Copying notes. Ctrl/Cmd+C copies the selected notes; put the playhead where they go and press Ctrl/Cmd+V. They land on the active layer's note track, moved by whole beats so each note keeps its place in the beat, and replace the notes in that stretch. (Ctrl/Cmd+V pastes whatever you copied last, notes or bubbles.) Ctrl+drag (on a Mac, Option+drag) copies them as you drag. Ctrl/Cmd+D puts a copy right after them, a whole bar later (or as many bars as they cover), so a phrase that starts on a pickup copies onto the next bar's pickup. The copies end up selected, ready to move or copy again, and each of these is one undo.
Rhythm notation or bars
To begin with, the strip shows the notes as rhythm notation: one line, stems up, barlines from the grid, and each note at its real moment, so it lines up with the bubbles and the waveform. It's written the way a pop lead sheet would write it:
- A note that crosses a barline is written as tied notes. So is one that crosses the middle of the bar (unless it starts on beat 1), and one that starts on a 16th off-beat and crosses a beat. A syncopated quarter on an 8th off-beat (8th, quarter, 8th) stays a single note.
- Lengths that have no single symbol are tied, like a quarter tied to a 16th.
- Rests fill the silences in any bar that has notes. Bars with no notes stay empty.
- 16ths are beamed within each beat, and 8ths over beats 1–2 and 3–4, never across the middle of the bar. A lone 8th or 16th gets a flag.
The first two buttons beside the Notes drop-down switch a layer between ♩ notation and ▬ bars: plain bars, each as long as its note, in a thinner strip. Zoomed out too far for the symbols to fit, notation shows as bars by itself until you zoom back in. The third, a note with a line through it, hides the notes on that layer: the strip goes and the layer gets shorter, while its contour and range bands still show, the pitch without the rhythm. Show the same track as notation on another layer, and each layer's bubbles can be colored for its own story. With note editing on, clicks on a layer hiding its notes pick bubbles as usual, and P still types pitches on it.
Typing pitches
Rhythm is the slow part; pitches are quick. Select the bubbles you want pitches for, a phrase or a whole section like Verse 1, and press P (Edit → Type pitches). A box opens beside the layer that shows the notes, covering just the notes inside the selection, and its title names the stretch. With nothing selected, it starts from the note at the playhead and runs to the end of the song. With note editing on and notes selected (above), it covers just those notes. The notes are the active layer's; if the layer you clicked shows none, P uses the project's note track, as long as there's only one (with more, click a bubble on the layer whose notes you want). Type the scale degrees, one for each note: 3 5 6 6 5 3, or 356653 without the spaces. The notes you're typing for turn blue, and the contour draws as you type. OK keeps the pitches as one undo step; Cancel puts everything back. If the notes already have pitches, the box opens with them, ready to correct. The line under the typing counts the notes you've typed for, and numbers past the end of the selection are left out.
- Each number goes to the nearest pitch with that degree, counted from the note before, so steps and small leaps need nothing more.
- For a bigger leap, add
'to go an octave above that nearest pitch, or,to go an octave below. A plain5right after a1lands on the 5 below, so1 5'leaps up a 5th. In the box, Shift+↑ and Shift+↓ add the marks to the number at the cursor. b3and#4are flat and sharp degrees.- A
.skips a note, which keeps the pitch it had.
There's no key to set. Pitches are kept as scale degrees counted from the 1, so a melody looks the same in any key.
The melodic contour
Once a track has pitches, its layer can draw the contour: a stair-step line over the bubbles, one flat step for each note, at its pitch. It switches on by itself the first time you type pitches, and the stairs button beside the Notes drop-down switches it off and on. The whole layer shares one scale, with the song's lowest note near the bottom of the layer and its highest near the top. Every scale degree is an equal step, with sharps and flats halfway between, so a leap looks like a leap wherever it happens. A faint dashed line marks each 1, the degree numbers sit on the steps when there's room for them, and the line breaks between phrases: it runs on through each bubble on the layer's lowest level and breaks where the next one starts. A note goes with the bubble it starts in, so a pickup that starts before its phrase's bubble goes with the phrase before. Notes in no bubble break at a rest of a beat or longer. A taller layer gives the contour more room: drag its edge in the names column (§6).
Breaking or joining by hand. Where the line should go another way, at a breath inside a phrase or a pickup that belongs with the phrase after it, select the note just after the spot (note editing on) and press \ (backslash). The line breaks there if it joined, or joins if it broke; press it again to go back to what the phrases say. With several notes selected, each one flips. Exports draw the line the same way.
Range bands
How wide does each phrase or section reach? On a layer showing notes, the Layers panel adds a Show ranges row to the tick boxes for each level. Tick a level, and each of its bubbles shows a see-through band from its lowest note to its highest, on the contour's scale, labeled with the interval it spans: 5th, octave, 10th. A bubble counts the notes that start inside it; a pickup that starts before it belongs to the bubble before. Tick two levels, phrases and sections say, and their labels keep apart: the lowest ticked level labels its bands at the top right, the levels above it at the top left.
Notes, the contour and range bands all come out in exports (§16); a layer hiding its notes exports without them.
Music symbols: Bravura by Steinberg Media Technologies, SIL Open Font License.
11.Pacing graphs
A pacing graph shows how often each part of a song changes, with one layer above another: the form, the lyric lines, the melody's pitches, its rhythm. Laid out together, it's easy to see where they move as one and where one of them runs faster than the rest. Here are the tools for drawing one, in the order you'd use them.
One layer for each element
Give each thing you're pacing a layer of its own, in the order you want them from top to bottom (say form, lyrics, pitch and rhythm), and mark its changes with B as usual. On a pitch or rhythm layer, the notes themselves can sit right under the bubbles (§10). A Bars & beats layer makes a handy reference underneath; it starts out locked (§6), so it stays out of the way.
The Pacing palette
Open Palette… in the Layers panel (or Edit → Color palettes), choose Pacing under One per layer, click All to tick every layer, and Apply. Each layer gets a color of its own, top to bottom: Top40 Theory blue for the first, then orange, green and pink. A locked layer is skipped and keeps its colors, so Bars & beats stays as it is. On each layer the lowest level gets the full color and the levels above it a lighter tint, so the sections and groups stand behind the bubbles doing the pacing. With more layers than colors, the colors go round again in lighter tints. The palette works best together with pacing shades.
Pacing shades
The Layers panel's Pacing shades setting lightens bubbles in a repeating pattern, so how often a layer changes reads at a glance. Choose Every other, or Every 3, 4, 5, 6 or 8: the first bubble of every group of that many keeps its full color, and the rest are drawn a lighter shade of it. Every other alternates full and light, so each change shows even where neighbors share a color; Every 4 picks out the first of each four, like the first line of each quatrain or the downbeat of each bar. The drop-down beside it sets how much lighter: Subtle keeps more of the color, while Strong goes much paler and gives the Pacing palette's colors the light shades they were chosen to pair with.
Counting starts again in each group, like beats in a bar, and works on every row of the layer; hidden bubbles don't count. Only the drawing changes, never the bubbles' own colors, so choosing Off brings them straight back.
Shades on chosen bubbles. To shade only part of a layer, one section's phrases say, select those bubbles and use the Shade box in the Bubble panel. Every other, Every 3 and the rest count straight across the selected bubbles, row by row, whatever the groups, so a verse split into two groups of three phrases comes out dark, light, dark, light, dark, light. To start again in each group, shade one group at a time. The first keeps its full color. Lighter and Full color set single bubbles by hand. These shades stay with the bubbles and win over the layer's pattern; if you split one later, select the stretch and choose again. Layer: … (it names the layer's own setting, as in Layer: Every 4) hands them back to the layer. How light they are comes from the layer's Subtle or Strong, which you can choose whenever anything on the layer is shaded. With bubbles shaded differently selected, the box reads Mixed. Exports and copies keep these shades.
Invert. I (or Invert at the bottom of the Shade box) swaps full and lighter on the selected bubbles, so a pattern can start on a light bubble instead. It works on shades from the layer's pattern too. An inverted pattern reads that way in the box, for example Every other (inverted).
Sync lines
View → Sync lines (Y) draws a dashed line down through the layers wherever all of them change at the same moment: those are the joints where the song's elements line up, and the stretches between them show where they drift apart. A change on any level that's showing counts, and changes within 50 milliseconds of each other count as one moment. The very start and end of the song don't get lines, and it takes at least two layers.
Each layer has a Count for sync lines tick box in the Layers panel; untick a layer to leave it out. A Bars & beats layer starts unticked, since it changes on every beat, and a hidden layer never counts. The app remembers whether sync lines are on.
A tighter look
View → Minimal view (V) packs the layers a hairline apart and gives room only to what shows: hidden levels close up (whatever Hidden levels keep their space says; the box is grayed out while minimal view is on), and the strip for timestamps goes when a layer shows none. It applies to every project and the app remembers it; press V again for the usual spacing.
Gap between bubbles, next to the bubble shape in the Layers panel, puts up to 6 pixels of daylight between neighboring bubbles on a layer, so each boundary stands out, especially on a square layer full of small bubbles. Only the drawing changes; the bubbles' times stay exactly as they are.
All of it carries into exports: the palette's colors, the shades, the gaps and the minimal spacing, and the sync lines too when Include sync lines is ticked (§16).
12.The waveform
W shows or hides a waveform of the track you are hearing; Shift+W moves it above or below the layers. Because it follows the Hearing: track, pressing T lets you see where the vocal enters against the instrumental's shape. Clicking the waveform moves the playhead, same as clicking the timeline.
13.Snapping
With snapping on (S toggles it), a dragged edge jumps onto nearby landmarks and shows a green guide line when it locks:
- Other bubbles' edges, on any visible layer — line a Production boundary up with a Songwriting one by dragging toward it.
- The track's transients — drum hits and note attacks — once you are zoomed in enough for them to be meaningful.
- Beats and downbeats, when a beat grid is set.
For fine work, zoom in first: + and -, or the other ways in §3.
14.Excerpts
Select some bubbles and press X to zoom the whole app — timeline, ruler, song overview and playback — down to just that span. Nothing is removed; Shift+X brings the whole song back. An excerpt view is saved with the project, so a file can reopen focused on the part you were working on.
To hand someone just an excerpt — a single section for a student, say — use Edit → Save excerpt as its own project. That writes a separate file containing only those bubbles over the same audio, and leaves what is on your screen untouched.
15.Importing timelines
File → Import Variations / Audio Timeliner file (Ctrl/Cmd+Shift+I) brings in a .v2t file from Variations or a .tim file from Audio Timeliner — either as a new project or as a new layer inside the current one. In a new project, the layer takes the song's name; a layer added to the current project is called Variations. You can also drag the file onto the window. It carries across every bubble and its nesting, the colors, the labels, any annotations (which become notes), and the round/square and timestamp settings. Boundaries land on the exact times stored in the file. If the timeline was an excerpt of a longer song, it opens as an excerpt view over the full length. An imported layer starts with your default level fonts (§6), so its sections can arrive big and bold.
The app then looks for the song: where the file says it is, next to the timeline file, and in your default audio folder. If it finds it, the audio opens too; otherwise the bubbles come in without sound and you add the song yourself.
16.Exporting for Canva
File → Export (Ctrl/Cmd+E) writes the timeline as a PDF or SVG. Only what is visible goes out, so the Layers panel doubles as your export filter. The dialog lets you set the width and choose whether to include the ruler, layer names, the waveform, and the Top40 Theory logo and credit line. Build and fade fills come out just as they look on screen, and each layer keeps the height you gave it.
For Canva, choose PDF — Canva reads it as editable text and movable shapes, where SVG arrives as a flat picture, and every label arrives as whole words you can retype. Keep Solid colors ticked (Canva handles solid fills far better than transparency); a bubble or level you've made lighter than its layer then comes out as a paler solid color, so it still stands back as it does on screen. Untick it for real transparency. And to drop a timeline into an existing design, add the PDF as a new page from the Uploads → Designs tab, then group, cut and paste it onto the page you want. A build or fade arrives as separate pieces (the pale bubble, the color block, the outline) that you can recolor one by one.
Sync lines and notes. Include sync lines (§11) starts ticked when they're showing on screen. Notes (§10) come out as shapes rather than text, so Canva shows the notation exactly without needing the music font, and a layer's timestamps move below its notes strip. Notation needs room, so the width starts out wide enough for it, and a line under the width says whether the notes will come out as notation or as bars at the width you choose. The width can be anything from 400 to 20,000 pixels; for a long song, export an excerpt to keep the notation.
Excerpts. An excerpt (§14) exports just its stretch. A bubble that runs past the excerpt's edge is cut there, with its outline stopping at the edge, as if the bubble carried on past the page.
17.Projects & saving
Ctrl/Cmd+N starts a new project, Ctrl/Cmd+O opens one, Ctrl/Cmd+S saves, and Ctrl/Cmd+Shift+S saves under a new name. File → Open recent lists the projects you've had open lately, and dragging a project file onto the window opens it too. Projects are .t40t files. The * in the title bar means unsaved changes, and the app always asks before discarding them.
File dialogs remember where you were: once a project is saved, adding audio or saving again starts in that project's own folder — so a feedback session where you open a student's song and save the timeline beside it stays in one place. File → Set default audio folder sets a home for when nothing recent applies.
A project that hasn't been saved yet suggests saving next to the file it started from: the .v2t or .tim it was imported from, or its song. File → Save new projects in changes that to the last folder you saved a project in, or to one folder you always use.
Project notes
For notes about the whole song (key, tempo, form, what stands out, ideas to try), click Project notes in the top bar, or use Edit → Project Notes. They are saved with the project, and a dot on the button (Project notes ●) shows when a project has some; hover over the button to read how they begin. Like any change, an edit to them can be undone. Notes on a single bubble go in the Bubble panel instead (§5).
crash-log.txt that records what happened; send it along when you report a problem. Help → Show Crash Log opens its folder with the file already selected, ready to attach to an email. If the app won't open at all, go straight to that folder, called Bubble Timeliner (it is hidden from normal browsing):Windows: click in File Explorer's address bar, paste
%APPDATA%\Bubble Timeliner and press Enter.Mac: in the Finder, choose Go → Go to Folder (Cmd+Shift+G), paste
~/Library/Application Support/Bubble Timeliner and press Return.18.Custom shortcuts
Every command's key can be changed. Edit → Keyboard shortcuts (Ctrl/Cmd+K) opens a list; click a box, press the keys you want, and OK. It refuses to save the same key on two commands and tells you which clash, and a reset button restores the defaults. Your choices are saved for you, load every time you open the app, and show up in the Shortcuts panel. Only the keys you change are saved; the rest follow the defaults, so a key that a new version adds still reaches you.
A few keys always work, whatever you set: 1–9 pick a layer, Alt/Option+1–9 apply a label, Ctrl/Cmd+Backspace deletes, Ctrl/Cmd+Shift+Z redoes, Ctrl/Cmd+R renames, and = zooms in.
19.Keyboard reference
Every default shortcut. All of them are remappable (§18). On a Mac, Ctrl/Cmd means Cmd and Alt/Option means Option.
| Key | Action |
|---|---|
| Space | Play / stop — from the selected bubble, else back to where you last started |
| Shift+Space | Play / pause from the playhead |
| → / ← | Next / previous bubble |
| Enter | Jump playhead to the selected bubble |
| T | Switch the track you're hearing |
| 1–9 | Make that layer the active one |
| + / - | Zoom in / out, around the playhead |
| Ctrl/Cmd+0 | Fit song (or excerpt) to the window |
| Key | Action |
|---|---|
| B | Split the bubble at the playhead |
| F2 / Ctrl/Cmd+R | Rename the selected bubble |
| C / Shift+C | Next palette color / pick a color |
| Alt/Option+click | The selected bubbles take the clicked bubble's color |
| A | Paste copied colors onto the selected bubbles |
| O / D | Color palettes / carry the selected sections' colors down |
| F / Shift+F | Next fill (solid / build / fade) / next fill style |
| I | Invert the shading of the selected bubbles |
| R | Type lyrics, one line per bubble, from the selected bubble |
| Ctrl/Cmd+↑ / Ctrl/Cmd+↓ | Move up / down a level |
| U / Shift+U | Quantize the selected bubbles to the grid / change the step (beats, 8ths, 16ths, bars) |
| Ctrl/Cmd+U | Quantize this level only |
| G / Shift+G | Group / ungroup selected bubbles |
| H / Shift+H | Hide selected / show all hidden |
| Backspace | Merge into the bubble before |
| Delete / Ctrl/Cmd+Backspace | Delete the selected bubbles |
| Ctrl/Cmd+C / Ctrl/Cmd+Shift+C | Copy the selected bubbles / everything under the selected bubble |
| Ctrl/Cmd+V / Ctrl/Cmd+Shift+V | Paste fitted into the selected bubble / at the playhead |
| Ctrl/Cmd+D | Duplicate the selection right after itself |
| ] / [ | Bring to front / send to back, where bubbles on a row overlap |
| Ctrl/Cmd+click | Add to the selection |
| Shift+click | Select a range, along a row or across two levels |
| Drag on empty space | Draw a selection box (every level it covers) |
| Drag a selected bubble | Move the whole selection |
| Ctrl+drag (Mac: Option+drag) | Duplicate the selection, from a bubble's middle |
| Drag an edge | Move that edge on every level of the layer |
| Ctrl/Cmd+drag edge | Move the edge on this level only |
| Alt/Option+drag edge | Move this bubble's edge alone, opening a gap |
| Key | Action |
|---|---|
| L | Lock / unlock the active layer |
| N | Edit notes on or off (clicks add notes and select them) |
| Shift+N | Note step: 16ths / 8ths / quarters |
| K (hold) | Tap a note while the song plays, with note editing on |
| P | Type pitches (scale degrees) for the selected bubbles, or from the playhead |
| Shift+↑ / Shift+↓ | In the pitch box: an octave higher / lower |
| Key | Action |
|---|---|
| Click / Ctrl/Cmd+click | Select a note / add one or take it away |
| Shift+click | Select the run from the last note clicked |
| Shift+drag | Select the notes in a box (start anywhere on the layer) |
| ← / → | A step earlier / later |
| Shift+← / Shift+→ | A step shorter / longer |
| ↑ / ↓ | A scale step higher / lower (with Shift: an octave) |
| \ (backslash) | Break or join the contour just before each one |
| U | Quantize to the note step |
| P | Type pitches for just these notes |
| Ctrl/Cmd+C / Ctrl/Cmd+V | Copy / paste at the playhead |
| Ctrl/Cmd+D | Duplicate a bar (or a few) later |
| Ctrl+drag (Mac: Option+drag) | Copy them as you drag |
| Delete / Backspace | Remove them |
| Esc | Let go of them |
| Key | Action |
|---|---|
| Ctrl/Cmd+B / Ctrl/Cmd+I | Bold / italic |
| Ctrl/Cmd+= / Ctrl/Cmd+- | Bigger / smaller text |
| Ctrl/Cmd+Shift+L | Let text slide past the bubble's edges |
| Alt/Option+1–9 | Apply a label from the current tab |
| Key | Action |
|---|---|
| Q | Square / round bubbles on the active layer |
| W / Shift+W | Show waveform / move it above or below |
| M | Show or hide the beat grid |
| V | Minimal view: the layers close together |
| Y | Sync lines, where all the layers change together |
| S | Snapping on or off |
| X / Shift+X | Excerpt view / show the whole song |
| Key | Action |
|---|---|
| Ctrl/Cmd+N / O / S | New / open / save project |
| Ctrl/Cmd+Shift+S | Save as |
| Ctrl/Cmd+Shift+A | Add an audio track |
| Ctrl/Cmd+E | Export as PDF / SVG |
| Ctrl/Cmd+Shift+I | Import a .v2t or .tim timeline |
| Ctrl/Cmd+T | Beat grid |
| Ctrl/Cmd+Z / Ctrl/Cmd+Y | Undo / redo (Ctrl/Cmd+Shift+Z redoes too) |
| Ctrl/Cmd+K | Keyboard shortcuts |