عن المشروع

Pedalboard هي مكتبة بايثون من مختبر الذكاء الصوتي في Spotify للتعامل مع الصوت: القراءة والكتابة والعرض وتطبيق التأثيرات. وهي تدعم صيغ ملفات الصوت الشائعة ومجموعة من التأثيرات المدمجة، ويمكنها تحميل آلات وتأثيرات VST3 وAudio Unit من طرف ثالث. القدرات الرئيسية الموضحة في README: - أدوات إدخال/إخراج الصوت (pedalboard.io): قراءة وكتابة AIFF وFLAC وMP3 وOGG وWAV على جميع المنصات دون تبعيات إضافية؛ وصيغ إضافية مثل AAC وAC3 وWMA حسب المنصة؛ وإعادة أخذ العينات أثناء التشغيل باستهلاك ذاكرة O(1)؛ وتأثيرات صوتية مباشرة عبر AudioStream. - التأثيرات المدمجة: تأثيرات بأسلوب الغيتار (Chorus وDistortion وPhaser وClipping)، والجهارة والديناميكيات (Compressor وGain وLimiter)، والمعادلات والمرشحات (HighpassFilter وLadderFilter وLowpassFilter)، والتأثيرات المكانية (Convolution وDelay وReverb)، وتأثيرات النغمة (PitchShift)، والضغط بفقدان (GSMFullRateCompressor وMP3Compressor)، وتقليل الجودة (Resample وBitcrush). - دعم الإضافات: آلات وتأثيرات VST3 على macOS وWindows وLinux عبر pedalboard.load_plugin؛ وAudio Units على macOS. - الأداء والخيوط: يحرر GIL الخاص ببايثون لاستخدام عدة أنوية CPU؛ ويذكر README أن المعالجة أحادية الخيط أسرع بما يصل إلى 300 مرة من pySoX للتحويلات المفردة، وأسرع بمقدار 2-5 مرات من SoxBindings، وأن قراءة الملفات أسرع بما يصل إلى 4 مرات من librosa.load في كثير من الحالات. - التوافق مع TensorFlow: قابل للاستخدام في خطوط أنابيب tf.data. التثبيت عبر pip (pip install pedalboard)، مع حزم منصة لـ Linux (manylinux وmusllinux، x86_64 وaarch64)، وmacOS (Intel وApple Silicon)، وWindows (amd64). يذكر README أنه تم اختباره مع Python 3.10 حتى 3.15. تغطي الأمثلة في README بداية سريعة لقراءة وكتابة ملف WAV عبر Pedalboard، وبناء سلسلة تأثيرات بأسلوب الغيتار، وتحميل إضافات VST3 أو Audio Unit وعرض MIDI إلى صوت، وإنشاء سلاسل تأثيرات متوازية باستخدام إضافة Mix، ومعالجة الصوت المباشر باستخدام AudioStream، واستخدام Pedalboard داخل خط أنابيب tf.data. Pedalboard مرخّصة بموجب GPLv3 وتضم عدة مكتبات مجمّعة ساكنًا، بما في ذلك JUCE 6 وVST3 SDK وRubber Band وFFTW وlibmp3lame وlibgsm وdr_wav، ولكل منها شروط ترخيص خاصة بها كما هو مذكور في README.