🎵 Blue River Score Maker

User Manual – Quick Start Guide

1. Before you start (backend setup)

This app is a single Cloudflare Worker. To unlock all features, make sure:

• You have added an AI binding in wrangler.toml (for Workers AI) with binding = "AI".
• You have set the secret ANTHROPIC_API_KEY (or legacy CLAUDE_API_KEY) for Claude features.
• You have created a Cloudflare AI Search index named myscores if you want the "Web Score (AI Search)" panel to work.

If any of these are missing, the app will show clear error messages in the AI panels.

2. Generate a new melody or full song

• Fill in Piece Title and Composer (or use the defaults).
• Use the Length, Key, and Time selectors.
• Click "Generate Score" for a short phrase, or "Generate Full Song (32 bars)" for longer pieces.
• Click "Play Melody" to hear the composition with your selected instrument sound.

3. Using the Metronome

• Set your tempo using the number input or Tap Tempo button.
• Click Start Metronome to practice with a click track.
• Adjust beats per bar to match your time signature.

4. Changing Instrument Sounds

• Click any instrument button to change the playback sound.
• Available: Piano, Electric Piano, Organ, Strings, Brass, Synth, Bells, Marimba.

5. Editing notes manually

• Scroll through the Note List text area.
• Each line follows the pattern: 1. C4 — 1 beat (midi 60).
• Change note names (e.g. C4 → D4) and durations (e.g. 1 → 0.5).
• Click "Apply Note Edits" to update the score.
• Use Undo/Redo to navigate through your edit history.

6. Using the practice keyboard

• Click keys on the mini keyboard to preview notes.
• Use your computer keyboard: A-S-D-F-G-H-J-K for white keys, W-E-T-Y-U-O-P for black keys.
• Enable Keyboard Recording to capture your performance as a new score.

7. Import & Export

• Import Score File: Upload PDF or image files for Claude to extract the melody.
• Import MIDI: Load existing MIDI files directly.
• Download: Export as MIDI, JSON, TXT, or SVG.

8. AI Features

• Ask AI to Improve: Get professional feedback on your melody.
• Web Score (AI Search): Search indexed scores for lead sheets.

9. Theme Toggle

Click the Dark Mode button to switch between light and dark themes.