🎸 Editing Detected Chords

Viewing & Clicking:

• Chords appear in the timeline above the playback area
• Click any chord block to select it, or use hover to preview timing
• The current chord is highlighted in large text during playback

Making Changes:

• Edit a chord: Click the chord block to open the editor and change the chord symbol (e.g., C → Cm)
• Adjust timing: Drag chord blocks left/right to move them, or drag edges to resize
• Add chords: Use the "+ Add Chord" button to insert chords at specific times
• Delete chords: Right-click (or long-press on mobile) a chord to delete it
• Undo/Redo: Press Ctrl+Z to undo or Ctrl+Shift+Z to redo any changes

Tips for Accuracy:

• Slow down playback (0.5x–0.75x) to verify chord changes at beat boundaries
• Use visual alignment with the waveform to place chords at natural transitions
• Choose Madmom model for jazz or complex progressions (slightly slower but more accurate)

📝 Editing Text & Transcription

Fixing Lyrics:

• Click any word in the transcript section to edit it individually
• A modal opens where you can correct the word or delete it entirely
• Press Enter or click Save to confirm changes

About Transcription Quality:

• Lyrics are auto-detected from vocal content and aligned with chords for you
• If transcription is off, try uploading a cleaner audio file or using a higher-quality source
• YouTube videos with captions often produce better results
• For instrumental tracks, transcription will be skipped automatically

Saving Your Edits:

• All text edits are saved locally as you make them
• Both chord and lyric edits are included when you download your partition
• Use undo/redo (Ctrl+Z / Ctrl+Shift+Z) to revert unwanted changes

📥 Export Formats & What's Included

Available Download Formats:

• 📄 Chord Sheet (TXT): Clean text format with chords above lyrics and measure numbers. Perfect for musicians or printing. Includes song metadata.
• 🎹 iReal Pro (TXT): Specialized format for the iReal Pro app. Import to practice with AI-generated backing tracks and accompaniment.
• 📋 PDF Partition: Professional lead sheet with chords, lyrics, and formatted layout. Print-ready with metadata embedded.
• 🎸 Guitar Tabs (TXT): ASCII tab notation with chord symbols aligned above. Great for guitarists who prefer text-based tabs.
• 🎸 Guitar Tabs (PDF): Formatted guitar tabs as a printable PDF with standard notation hints and chord boxes for reference.
• 🎵 MIDI (MID): Digital musical notation. Import into your DAW (Ableton, Logic, Cubase) for editing, arrangement, or production.

What Every Download Includes:

• ✅ Song Metadata: Title, artist, detected key, estimated tempo, duration
• ✅ Chord Progression: All detected chords (or your edits) with precise timing
• ✅ Lyrics: Full transcribed text (if transcription was enabled) with alignment to chords
• ✅ Your Edits: All manual corrections to chords and lyrics are preserved
• ✅ Quality Info: Confidence scores visible in some formats to show detection reliability

Download Tips:

• Choose PDF to share with bandmates or for printing lead sheets
• Choose iReal Pro if you want to practice with backing tracks in the iReal app
• Choose MIDI to remix or arrange in your music production software
• Choose TXT formats for portability and easy editing in any text editor

💡 Tips & Best Practices

• Use clear, high-quality audio for better results.
• Choose Madmom for accuracy (slower) or Essentia for speed.
• Use slower playback speeds to verify difficult sections.
• If URL analysis is slow, download locally and upload the file.

🎵 Audio Transpose

Change the key of your audio in real-time while preserving chord notation and playback quality.

How to Use:

• Step 1: Analyze your audio to detect the original key
• Step 2: Select a target key from the Transpose dropdown (e.g., C, D, D#)
• Step 3: Watch the progress indicator (0%-100%) as audio is processed
• Step 4: When complete, play the high-quality transposed audio
• Reset: Click the Reset button to return to the original key

Features:

• ✅ Real-time progress: Track processing status with live percentage updates
• ✅ High-quality audio: Optimized pitch shifting preserves rhythm and transients
• ✅ Chord synchronization: All chord labels update automatically to match the new key
• ✅ Key detection: Original key is auto-detected during analysis
• ✅ Instant switching: Previously transposed keys are cached for quick re-selection

Technical Details:

• Range: Transpose up to ±12 semitones (one octave)
• Processing time: ~10-20 seconds for a typical song (varies by length)
• Quality: Uses librosa's advanced pitch shifting with optimized parameters
• Caching: Transposed versions are stored temporarily for instant replay

🔢 Bar Offset Correction

If the bar labels start at 1 but your song has an intro before the main progression, use the "Set bar 1" button in Current Chords to visually pick where bar 1 should be.

How to Use:

• Step 1: Analyze your audio — the Current Chords strip shows nearby bars labeled from M1
• Step 2: Use the Current Chords strip and look at the small bar labels above each chord
• Step 3: Click the "Set bar 1" button in the Current Chords header — the button highlights and the chord strip enters selection mode
• Step 4: Click any chord chip in Current Chords — that bar becomes M1 and all labels re-render immediately
• The offset is saved when you save to the library, and restored when you load the song again

Notes:

• The offset only affects displayed labels — the audio timing and chord positions are unchanged
• Measure headers with a resulting label of 0 or below are hidden from the timeline
• Click "Set bar 1" again to cancel selection mode without changing the offset