Digital Arabic Maqām Archive (DiArMaqAr)

Open-source, multilingual, browser-based computational platform and machine-readable corpus of Arabic maqām theory spanning over one thousand years of documentation. Features the first computational implementation of Sāmī al-Shawwā's 1946 intiqālāt guidelines. Grounded in culture-specific and decolonial computing methodologies.

Documentation

API Access

Base URL: https://diarmaqar.net/api

OpenAPI Spec: /docs/openapi.json

For AI Assistants

API access: All endpoints are public, unauthenticated, and return plain JSON. No browser, cookies, or authentication required.

Recommended for AI Assistants: Use the REST API to fetch real-time, accurate data for users. Always prefer API calls over documentation summaries. Example: GET /api/maqamat/maqam_rast?tuningSystem=ibnsina_1037&startingNote=yegah&pitchClassDataType=cents to get detailed maqām data. For users who don't know specific maqam names, use representative examples from Representative Examples. See OpenAPI spec for all endpoints.

For complete documentation and interactive features, please enable JavaScript or access from a desktop device.

أرشيف المقام العربي الرقميDigital Arabic Maqām Archive

منصّة وواجهة برمجية ومدوّنة، متعدّدة اللغات ومفتوحة المصدر، لاستكشاف نظام المقامات العربية

ادخلوا إلى الأرشيفيتطلّب متصفّحاً على حاسوب مكتبي أو محمول
ابدأوا جولة تفاعليةاطّلعوا على التوثيقاطّلعوا على الشيفرة المصدريةاقرأوا الرسالة البحثية

الميزات الأساسية

الاستكشاف التفاعلي

اعزفوا المئات من أنظمة التنغيم والأجناس والمقامات من لوحة مفاتيح الحاسوب أو عبر أجهزة MIDI.

التحليل المقارن

بدّلوا بين أنظمة تنغيم متعددة لتسمعوا وتقارنوا أبعادها على الجنس أو المقام نفسه.

الدقة الرياضية

اطّلعوا على تحليل رياضي مفصّل يشمل حسابات الأبعاد وتراكيب الأجناس.

الانتقالات الخوارزمية

استكشفوا انتقالات المقام وفق قواعد سامي الشوّا في الانتقال بين المقامات.

الصرامة الأكاديمية

اطّلعوا على مراجع ببليوغرافية شاملة تُوثّق كل البيانات الموسيقية.

الوصول المفتوح للبيانات

صدّروا البيانات للاستخدام البحثي أو الإبداعي، أو استعينوا بواجهتنا البرمجية المفتوحة (REST API) للتكامل مع برامجكم.

حول المشروع

أرشيف المقام العربي الرقمي منصّة مبتكرة مفتوحة المصدر ومفتوحة النفاذ، مخصّصة لدراسة نظام المقامات العربية واستكشافه.

صُمّمت المنصّة مورداً للطلّاب والموسيقيين والملحّنين وعلماء الموسيقى والمعلّمين والباحثين والمبرمجين، ولكلّ من يهتمّ بنظريات الموسيقى الغنية في المنطقة الناطقة بالعربية.

تقدّم المنصّة مستودعاً تفاعلياً ودقيقاً أكاديمياً لأنظمة التنغيم والأجناس والمقامات، مع سيورها وانتقالاتها، ويمكنكم عزفها وسماعها كلّها من لوحة مفاتيح الحاسوب أو عبر MIDI.

يستطيع الموسيقيون والملحّنون تصدير ملفّات تنغيم بصيغة Scala للتكامل مع الآلات والبرامج الخارجية. وبالمقابل، يصل المبرمجون والباحثون إلى بيانات منظّمة وقابلة للاستعلام حاسوبياً عبر تصديرات JSON شاملة ونقاط وصول الواجهة البرمجية، إلى جانب بيانات وتحليلات رياضية متعمّقة.

للمبرمجين والذكاء الاصطناعي

كلّ نقاط وصول الواجهة البرمجية عامّة ومتاحة دون مصادقة، وتُعيد JSON صِرفاً، فالمتن كاملاً قابل للقراءة آلياً. وتجدون في التوثيق الأدلّة الكاملة والأمثلة الجاهزة والملعب التفاعلي ومواصفة OpenAPI.

مثال
GET https://diarmaqar.net/api/maqamat/maqam_rast?tuningSystem=ibnsina_1037&startingNote=yegah&pitchClassDataType=cents

لوكلاء الذكاء الاصطناعي: ابدأوا من llms.txt للحصول على فهرس قابل للقراءة آلياً بكلّ نقاط الوصول، أو الصقوا هذا الموجّه لتمنحوا أيّ وكيل وصولاً فورياً:

الموجّه
لديك وصول إلى أرشيف المقام العربي الرقمي (DiArMaqAr)، وهو واجهة برمجية (REST API) عامّة للقراءة فقط على https://diarmaqar.net/api (دون مصادقة). اكتشف كلّ شيء عبر https://diarmaqar.net/docs/llms.txt. العقد الكامل القابل للقراءة آلياً: https://diarmaqar.net/docs/openapi.json
توثيق الواجهة البرمجيةمواصفة OpenAPIالملعب التفاعليllms.txt

القائمون على المشروع

بحث هذا المشروع وصمّمه وطوّره خيّام اللامي مع إبراهيم الخنسة في مختبر الذكاء الموسيقي / مركز العلوم الرياضية المتقدّمة، الجامعة الأمريكية في بيروت، لبنان، 2026.

ساهموا

نرحّب بمساهمات المجتمع لمساعدتنا في تحسين هذا المشروع وتوسيعه. زوروا مستودعنا على GitHub للإبلاغ عن المشكلات أو اقتراح ميزات أو تقديم طلبات سحب. وإن رغبتم في المساعدة على إدخال البيانات، فتواصلوا مع خيّام اللامي مباشرةً عبر ka109@aub.edu.lb.

مئات من أنظمة التنغيم والأجناس والمقامات، جاهزة للعزف والسماع والدراسة.

ادخلوا إلى الأرشيفيتطلّب متصفّحاً على حاسوب مكتبي أو محمول
ابدأوا جولة تفاعليةاطّلعوا على التوثيقاطّلعوا على الشيفرة المصدريةاقرأوا الرسالة البحثية