Skip to main content

Analysis Correction Tool

Getting Started​

  • In the Playlist Window, right-click a track and select Open Analysis Correction Tool.
  • The editor loads the track waveform, markers, and supporting panels. A loading spinner clears once everything is ready.
  • Changes are local until you press Save in the top bar.

Layout Overview​

  • Top Bar – Navigation, playback controls, marker tools, and the global save button.
  • Timeline Canvas – The large waveform view where markers appear and can be moved.
  • Spreadsheet Panel – Table of beats, chords, and parts for quick text edits.
  • Mixer Panel – Theme/track volume sliders with mute buttons.
  • Bottom Bar – Marker toggles, Auto Analyze reset, and zoom controls.

Top Bar Controls​

  • Back Arrow returns to the project editor.
  • Track Info shows the song title and artist metadata.
  • Transport Controls (play, pause, skip etc.) operate the timeline playback.
  • Context Actions adapt to what you select:
    • Selecting chords reveals Delete and chord editor dropdowns.
    • Selecting parts exposes a Delete button.
    • Selecting all beats shows a BPM field that updates beat spacing when changed.
  • Save writes the current beats, chords, and parts to the track analysis.

Working on the Timeline​

  • Click a marker to focus it. Use Shift or Cmd/Ctrl for multi-selection.
  • Drag selected markers to reposition them; they will respect neighboring beats when moved.
  • Double-click in the timeline to drop a new marker on the nearest beat. The marker type depends on the active toggle (Chord or Part) in the bottom bar.
  • Clicking on empty space clears the current selection.

Spreadsheet Editing​

  • Each row represents a beat with columns for time, beat number, chord, and part name.
  • Click a cell to edit text inline; updates sync instantly to the timeline.
  • Clear a chord or part cell to delete the corresponding marker.
  • Entering a new value in an empty chord or part cell creates a marker at that beat.
  • Use Cmd/Ctrl + C and Cmd/Ctrl + V to copy/paste within a column (single column at a time).
  • Right-click on spreadsheet rows for additional options Export and Import that allow CSV handling of the entire table.

Bottom Bar Tools​

  • Auto Analyze (visible when available) replaces current edits with the automatic analysis preset.
  • Marker Toggles choose which marker type you are working with. Only one can be active; double-click additions follow the active type. See “Marker Toggle Modes” below for detailed behaviour.
  • Zoom slider changes how much of the song waveform you see in the timeline. For precise edits, zoom in closer to the waveform to fully see waveform transients.

Marker Toggle Modes​

  • Beats Mode

    • Shows beat markers and lets you drag them to correct timing. Moving one beat nudges following beats so the grid stays musical.
    • Selecting every beat (use Cmd/Ctrl + A while the timeline is focused) reveals the Fixed BPM field in the top bar. Enter a tempo and all beats re-space evenly across the song.

  • Chords Mode

    • Displays chord markers and enables chord editing tools.
    • Select any chord and use the Root and Type dropdowns in the top bar to change it. The dropdown supports: Maj, Min, Aug, Dim, 6, Min6, 7, Maj7, Min7, Aug7, Dim7, m7b5 (Ø), 9, Maj9, Min9, Sus2, Sus4, 5, MinMaj7, and Octave shapes, with roots A–G plus sharps/flats.
    • You can also type chords directly into the spreadsheet (e.g. F#m7, Cmaj9/G). Slash chords are supported; leave the cell blank to remove the marker.
    • Double-clicking the canvas while Chords mode is active adds a new chord aligned to the closest beat.

  • Parts Mode

    • Shows song section markers (Intro, Verse, Chorus, etc.) and lets you define or rename them.
    • Parts can be renamed in the spreadsheet or timeline; the engine uses these sections to loop or target specific song moments during playback.
    • Double-clicking the canvas while Parts mode is active drops a new section marker at the nearest beat. Clearing a part cell removes that section from both the spreadsheet and the timeline.
    • A part marker spans from its start beat to the next part marker or the end of the track. Dragging a part marker adjusts its start time, and the previous part automatically extends to fill the gap.

Mixer Panel​

  • Adjust the Theme and Track sliders to balance playback levels.
  • A Debug Theme is loaded that plays simple chords to help you hear chord changes clearly. A metronome click is also included to help with beat timing.
  • Click the speaker icons to mute/unmute either source. Muting sets gain to zero until toggled back on.
  • Volume choices are remembered for the next session.

Music Theory Panel​

Circle of Fifths​

  • Visualizes key relationships to help with chord selection.
  • Automatically highlights the current key based on detected chords.
  • Click any Chord button to either audioly preview it or apply it to the selected chord marker in the timeline/spreadsheet.

Key Selection​

  • By default, the tool detects the song key from the chords.
  • Use the Key dropdown to set the song’s key signature manually. This influences chord suggestions and analysis.
  • The Arrow button resets the key selection to automatic detection.

Keyboard Preview​

  • The highlighted keys show the current scale based on the selected key signature.
  • Click any key to hear its pitch, useful for auditioning chords or melodies.
  • Chords playback from the timeline/spreadsheet will also highlight the relevant keys.

Saving & Reverting​

  • Use the Save button whenever you want to keep your edits.
  • If you need to revert to the original automated markers, press Auto Analyze and confirm. Unsaved changes will be lost.

Tips & Best Practices​

  • Selecting markers in the timeline updates the spreadsheet selection, and vice versa.
  • Clicking a time / beat cell in the spreadsheet focuses that position in the waveform timeline.
  • Set the desired marker toggle before editing spreadsheet cells so new markers are active immediately.
  • Use the spreadsheet for precise naming and the timeline for positioning.
  • Rename parts clearly (e.g., “Verse 1”, “Chorus”) to keep the structure readable when exporting or sharing.
  • After major edits, play back the track to confirm edits align with the intended beats, chords, or sections.