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.netlify.app/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.

🖥️

Desktop Required

The Digital Arabic Maqām Archive is designed for laptop and desktop computers only.

Please access this application from a device with a larger screen for the best experience.

Digital Arabic Maqām Archive (DiArMaqAr)

Comprehensive bilingual browser-based application and repository integrating historically documented Arabic maqām theory within a unified computational framework. Provides rigorously sourced, computationally accessible reference data with transparent provenance for computational musicology, music information retrieval, machine learning applications, and scholarly research.

Documentation

API Access

Base URL: https://diarmaqar.netlify.app/api

OpenAPI Specification: /docs/openapi.json

Interactive Playground: /docs/api/playground

For AI Assistants and LLMs

Recommended for AI Assistants: Use the REST API to fetch real-time, accurate data for users. Always prefer API calls over documentation summaries for real-time data accuracy. The API provides programmatic access to all maqāmāt, ajnās, and tuning systems data.

Example Requests for Novice Users: For users who don't know specific maqam names, use these representative examples:

Quick Test URL: GET https://diarmaqar.netlify.app/api/maqamat/maqam_rast?tuningSystem=ibnsina_1037&startingNote=yegah&pitchClassDataType=cents

All endpoints return JSON with complete data including pitch classes, intervals, bibliographic sources, and more. See Representative Examples for complete list of recommended examples. Use the OpenAPI specification for complete endpoint documentation and parameter details.

Quick Links

About

Digital Arabic Maqām Archive (DiArMaqAr) is an open-source platform for Arabic maqām theory providing REST API and TypeScript library. Includes historically documented maqāmāt, ajnās, and tuning systems spanning from al-Kindī (874 CE) to contemporary approaches. All data includes comprehensive bibliographic attribution following decolonial computing principles.

Note: Full interactive features require a desktop device. However, all documentation and API endpoints are accessible programmatically. For complete documentation, see: /docs/llms.txt

About the Arabic Maqām Network

Project Overview

The Arabic Maqām Network is an innovative open-access online platform dedicated to the study and exploration of the Arabic maqām system. This comprehensive digital resource represents a groundbreaking approach to preserving, analyzing, and sharing the rich musical heritage of the Arabic-speaking region.

Developed by Dr. Khyam Allami and Ibrahim El Khansa at the Music Intelligence Lab at the American University of Beirut, Lebanon, this platform bridges traditional Arabic music theory with modern computational tools and interactive technologies.

Mission & Purpose

Our mission is to create a comprehensive, academically rigorous, and accessible resource for understanding the intricate world of Arabic maqāmāt. The platform serves as both an educational tool and a research platform, enabling users to explore, analyze, and experience the mathematical and musical structures that define this ancient musical tradition.

We aim to make the complex theoretical concepts of tuning systems, ajnās, maqāmāt, and modulations accessible to a global audience while maintaining the depth and authenticity required for serious academic research.

Who Is This For?

The Arabic Maqām Network is designed to serve a diverse community of music enthusiasts and professionals:

  • Students learning Arabic music theory and practice
  • Musicians seeking to understand and perform maqāmāt
  • Composers incorporating Arabic musical elements
  • Musicologists conducting research on Middle Eastern music
  • Educators teaching world music and ethnomusicology
  • Researchers in computational musicology and music theory
  • Cultural enthusiasts exploring Arabic musical heritage

Technical Innovation

The platform leverages cutting-edge web technologies to create an interactive and immersive experience. Built as a modern single-page application using Next.js, React, and TypeScript, the system provides real-time audio synthesis, MIDI integration, and sophisticated mathematical analysis tools.

Our unique approach includes the implementation of algorithmic modulation analysis based on Sāmī Al-Shawwā's historical rules for maqām transitions, providing users with authentic pathways for exploring musical relationships and structures.

Core Features

Interactive Exploration

Play and hear hundreds of tuning systems, ajnās, and maqāmāt using your computer keyboard or MIDI devices.

Comparative Analysis

Switch between multiple tuning systems to compare their structures and hear their unique interval characteristics.

Mathematical Precision

Access detailed mathematical analysis including interval calculations, frequency ratios, and cent values.

Modulation Pathways

Explore authentic maqām modulations based on traditional theoretical frameworks and historical practices.

Expert Commentary

Read detailed analyses and commentaries by Dr. Khyam Allami on each tuning system, maqām, and sayr.

Open Data Access

Export data in various formats and access our open API for programmatic integration and research.

Academic Foundation

The platform is built upon a foundation of rigorous musicological research and draws from extensive historical sources and contemporary scholarship. Our comprehensive bibliography includes classical treatises, modern academic works, and field recordings that inform our understanding of maqām practice and theory.

Every data point in the system is carefully sourced and documented, ensuring that users have access to the scholarly context behind each musical element. This commitment to academic integrity makes the platform a trusted resource for serious research and education.

Open Access & Community

As an open-access platform, we believe that knowledge about Arabic musical heritage should be freely available to all. Our commitment to accessibility extends beyond just making the platform free to use—we also provide open data and API access to enable researchers and developers to build upon our work.

We encourage collaboration and welcome contributions from the global community of musicians, scholars, and technologists who share our passion for preserving and promoting Arabic musical traditions.

Future Vision

The Arabic Maqām Network represents just the beginning of our vision for digital preservation and exploration of world music traditions. We continue to expand our database, refine our analytical tools, and develop new features that serve the evolving needs of our diverse user community.

Through ongoing research, technological innovation, and community engagement, we aim to set new standards for how traditional music systems can be studied, preserved, and shared in the digital age.