Skip to content

Repository files navigation

NAS VocalChanger V05

A Windows workflow manager for local singing voice conversion with dedicated Seed-VC and HQ-SVC engine controls, structured project workspaces, health checks, and verified in-app updates.

Release V05 Validation Windows Local engines

Download NAS VocalChanger V05 · Release notes

What it does

  • Starts, stops, checks, and opens the existing Seed-VC interface at http://127.0.0.1:7860.
  • Installs or repairs HQ-SVC in WSL Ubuntu, then controls its interface at http://127.0.0.1:7861.
  • Keeps Seed-VC and HQ-SVC environments isolated.
  • Creates predictable input, reference, output, approval, rejection, configuration, and log folders.
  • Checks WSL, engine, NVIDIA GPU, and local interface state.
  • Checks GitHub Releases for sequential updates, downloads the matching executable and checksum, verifies SHA256, and replaces the application only after approval.

Install on Windows

  1. Open the latest GitHub Release.
  2. Download NAS.VocalChanger.V05.exe and SHA256SUMS-V05.txt.
  3. Verify the executable's SHA256 value against the checksum file.
  4. Run the executable. No repository clone or Python installation is required for the packaged application.

Requirements vary by engine. Seed-VC uses an existing local installation; HQ-SVC requires Windows 10/11, WSL 2 with Ubuntu, an NVIDIA GPU available inside WSL, internet access during first setup, and sufficient storage for environments and models.

Important

Voice conversion must be used only with recordings and voices you own or have explicit permission to process.

العربية

أداة Windows لتنظيم مشاريع Singing Voice Conversion وتشغيل HQ-SVC محلياً عبر WSL من دون كتابة أوامر بعد الإعداد الأول.

الوظائف

  • اختيار Source Vocal وReference Voice.
  • تسمية الملفات حسب المشروع والقسم والطبقة ورقم التسجيل والصوت المستهدف.
  • إنشاء بنية مشروع ثابتة وحفظ سجل العمليات في Config/project.json.
  • تشغيل HQ-SVC وإيقافه من واجهة سطح المكتب.
  • فتح واجهة HQ-SVC على رابط ثابت:
http://127.0.0.1:7861
  • فحص حالة WSL وHQ-SVC وNVIDIA GPU.
  • فتح Workspace وملف Log مباشرة.
  • تشغيل Seed-VC المثبت محلياً وإيقافه وفتح واجهته وسجله من تبويب مستقل.
  • البحث عن الإصدارات الجديدة وتنزيل ملف EXE والتحقق من SHA256 قبل الاستبدال.

الاستخدام لأول مرة

  1. افتح تبويب HQ-SVC Engine.
  2. اضغط Install / Repair HQ-SVC.
  3. إن لم يكن WSL Ubuntu مثبتاً، ستفتح الأداة PowerShell كمسؤول لتشغيل:
wsl --install -d Ubuntu
  1. بعد تثبيت Ubuntu وإعادة التشغيل عند الحاجة، اضغط زر التثبيت مرة أخرى.
  2. أكمل العملية داخل نافذة Terminal الظاهرة. قد يطلب Ubuntu كلمة مرور المستخدم عند تثبيت الحزم.
  3. بعد ظهور HQ-SVC setup completed، أغلق Terminal.

التشغيل اليومي

Start and Open

يقوم التطبيق بـ:

تشغيل WSL
→ تشغيل HQ-SVC
→ انتظار تحميل النماذج
→ فحص الرابط
→ فتح المتصفح تلقائياً

للإيقاف استخدم:

Stop Engine

البيئة

يُثبت HQ-SVC داخل Ubuntu في:

~/HQ-SVC

ويستخدم البيئة الرسمية المنشورة من المشروع. تبقى بيئة HQ-SVC منفصلة عن Seed-VC ولا تعدّلها.

Workspace الصوتي

H:\AI-Audio\HQ-SVC\Workspace
├── Input
├── Reference
├── Output
├── Approved
├── Rejected
└── Logs

يتم إنشاء المجلدات عند الضغط على Open HQ-SVC Workspace.

بنية مشاريع VocalChanger

Documents/NAS VocalChanger/Projects/PROJECT_NAME
├── Input
├── Reference
├── Output
├── Approved
├── Rejected
├── Logs
└── Config/project.json

مواصفات الملفات المفضلة

Mono WAV
44.1 kHz
24-bit
Dry
بدون Reverb أو Delay أو Limiter

متطلبات HQ-SVC

  • Windows 10 أو Windows 11.
  • WSL 2 مع Ubuntu.
  • NVIDIA GPU متاح داخل WSL.
  • اتصال بالإنترنت أثناء التثبيت الأول.
  • مساحة تخزين كافية للبيئة والنماذج.

نظام الإصدارات

كل تطوير يصدر برقم مستقل ولا يستبدل النسخة السابقة:

V01 → V02 → V03 → V04 → V05

GitHub Actions يبني الإصدار الحالي:

NAS VocalChanger V05.exe
SHA256SUMS-V05.txt

Architecture and validation

NAS VocalChanger UI
├── Project and file workflow
├── Seed-VC controller → existing Windows environment → localhost:7860
├── HQ-SVC controller → WSL Ubuntu environment → localhost:7861
├── Health and log surfaces
└── Update service → GitHub Release → SHA256 verification → approved replacement

Pull requests run source preparation and Python compilation without publishing a release. The release workflow runs only for explicit release source paths on main, builds the Windows executable with PyInstaller, writes SHA256SUMS, and publishes both assets.

See CONTRIBUTING.md for validation requirements and SECURITY.md for private vulnerability reporting.

الاستخدام المسؤول

استخدم فقط تسجيلات وأصواتاً تملكها أو لديك موافقة واضحة على استخدامها في التحويل أو التدريب.

About

Windows workflow manager for local singing voice conversion with HQ-SVC and Seed-VC execution through WSL.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages