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.

أرشيف المقام العربي الرقميArchive Numérique du Maqām Arabe

Plateforme, API et corpus multilingues et open-source pour explorer le système des maqām arabes

Entrer dans l'ArchiveNécessite un navigateur de bureau

Fonctionnalités principales

Exploration interactive

Jouez des centaines de systèmes d'accord, d'ajnās et de maqāmāt avec votre clavier d'ordinateur ou des appareils MIDI.

Analyse comparative

Passez entre plusieurs systèmes d'accord pour entendre et comparer leurs intervalles sur le même jins ou maqām.

Précision mathématique

Accédez à une analyse mathématique détaillée incluant les calculs d'intervalles et les constructions d'ajnās.

Modulations algorithmiques

Explorez les modulations de maqām selon les règles de modulation de Sāmī Al-Shawwā.

Rigueur académique

Accédez à des références bibliographiques complètes pour toutes les données musicologiques.

Accès ouvert aux données

Exportez les données pour un usage de recherche ou créatif, ou utilisez notre API ouverte pour l'intégration programmatique.

À propos

L'Archive Numérique du Maqām Arabe est une plateforme en ligne innovante, en libre accès et open-source, dédiée à l'étude et à l'exploration du système des maqāmāt arabes.

La plateforme est conçue comme une ressource pour les étudiants, musiciens, compositeurs, musicologues, éducateurs, chercheurs, développeurs et toute personne intéressée par la riche théorie musicale de la région arabophone.

Elle offre un dépôt interactif et académiquement rigoureux de systèmes d'accord, d'ajnās et de maqāmāt, ainsi que leurs suyūr (chemins de développement mélodique) et intiqālāt (modulations), tous pouvant être joués et entendus avec un clavier d'ordinateur ou via MIDI.

Les musiciens et compositeurs peuvent exporter des fichiers Scala d'accord pour l'intégration avec des instruments et logiciels externes. En parallèle, les développeurs et chercheurs peuvent accéder à des données structurées et interrogeables par calcul via des exportations JSON complètes et des points de terminaison API, ainsi que des données et analyses mathématiques approfondies.

Pour les développeurs et les LLM

Tous les points de terminaison de l'API sont publics, non authentifiés et renvoient du JSON brut ; l'ensemble du corpus est lisible par machine. Les guides complets, les exemples prêts à l'emploi, le terrain de jeu interactif et la spécification OpenAPI se trouvent dans la documentation.

Exemple
GET https://diarmaqar.net/api/maqamat/maqam_rast?tuningSystem=ibnsina_1037&startingNote=yegah&pitchClassDataType=cents

Agents IA : commencez par llms.txt pour un index lisible par machine de tous les points de terminaison, ou collez cette invite pour donner à un agent un accès immédiat :

Invite
Vous avez accès à l'Archive Numérique du Maqām Arabe (DiArMaqAr), une API REST publique en lecture seule sur https://diarmaqar.net/api (sans authentification). Découvrez tout via https://diarmaqar.net/docs/llms.txt. Contrat complet lisible par machine : https://diarmaqar.net/docs/openapi.json

Équipe du projet

Ce projet a été recherché, conçu et développé par Khyam Allami avec Ibrahim El Khansa au Music Intelligence Lab / Centre for Advanced Mathematical Sciences, Université américaine de Beyrouth, Liban, 2026.

Contribuer

Nous accueillons les contributions de la communauté pour nous aider à améliorer et à développer ce projet davantage. Veuillez visiter notre dépôt GitHub pour signaler des problèmes, suggérer des fonctionnalités ou soumettre des demandes de tirage. Alternativement, si vous souhaitez aider à la saisie de données, veuillez contacter directement Khyam Allami à ka109@aub.edu.lb.

Des centaines de systèmes d'accord, d'ajnās et de maqāmāt, prêts à être joués, écoutés et étudiés.

Entrer dans l'ArchiveNécessite un navigateur de bureau