
المشروع مفتوح المصدر وسهل لأي شخص تنزيله وتشغيله على Windows، فالأفضل تقديمه كبرنامج محلي وليس كموقع أو خدمة سحابية.
نموذج المشروع للمستخدم النهائي
Sng-hayef5Mus-no فاضيه وحجمها Sng-hayef5Mus-yas فيها وحجمها نوع البرمجة
المشروع مبني على:
- Node.js + JavaScript — تشغيل الخادم والمعالجة.
- ONNX Runtime — تشغيل نموذج فصل الصوت.
- ONNX — نموذج الذكاء الاصطناعي
Polarformer. - FFmpeg / FFprobe — قراءة وتحويل الملفات الصوتية.
- HTML + CSS + JavaScript — واجهة البرنامج.
- Batch
.bat— تشغيل البرنامج بسهولة على Windows.
ولا يحتاج المستخدم إلى قاعدة بيانات أو تسجيل دخول أو اشتراك أو إنترنت أثناء الاستخدام، إذا كانت كل الملفات المطلوبة مرفقة مع المشروع.
طريقة التشغيل لأول مرة
المستخدم يحمّل المشروع ثم:
1. يثبت Node.js على Windows.
2. يتأكد أن FFmpeg والنموذج موجودان داخل مجلد المشروع.
3. يشغل:
start.batفيقوم البرنامج تلقائياً بـ:
فحص Node.js↓فحص FFmpeg↓فحص النموذج↓تثبيت npm dependencies↓تشغيل الخادم المحلي↓فتح الواجهة في المتصفح
ثم تظهر الواجهة مثلاً:
VOCAL SEPARATORاسحب ملفك الصوتي هنا[ اختيار ملف ]↓جاري فصل الصوت...Processing 5 / 1338%Elapsed 00:24↓✓ Vocals[▶ Play] [Download]✓ Instrumental[▶ Play] [Download]
أهم ملاحظة للمستخدم
الملف الصوتي لا يحتاج أن يُرفع إلى الإنترنت.
المعالجة تتم على جهاز المستخدم نفسه:
ملف المستخدم↓FFmpeg↓ONNX Runtime↓Polarformer↓Vocals + Instrumental↓السماع / التنزيل
وبالتالي الملفات الناتجة يمكن أن تبقى محلية على جهازه.
المتطلبات المقترحة
لأفضل أداء:
- Windows 10/11 64-bit
- AMD Ryzen 5 أو أفضل
- Ryzen 7 7730U مناسب للمشروع
- RAM: يفضل 8 GB أو أكثر
- مساحة حرة عدة GB
- Node.js LTS
- FFmpeg
ولا تحتاج أن تقول للمستخدم إنه يحتاج كرت شاشة؛ النسخة الحالية يمكن أن تعمل بالـCPU.
ملاحظات مهمة في README
ضع هذه النقاط بوضوح:
Vocal Separator is a local audio separation application.
Processing is performed locally on the user's computer.
Audio files are not uploaded to a remote server.
Internet is only required initially if Node.js dependencies need to be installed.
Processing speed depends on the user's CPU, RAM, audio length, and model.
وأيضاً:
First launch may take longer because Node.js dependencies and the ONNX model may need to initialize.
والأهم بالنسبة لنسخة GitHub
لا تضع node_modules داخل المشروع إذا كنت ستنشره كمشروع مفتوح المصدر.
ضع:
package.jsonpackage-lock.json
واجعل start.bat ينفذ npm install عند الحاجة.
أما FFmpeg والنموذج، فلهما نقطة مهمة: قبل نشر المشروع يجب التأكد من ترخيص النموذج وFFmpeg وطريقة إعادة توزيعهما، خصوصاً إذا كنت ستضمّنهما مباشرة داخل المستودع.
بهذا الشكل يصبح مشروعك بسيطاً جداً للمستخدم:
تحميل → تشغيل start.bat → فتح البرنامج → اختيار الصوت → فصل → سماع/تنزيل.
ولا يحتاج المستخدم إلى حساب أو قاعدة بيانات أو استضافة أو VPS.







ليست هناك تعليقات: