בוזוקי אקדמי — Μπουζούκι

כלי לימוד אינטראקטיבי לבוזוקי יווני 8 מיתרים (טטראחורדו, כיוונון C-F-A-D).

מאסטר מודוסים

משחק אינטראקטיבי ללמידת דרומוסים (סולמות יווניים) בזמן אמת. בחרו דרומוס, טוניקה ורמת קושי — האפליקציה מנגנת את הסולם, מאירה כל תו על גריף 8 מיתרים, ומקשיבה למיקרופון כדי לבדוק שניגנתם נכון.

• תו אחר תו — שמעו, ראו על הגריף, נגנו
• סולם מלא — כל הסולם מוצג, נגנו ברצף
• Hero Mode — תווים נופלים בסגנון Guitar Hero
• 12 דרומוסים יווניים ומאקאמים
• 3 רמות קושי

מאסטר אקורדים

למדו אקורדים על הבוזוקי — האפליקציה מראה את צורת האצבוע על הגריף, משמיעה את האקורד, ומקשיבה לנגינה שלכם. מזהה כל תו שנוגן ונותנת משוב בזמן אמת.

• 17 אקורדים: יווניים, מזרחיים (מקאמים)
• צ'יפס צבעוניים לכל תו באקורד (ירוק = זוהה)
• טיימר לפי רמת קושי
• גריף 8 מיתרים עם סימון צורת האקורד

מאסטר הפנייה

משחק קצב דו-כיווני: חיצים ↓↑ זורמים אל קו פגיעה — הקישו במקלדת או במגע בתזמון מושלם. 8 שלבים מרבעים ועד טזנה 7/8.

ריפו נפרד לשיתוף בקבוצות: github.com/boaz65sa-byte/penia-master

למד מהשיר — Bouzouki 2.0

מסך למידה · חדש בתפריט:

מסך	מה עושים שם
למד מהשיר (YouTube)	חיפוש כמו YouTube, הורדה, נגן, ניתוח AI, נתיבי דרומוס
ספריית לימוד	כל ההורדות — נגינה, ניתוח, שמירה ב-learn-downloads
התקדמות	גרף פעילות 14 יום, streak, XP — נשמר ב-IndexedDB

מסלול לימוד אחד (חיפוש → תרגול)

בראש מסך למד מהשיר מופיע פס התקדמות:

1. חיפוש — YouTube (דרך stem-proxy) או ספריית השירים המובנית
2. הורדה — 📥 שומר באפליקציה + בתיקייה learn-downloads
3. ספרייה — מסך ספריית לימוד בתפריט
4. ניתוח — TAB, אקורדים, BPM (Essentia.js)
5. תרגול — נתיב דרומוס או שיר בספרייה

אחרי כל הורדה מופיעה הצעה: נתח / ספרייה / תרגל.

חיפוש YouTube

• עד 30 תוצאות בכל עמוד + טען עוד (ללא הגבלה קשיחה)
• בלי פרוקסי — חיפוש בספרייה המובנית (מיסירלו, ציצאניס…)
• דורש הפעלה מחדש של stem-proxy אחרי עדכון האפליקציה

ניתוח AI

• העלאת MP3/WAV — Essentia.js בדפדפן
• Play-along — תרגול TAB במאמין עם כוכבים ו-XP
• Tooltip אקורד — ריחוף על אקורד בכל האפליקציה

YouTube + הפרדת stems (אופציונלי)

1. העתיקו config.example.js → config.js והגדירו stemProxyUrl: 'http://localhost:3456'
2. הריצו את הפרוקסי:

   cd tools/stem-proxy
   npm install
   npm start
   

3. YouTube: התקינו yt-dlp (pip install yt-dlp / winget install yt-dlp)
4. Stems: הוסיפו LALAL_LICENSE_KEY או MOISES_API_KEY ב-tools/stem-proxy/.env

מדריך מלא גם בתוך האפליקציה: למד מהשיר → מדריך התקנה.

בכניסה הראשונה — חלון הסבר אוטומטי על config.js, stem-proxy ו-yt-dlp (עם בדיקת סטטוס).

ייצוא ו-PWA

• ייצוא JSON / TXT — אחרי ניתוח, כפתורי הורדה בתוצאות
• נתח מ-YouTube — כפתור "נתח ב-AI" בטאב YouTube
• PWA — manifest.json + service worker; cache לכל JS/CSS + Essentia.js ו-Meyda מה-CDN (offline חלקי אחרי ביקור ראשון)

תוכן ζεϊμπέκικο

• תרגילים zb1–zb12 (9/4, טקסימי, Am–Dm–E7, קדנצות)
• נתיב ζεϊμπέκικο — 9 שלבים + 7 שירים עם YouTube
• נתיב קיורדי חדש — מינור טבעי לשירי לאיקו
• משאבי רשת: Ευδοκία, ספירת 9/4

למד שיר על הצוואר

מסך נגינה על צוואר הטטראחורדו (בתפריט למידה · חדש): נקודה זהובה על המיתר, מספר אצבע, סולפג׳ בעברית ובלטינית, תווים עם כיוון רישה, ציר תיבות, לולאת קטע, קצב ומטרונום. הצליל יוצא ממנוע ה־Karplus-Strong הקיים.

השירים נמצאים ב־js/neck-songs.js. כל תו הוא אובייקט:

שדה	משמעות
string	קורס 0–3 (0 רה גבוה, 1 לה, 2 פה, 3 דו)
fret	סריג 0–15, 0 = פתוח
finger	אצבע 0–4, 0 = פתוח
duration	משך בפעימות רבע (0.5 שמינית, 1 רבע, 2 חצי)
pick	'd' רישה יורדת, 'u' רישה עולה

שתיקה: { rest: true, duration }. סכום המשכים חייב להיסגר לפי המשקל. קטעים: sections[].startMeasure מתחיל ב־1.

עוד מסכים

מסך	מה עושים שם
הכלי והכיוונון	טיונר עם צלילי ייחוס אמיתיים (כולל זוגות אוקטבה), איור מבנה הכלי, מפת כל הצלילים על לוח הסריגים
דרומוסים	15 דרומוסים — לוח סריגים אינטראקטיבי, השמעת סולם, צליל רקע, תרגיל מיתר בודד, מדור מאקאם עם ששת הג'ינס
פנייה — יד ימין	מדריך טכניקה מאויר + מאמן פנייה מונפש עם מטרונום מובנה
ספריית תרגילים	61+ תרגילים ב-12 קטגוריות — יסודות, טריולים, טרמולו, סולמות, ζεϊμπέκικο, נתיב מודוס ועוד
מקצבים יווניים	זאימבקיקו 9/4, חסאפיקו, ציפטטלי, קלמטיאנוס 7/8 ועוד — מכונת מקצב דום/טק
מאמן מאזין	מקשיב למיקרופון, מזהה צלילים, בודק מול יעד, ציון ומשוב + Play-along מניתוח שיר
חדר תרגול	שגרת אימון יומית עם מעקב, מטרונום חופשי, טיפים
ספריית שירים	שירים עם אקורדים, ליווי בוזוקי, tooltip על אקורדים
ג'אם סימולטור	תהלוכת אקורדים עם tooltip
מילון רבטיקו	המונחים החיוניים

איך מפעילים

פשוט פותחים את index.html בדאבל-קליק — אין צורך בהתקנה, באינטרנט או בשרת. (מומלץ Chrome / Edge. בכניסה הראשונה ללחוץ פעם אחת בעמוד כדי לאפשר שמע.)

במובייל: הממשק מותאם מלא לטלפון (ניווט תחתון, כפתורי מגע). העלו לשירות סטטי חינמי (Netlify Drop / Vercel) וקבלו כתובת שנפתחת מכל מקום.

קבצים

קובץ	תפקיד
index.html	מבנה האפליקציה
css/style.css	עיצוב + רספונסיב מובייל
js/data.js	הידע המוזיקלי (דרומוסים, מקצבים, תבניות)
js/audio.js	מנוע צליל (סינתזת Karplus-Strong, מטרונום)
js/app.js	הלוגיקה והאינטראקציה
js/learn-youtube.js	Learn Hub — YouTube, נתיבים, ניתוח
js/songs/song-references.js	הפניות YouTube (~130 שירים)
js/songs/song-catalog.js	קטלוג שירים מובנה
js/songs.js	UI ספריית שירים, נגינה, טרנספוז
js/learn-flow.js	מסלול לימוד אחד (חיפוש→תרגול)
js/learn-onboarding.js	הסבר ראשון stem-proxy
js/learn-library.js	ספריית הורדות
js/song-analyzer.js	ניתוח שיר — Essentia, waveform, play-along
js/stem-api.js + tools/stem-proxy/	פרוקסי stems + YouTube
js/progress-dashboard.js	Dashboard התקדמות
js/chord-tooltip.js	דיאגרמת אקורד ב-hover
js/exercises.js	ספריית תרגילים
js/listen.js	מאמן מאזין — זיהוי צלילים מהמיקרופון
js/game.js	מאסטר הפנייה — משחק קצב
js/master.js	מאסטר מודוסים + מאסטר אקורדים

כל הצלילים מסונתזים בזמן אמת ב-Web Audio — בלי קובצי שמע.

Καλή πρόοδο! (התקדמות טובה!)