TOP40 THEORY

What's New

How the Timeliner extends the Variations Audio Timeliner that inspired it — rebuilt on a more flexible foundation for analyzing pop songs.

Version 2.3 · Windows & macOS · top40theory.com

The original Variations Audio Timeliner is a wonderful tool for mapping a recording as nested bubbles over time. This app keeps that idea at its core and rebuilds around it, with a data model flexible enough for a few things the original couldn't do. Below is what changed, grouped by what it lets you do.

Added in 2.3 UPDATE

Tapped notes fixed in place instead of entered again, colors matched in one click, and section colors that carry down through the levels.

Fixing notes

Colors

Editing and getting around

Sharing projects. A 2.3 project opens in 2.2 just as it is, except the contour: 2.2 breaks the line at rests, and saving the project there loses the breaks and joins set with \ (backslash).

Added in 2.2 UPDATE

Lyrics in one paste, pitches a section at a time, and drags that keep a diagram tidy.

Sharing projects. Nothing new is stored in a project, so a 2.2 project opens in 2.1 just as it is.

Added in 2.1 UPDATE

Tapping that lands where you mean it, and finer control over how melody and pacing show.

Sharing projects. A 2.1 project opens in 2.0, but there a layer hiding its notes shows them as bars, and shades set in the Bubble panel don't show. Saving it in 2.0 loses those shades.

Added in 2.0 UPDATE

The biggest update yet: the Timeliner now maps melody as well as form. Put a melody's rhythm and pitches on the beat grid, see its contour and range over the bubbles, and lay out pacing graphs that show how often each part of a song changes.

Notes and melody

Pacing graphs

Faster editing

Panels, exports and fixes

Sharing projects. A 2.0 project still opens in 1.4, but its notes, locks, pacing shades, gaps and sync settings don't show there, and saving it in 1.4 loses them. Ask anyone you share projects with to update.

Added in 1.4 UPDATE

A round of features for richer breakdowns — lyrics, chords, techniques and production on layers of their own:

Added in 1.3 UPDATE

A round of changes for the first public release, many of them to make the app at home on a laptop, tested on 13-inch MacBooks:

Added in 1.2 UPDATE

A round of changes shaped by teaching with the app and by testers on Windows and Mac:

Added in 1.1 UPDATE

Refinements since the first release, most of them from working with real feedback sessions:

NEW not in the original EXTENDED the original had it; this goes further

Overlapping bubbles & independent layers NEW

Bubbles may overlap freely, and you can stack any number of separate, independently named layers — Songwriting on one, Production on another — each shown or hidden on its own, and each level within a layer shown or hidden separately.

Before: a single strict hierarchy, where bubbles could sit beside or inside one another but never overlap.

Two audio tracks, switched live NEW

Load a vocal and an instrumental together and flip between them with a keypress mid-playback, the position never skipping — so you can hear, and see on the waveform, exactly where the vocal sits against the track.

Before: one audio file per timeline.

Text control & overflow NEW

Per-bubble font family, size, bold and italic, plus an option to let a long label slide past a small bubble's edges instead of being clipped — useful when the label matters more than the box.

One-click label palettes NEW

Tabbed sets of reusable labels, each with a color — a Structure set out of the box, and your own sets for technique terms. Apply one with a click or an Alt/Option + number key; they follow you across every project.

Beat grid & tempo detection NEW

The app finds the tempo and downbeat from the audio, lays a beat-and-bar grid over the timeline, numbers the bars, can generate a Bars & beats layer, and quantizes bubbles to the grid — with everything adjustable when you know better than the detector.

Notes, rhythm & melody NEW

Put a melody's rhythm on the beat grid, clicked in or tapped in time (calibrated to the way you tap), and see it written as pop lead-sheet notation right under the bubbles. Type its scale degrees to draw its contour, and each section's range, over the timeline.

Pacing graphs NEW

A palette with a color for each layer, shades that mark every 2nd, 4th or 8th change across a layer or just the bubbles you choose, sync lines where all the layers change together, and a minimal view that stacks the layers close, so how fast each part of a song moves reads at a glance.

Waveform display NEW

A waveform of whichever track you're hearing, placeable above or below the layers, so boundaries can be lined up against what the audio is actually doing.

Snapping NEW

Dragged edges snap to other bubbles' edges across every layer, to the track's transients when zoomed in, and to beats and downbeats when a grid is set — with a guide line showing each lock.

Undo & redo, everywhere NEW

Every change — a split, a drag, a recolor, a group, a deleted layer — steps back and forward without limit.

Build & fade fills NEW

Beyond solid color, a bubble can swell like a crescendo or fade like a diminuendo — as a block of color rising through it, the same block shaded from pale to full, or a gradient — and it exports to PDF and SVG exactly as it looks on screen.

Excerpts as a reversible view EXTENDED

Focus the whole app on a range of bubbles, then bring the full song back with one keypress — the rest of the timeline is never lost. You can also save an excerpt out as its own file to hand along.

Before: making an excerpt produced a new, separate timeline of that range.

Export to PDF & SVG for Canva NEW

Export the visible timeline as vector PDF or SVG — editable text and shapes you can restyle in Canva — with optional ruler, layer names, waveform, and Top40 Theory branding, on a transparent background.

Import your existing timelines NEW

Open your Variations .v2t and Audio Timeliner .tim files directly — bubbles, nesting, colors, labels, annotations and timing all carried across — as a new project or as a layer alongside newer work.

Remappable keyboard shortcuts NEW

Every command's key can be changed and is saved for you, with clash-checking and a one-click reset.

Save protection & folder memory NEW

An unsaved-changes marker and a prompt before you lose work, and file dialogs that open where you last were — so a folder of a student's songs stays a folder of that student's songs.

Square or round bubbles EXTENDED

Switch a layer between arches and boxes, as in the original — now set per layer, alongside a per-layer opacity control for translucent overlays.

Carried over from the original

The features that made Variations worth building on, kept intact: