Skip to content

NHLOCAL/Music-Automatic

Repository files navigation

Music-Automatic: אוטומציה לניהול ספריית המוזיקה שלך

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

🌟 תכונות עיקריות

  • ארגון קבצים ותיקיות: כלים לתיקון שמות, מחיקת תיקיות ריקות ומיזוג תיקיות אמן.
  • זיהוי וטיפול בכפילויות: מודול מתקדם לאיתור אלבומים כפולים או דומים מאוד, עם אפשרויות למיזוג מידע או מחיקה חכמה.
  • שיפור מטא-דאטה: תיקון קידוד פגום (ג'יבריש), השלמת מידע חסר.
  • ניתוח איכות: הערכת איכות אלבומים על בסיס פרמטרים מגוונים.
  • ממשקים גמישים: אפשרות להפעלה דרך שורת הפקודה (CLI) או ממשק משתמש גרפי (Web UI).
  • שילוב למידת מכונה ו-AI: שימוש במודל ML ייעודי וב-Gemini API לשיפור דיוק הזיהוי וההשוואה.

📂 מבנה הפרויקט

הפרויקט מחולק לשלוש ספריות עיקריות:

music_organizer:

מכיל סקריפטים לביצוע פעולות תחזוקה בסיסיות על קבצי מוזיקה ותיקיות. ⚠️ אזהרה: ספרייה זו עדיין בפיתוח ואינה מוכנה לייצור. יש להשתמש בה בזהירות ולאחר גיבוי הנתונים. למידע נוסף

album_deduplicator:

המודול המרכזי לזיהוי, ניתוח וטיפול באלבומי מוזיקה כפולים או דומים. כולל CLI, Web UI (מבוסס Streamlit), ומנוע השוואה מתוחכם. למידע נוסף

similarity_model:

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

🚀 תוכנית עבודה

  • ✅ המרה אוטומטית של מטאדאטה פגום
  • ✅ המרת קבצים עם שם לא מוגדר באנגלית (למשל: "track") לשם מתאים בעברית (כגון: "רצועה")
  • ✅ חיפוש וזיהוי תיקיות מוזיקה כפולות וניקויין
  • הסרת שירים כפולים עם זיהוי חכם (בסינגלים כפולים - הסרה של העותק הפחות איכותי)
  • הוספת שם לפי כותרת ולהיפך, עם בדיקת עדיפות (שמות שמכילים את המילה "רצועה" במקום שם שיר למשל)
  • סקירה כללית עם המלצות לביצוע
  • חיפוש קבצי וידאו שתופסים מקום
  • חיפוש קבצים בעלי קצב סיביות גבוה, עם אופציה לכיווץ

⚙️ התקנה כללית

דרישות ספציפיות לכל מודול מפורטות בקובצי ה-README המתאימים. באופן כללי, תזדקק ל-Python (מומלץ 3.10 ומעלה) ולמנהל חבילות כמו pip.

git clone https://github.com/NHLOCAL/Music-Automatic.git
cd Music-Automatic

לאחר מכן, עקוב אחר הוראות ההתקנה בכל ספריית משנה.

📄 רישיון

פרויקט זה מופץ תחת רישיון MIT. ראה קובץ LICENSE לפרטים מלאים.

About

Streamlined sorting and reorganization of music folders on the computer through advanced automation

Resources

License

Stars

Watchers

Forks

Contributors