عن المشروع

shaperbox-importer هي أداة مكتوبة بلغة Python تتيح الاستيراد الجماعي لحزم الإعدادات المسبقة (بصيغ .vstpreset أو .fst) إلى Cableguys ShaperBox 3 على نظام macOS. وهي تغني عن العملية اليدوية المملة لتحميل كل إعداد مسبق بشكل فردي عبر واجهة المستخدم الخاصة بالمكون الإضافي. تستخدم الأداة Pedalboard من Spotify لاستضافة ShaperBox 3 كمكون إضافي، مما يسمح لها بنقل بيانات الإعدادات المسبقة القديمة داخلياً إلى التنسيق الحالي الذي يستخدمه ShaperBox 3. بعد عملية النقل، تقوم الأداة بكتابة الإعدادات المحولة مباشرة في قاعدة بيانات SQLite المحلية لـ ShaperBox ومخزن ملفات .dat الموجهة بالمحتوى، مما يجعلها تظهر تحت علامة التبويب 'MY PRESETS' عند التشغيل التالي. تشمل الميزات الرئيسية النسخ الاحتياطي التلقائي لمجلد بيانات ShaperBox قبل أي عملية كتابة، ورفض التشغيل أثناء نشاط أي DAW (لمنع قفل قاعدة البيانات)، ووضع التشغيل التجريبي (dry-run) لمعاينة عمليات الاستيراد. تدعم الأداة مئات الإعدادات المسبقة في المرة الواحدة وتتعامل مع كل من ملفات إعدادات VST3 وملفات حالة FL Studio عن طريق استخراج وإعادة تغليف بياناتها المضمنة. تتطلب الأداة نظام macOS، وPython 3.9+، وتثبيت مرخص لـ ShaperBox 3. التثبيت متاح عبر pip أو uv. يُنصح المستخدمون بإغلاق الـ DAW الخاص بهم قبل تشغيل الأداة؛ يتوفر وضع القوة (force mode) ولكنه محفوف بالمخاطر. في حال حدوث مشكلات، يمكن للمستخدمين الاستعادة من النسخة الاحتياطية التي تم إنشاؤها تلقائياً. داخلياً، تقوم الأداة بالهندسة العكسية لتنسيق تخزين ShaperBox: حيث يتم تخزين إعدادات المستخدم في قاعدة بيانات SQLite (presets.db) إلى جانب ملفات .dat المنظمة في هيكل موجه بالمحتوى. يحتوي كل ملف .dat على JUCE ValueTree مضغوط بواسطة zlib ومغلف بـ '#zip#\0'. تضمن الأداة أن تكون حقول 'المؤلف' (author) في الإعدادات المستوردة فارغة لكي تظهر في 'MY PRESETS'. القيود: لا يدعم Windows/Linux؛ يعمل فقط مع ShaperBox 3 (وليس المكونات الإضافية الأخرى من Cableguys)؛ لا يمكن تعيين الإعدادات المسبقة لحزم محددة حتى الآن؛ سلوك المزامنة السحابية غير موثق ولكنه مرئي محلياً. قد تتطلب التحديثات المستقبلية تعديل ثابت إصدار قاعدة البيانات إذا قامت Cableguys بتغيير المخطط (schema). تم تطوير المشروع بمساعدة الذكاء الاصطناعي من Claude (Anthropic). مرخص بموجب رخصة MIT.