# מסדר הסינגלים - Singles Sorter

<p align="center">
    <img src="https://github.com/NHLOCAL/Singles-Sorter/blob/main/versions.data/program-screen.png?raw=true"/>
</p>

## 🎵 אודות מסדר הסינגלים

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

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

[🌐 בקרו באתר הרשמי של התוכנה](https://singles-sorter.ze-kal.top)


## 📦 PyPI Installation

```bash
pip install singlesorter
```

To enable AI-based detection (spaCy + scikit-learn models):

```bash
pip install "singlesorter[ai]"
```

After installation, run:

```bash
singlesorter --help
```

Custom singer lists:
- Place `personal-singer-list.csv` in the current working directory, or
- Set `SINGLESORTER_PERSONAL_LIST` to an absolute/relative CSV path.

For local development and packaging checks:

```bash
python -m build
```

## 🚀 תכונות עיקריות

- **מיון חכם:**  🧠  התוכנה מנתחת את שמות הקבצים ומאפייני המטה-נתונים שלהם כדי לזהות במדויק את שם האמן. היא מסוגלת להתמודד גם עם שמות קבצים מורכבים ותקנים שונים של תיוג.
- **מאגר אמנים נרחב:**  🎼  מסדר הסינגלים מכיל מאגר מידע עצום של זמרים יהודיים וחרדיים, מה שמאפשר לו לזהות ולקטלג מגוון רחב של אמנים, גם פחות מוכרים.
- **ממשק ידידותי ואינטואיטיבי:**  🖱️  לא צריך להיות גאון מחשבים כדי להשתמש בתוכנה. ממשק המשתמש הפשוט והברור מאפשר לכל אחד, גם בלי ידע טכני, לארגן את המוזיקה שלו בקלות.
- **גמישות מירבית:**  ⚙️  מסדר הסינגלים מציע מגוון אפשרויות התאמה אישית, כך שתוכלו להתאים את אופן פעולת התוכנה להעדפותיכם. 
- **מהירות ויעילות:**  ⚡  התוכנה פועלת במהירות וביעילות, וממיינת אלפי קבצים תוך דקות ספורות, וחוסכת לכם שעות של עבודה ידנית מייגעת. 


## 🔧 כיצד זה עובד?

1. **סריקת קבצים**: התוכנה סורקת את התיקייה שבחרתם לחפש קבצי מוזיקה.
2. **זיהוי אמנים**: מנתחת את שמות הקבצים לזיהוי שמות האמנים.
3. **יצירת מבנה תיקיות**: מייצרת תיקיות חדשות עבור כל אמן שזוהה.
4. **העברת קבצים**: מעתיקה או מעבירה את הקבצים לתיקיות המתאימות.
5. **דיווח**: מציגה סיכום של הפעולות שבוצעו (בקרוב)

## 📦 גרסאות זמינות

מסדר הסינגלים זמין במגוון גרסאות כדי להתאים לצרכים של כל אחד:

- **גרסת מתקין (53.6 MB):** התקנה מלאה עם ממשק גרפי, מומלצת למשתמשי Windows.
- **גרסת אנדרואיד:** גרסת APK נוחה וניידת עבור מכשירי אנדרואיד.
- **גרסת CLI (6.66 MB):** גרסת שורת פקודה קלת משקל, אידאלית למשתמשים מתקדמים המעוניינים באוטומציה ושליטה מלאה.
- **גרסה ניידת (76.9 MB):** גרסה עצמאית שאינה דורשת התקנה, מותאמת לשימוש מכונן נייד או עבור מחשבים עם הגבלות התקנה.
- **קוד מקור:** קוד המקור זמין בגיטהאב בפורמטים ZIP ו- tar.gz, ומאפשר למפתחים ללמוד מהפרויקט, לתרום לו ולפתח אותו הלאה.

[⬇️ הורידו את הגרסה המתאימה לכם](https://github.com/NHLOCAL/Singles-Sorter/releases/latest)


## 💻 הוראות שימוש

### גרסת מתקין

1. הורידו את קובץ ההתקנה `Singles-Sorter-Installer-13.2.exe`.
2. לחצו פעמיים על הקובץ והתקינו את התוכנה לפי ההוראות שמופיעות על המסך.
3. לאחר ההתקנה, הפעילו את התוכנה מתפריט ההתחלה או משולחן העבודה.


### גרסת APK

1. הורידו את קובץ ה-APK `Singles-Sorter-13.2.apk` למכשיר האנדרואיד שלכם.
2. פתחו את אפליקציית "הקבצים שלי" או כל מנהל קבצים אחר במכשיר.
3. אתרו את קובץ ה-APK שהורדתם ולחצו עליו להתקנה. 
4. לאחר ההתקנה, תוכלו למצוא את סמל האפליקציה במכשיר שלכם.

### גרסת CLI
הריצו בשורת הפקודה לקבלת מידע נוסף:
```
Singles-Sorter-cli-13.2.exe -h
```

### גרסה ניידת
1. חלצו את `Singles-Sorter-Portable-13.2.zip`.
2. הפעילו את הקובץ הראשי מהתיקייה שנוצרה.

## 🛠 טכנולוגיות

- **Python**: שפת התכנות העיקרית בה נכתבה התוכנה.
- **Flet**: ספריית Python המבוססת על Flutter, ליצירת ממשקי משתמש גרפיים מרשימים.

## 🤝 תרומה לפרויקט

מעוניינים לתרום? נשמח לעזרתכם!

1. Fork את המאגר
2. צרו ענף חדש (`git checkout -b feature/AmazingFeature`)
3. Commit את השינויים (`git commit -m 'הוספת תכונה מדהימה'`)
4. Push לענף (`git push origin feature/AmazingFeature`)
5. פתחו Pull Request

## 📄 רישיון

מופץ תחת רישיון MIT. ראו `LICENSE` לפרטים נוספים.

## 📞 יצירת קשר

שאלות? הצעות? צרו קשר:

📧 nh.local11@gmail.com

---

<p align="center">
⭐ אהבתם את הפרויקט? תנו לנו כוכב! זה מעודד אותנו להמשיך לפתח ולשפר
</p>
