How to create a custom call-to-prayers schedule

Contents

Introduction

You can create your own custom schedule, so that your custom call to prayers schedule is available for selection BY LOCATION in the Call To Prayers Settings section in the iOS App, similar to the way you can select the call to prayers schedule for Dubai and Nairobi today.

In addition to manual backups, CasaTunes will automatically backup your configuration to the cloud, prior to performing a CasaTunes update and also when you change your hardware configuration. However, we still recommend you perform your own manual backup because CasaTunes has no way of knowing which is the correct backup to use, if you need to perform a restore. In addition, access to cloud based backups is only available to CasaTunes Technical Support, and if you do not create your own backup, you will need to contact them to perform the restore.

How to create your own custom call to prayers schedule file

A custom schedule file is a regular XML file that adheres to a special naming convention.  The filename is used to specify the city, country and year, and is formatted as follows:

<city>-<country>-<year>.xml

The year is always specified as a 4 digit year (YYYY), for example, 2020.

The <city> and <country> usually specify the name of the city and country, but can be anything you like.  These are displayed in the UI as “Country, City”.  

For example, the current version of CasaTunes includes the following custom schedule files for Dubai and Kenya:

And are displayed on an iOS device as follows:

XML file content format

The format of the xml file is as follows:

There is a DailySchedule XML Element for each day of the year. The file must include an entry for each day of the year.  The times must be in 24 hour format.

Adding your custom schedule files to CasaTunes

Once you have created your XML schedule files, you must add them to CasaTunes. To add them, simply copy the files to the following folder:

\\CasaServer\CasaData\Prayers\Custom