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

• Main Documentation
• LLM-Optimized Documentation Index
• API Documentation
• Representative Examples
• OpenAPI Specification

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.

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. Comprises tanāghīm (tuning systems), ajnās (tri/tetra/pentachords), maqāmāt (melodic modes), suyūr (melodic pathways), and intiqālāt (modulation practices) compiled from primary Arabic, English, and French sources ranging from al-Kindī's 9th-century ratios to 20th-century scholarship, with complete bibliographic provenance. 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

• Main Documentation
• LLM-Optimized Documentation Index
• Full LLM Documentation
• API Documentation
• Representative Examples
• OpenAPI Specification

API Access

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

OpenAPI Specification: /docs/openapi.json

Interactive Playground: /docs/api/playground

For AI Assistants and LLMs

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 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:

• Most common maqam: GET /api/maqamat/maqam_rast?tuningSystem=ibnsina_1037&startingNote=yegah&pitchClassDataType=cents
• Most common jins: GET /api/ajnas/jins_rast?tuningSystem=ibnsina_1037&startingNote=yegah&pitchClassDataType=cents
• List all tuning systems: GET /api/tuning-systems
• Most common tuning system: GET /api/tuning-systems/ibnsina_1037/yegah/pitch-classes?pitchClassDataType=cents

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

• Interactive Application
• Documentation Home
• API Reference
• TypeScript Library Documentation

About

Digital Arabic Maqām Archive (DiArMaqAr) is an 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. Provides REST API, JSON exports, and Scala tuning file exports. All data includes complete bibliographic provenance.

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