travis code-climate codecov AGPL CCBYNC

Dunya-desktop is a desktop application, developed for accessing and visualizing music data such as music scores, audio recordings, extracted features and analysis results. It is a modular and extendable desktop application that the users can customise according to their needs.

Dunya-desktop mainly uses PyQt5, Python bindings for Qt5 application framework, for the user interface design and pycompmusic module for reaching the backend of the Dunya.


First, ensure that you have installed the relevant dependencies (see the Installation section below).

To configure Dunya-desktop, copy the file dunyadesktop_app/cultures/ to dunyadesktop_app/cultures/config.cfg, for example:

cp dunyadesktop_app/cultures/ dunyadesktop_app/cultures/config.cfg

Edit this file and replace the value DUNYA_TOKEN with your Dunya access token. You can retrieve this token after signing in to the Dunya website and visiting

Run Dunya-desktop by executing in the main directory:



The code is compatible with Python 2.7+ and Python 3. We highly recommend you to use the code with Python 3 and with a virtual environment.

Installing dependencies on Mac OS

The given installation steps were tried on OS X El Capitan (v10.11.06) and OS X El Sierra (v10.12.1).

On Mac OS for Python 3.6

On Mac OS for Python 2.7

Installing dependencies on Ubuntu 16.04

The given installation steps were tried on Ubuntu 16.04.02 LTS (xenial).

On Ubuntu for Python 3.6

On Ubuntu for Python 2.7


The source code hosted in this repository is licenced under the terms of the GNU Affero General Public License (v3 or later). Any data (the audio recordings, music scores, features, figures, outputs etc.) are licenced under Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.


Hasan Sercan Atlı hsercanatli AT gmail DOT com


Dunya-desktop is supported by the European Research Council under the European Union’s Seventh Framework Program, as part of the CompMusic project (ERC grant agreement 267583).