📖 How to use this app
The app takes an image of standard sheet music (a staff in treble clef) and produces a fingering chart for a D tin whistle — one diagram per note, grouped by bar — and plays the tune back with a whistle sound. Everything runs in your browser: the image is never sent to a server.
Step 1 — Sheet music image
- Which images work: clean, printed notation — a screenshot, a PDF page, a straight scan. Skewed, blurry or noisy photos are not supported yet.
- How to add one: drag the image into the box, paste it (Ctrl+V), click "Choose file", or "Load example" to see how it works.
- What you see on the image: a gold circle on every recognised note; a square with R on a rest; a red circle = the note does not match the letter printed under it (if any) — worth checking in step 2.
- Playback: "▶ Play on tin whistle" plays what was recognised at the tempo you choose (slow / medium / fast); the note being played is highlighted. When playback ends, or when you click "Continue to step 2", the next steps open.
Step 2 — Check and edit
- Song title is read from the image (in English); you can change it — it appears in the chart and in the file names.
- Note sequence is shown as text, and every edit updates the chart immediately. The notation:
| Notation | Meaning |
|---|---|
C D E F G A B | note letters |
F# Bb | sharp / flat attached to the letter |
D5 | octave number (default 4; 5 = high octave) |
A/2 A/1 A/8 | half, whole, eighth (no suffix = quarter) |
R R/2 | rest (with the same duration suffixes) |
| | bar line |
| new line | new staff (a new row in the chart) |
Example: D D A A | B B A/2 | G G F# F#
- Key signature: the sharps/flats at the start of the staff (up to 3 flats / 4 sharps). Changing it recomputes the recognised notes.
- Octave: automatic from the note's position on the staff, or all low / all high.
- Transpose: D ↔ G (for a G whistle) or an octave up/down; "Key in heading" sets what the chart heading says.
- Show note durations: adds each note's value (whole / half / quarter / eighth) under its diagram.
- Typos are reported under the text. A note that cannot be played on a D whistle is marked in the chart with a red ?.
Step 3 — Fingering chart
- Reading a diagram: the six holes from top (nearest the mouth) to bottom — filled = covered, empty = open, half filled = half-hole (for chromatic notes such as F, G#). The note name is above the diagram; + = high octave (blow harder).
- Rests are drawn as a rest symbol instead of a whistle.
- "Save as image (PNG)" — downloads the chart as an image file.
- "Save the tune (WAV)" — downloads the tune as it is in the chart (after editing and transposition), at the tempo chosen in step 1.
What the app can't do yet
- Treble clef only; durations: whole / half / quarter / eighth (sixteenths are read as eighths).
- Dots and ties are not recognised — fix them by hand in the text (for example
A/2instead of two tied A's). - Titles in Hebrew are not read automatically — type them into the title field.
📖 איך משתמשים בתוכנה
התוכנה מקבלת תמונה של תווים רגילים (חמשה במפתח סול) ומייצרת טבלת אצבוע לחליל אירי בסולם D — דיאגרמה לכל תו, מקובצת לפי תיבות — ומנגנת את המנגינה בצליל חליל. הכל רץ בדפדפן שלכם: התמונה לא נשלחת לשום שרת.
שלב 1 — תמונת התווים
- אילו תמונות מתאימות: תווים מודפסים ונקיים — צילום מסך, עמוד PDF, סריקה ישרה. צילום עקום, מטושטש או מרועש עדיין לא נתמך.
- איך מכניסים: גוררים את התמונה לתיבה, מדביקים (Ctrl+V), לוחצים "בחירת קובץ", או "טעינת דוגמה" כדי לראות איך זה עובד.
- מה רואים על התמונה: עיגול זהב על כל תו שזוהה; ריבוע עם R על הפסקה; עיגול אדום = התו לא תואם לאות המודפסת מתחתיו (אם יש) — כדאי לבדוק אותו בשלב 2.
- נגינה: "▶ נגינה בחליל אירי" מנגן את מה שזוהה, בקצב שבוחרים (איטי / בינוני / מהיר); התו המנוגן מודגש. בסיום הנגינה, או בלחיצה על "המשך לשלב 2", נפתחים השלבים הבאים.
שלב 2 — בדיקה ועריכה
- כותרת השיר נקראת מהתמונה (באנגלית); אפשר לשנות אותה — היא מופיעה בטבלה ובשמות הקבצים.
- רצף התווים מופיע כטקסט, וכל תיקון בו מעדכן את הטבלה מיד. הכתיב:
| סימון | משמעות |
|---|---|
C D E F G A B | אותיות התווים |
F# Bb | דיאז / במול צמודים לאות |
D5 | ספרת אוקטבה (ברירת מחדל 4; 5 = אוקטבה גבוהה) |
A/2 A/1 A/8 | חצי, שלם, שמינית (ללא סיומת = רבע) |
R R/2 | הפסקה (עם אותן סיומות משך) |
| | קו תיבה |
| שורה חדשה | חמשה חדשה (שורה חדשה בטבלה) |
דוגמה: D D A A | B B A/2 | G G F# F#
- מפתח סימנים: הדיאזים/במולים שבתחילת החמשה (עד 3 במולים / 4 דיאזים). שינוי כאן מחשב מחדש את התווים שזוהו.
- אוקטבה: אוטומטי לפי מיקום התו בחמשה, או הכל נמוך / הכל גבוה.
- טרנספוזיציה: D ↔ G (לחליל G) או אוקטבה למעלה/למטה; "סולם בכותרת" קובע מה ייכתב בכותרת הטבלה.
- הצגת משך התו: מוסיף לכל דיאגרמה את ערך התו (שלם / חצי / רבע / שמינית).
- שגיאות כתיב מוצגות מתחת לטקסט. תו שאי אפשר לנגן בחליל D מסומן בטבלה ב-? אדום.
שלב 3 — טבלת האצבוע
- קריאת דיאגרמה: ששת החורים מלמעלה (הקרוב לפה) למטה — חור מלא = סגור, ריק = פתוח, חצי מלא = חצי-חור (לתווים כרומטיים כמו F, G#). מעל הדיאגרמה שם התו; + = אוקטבה גבוהה (נשיפה חזקה יותר).
- הפסקה מוצגת בסימן הפסקה במקום דיאגרמה.
- "שמירה כתמונה (PNG)" — מוריד את הטבלה כקובץ תמונה.
- "שמירת המנגינה (WAV)" — מוריד את המנגינה כפי שהיא בטבלה (אחרי העריכה והטרנספוזיציה), בקצב שנבחר בשלב 1.
מה התוכנה עוד לא יודעת
- מפתח סול בלבד; משכים: שלם / חצי / רבע / שמינית (שש-עשריות נקראות כשמיניות).
- נקודות הארכה וקשתות-קשר לא מזוהות — מתקנים ידנית בטקסט (למשל
A/2במקום שני A מחוברים). - כותרת בעברית לא נקראת אוטומטית — מקלידים אותה בשדה הכותרת.
1. Sheet music image
Drag a sheet-music image here, paste it (Ctrl+V), or
2. Check and edit
3. Fingering chart