Tawkit 9.63 — User Guide
Contents
1. What Tawkit is ↑
Tawkit is a free prayer-times display for mosques and homes. It runs full screen on a TV, a computer, a tablet or a phone, with or without internet.
- Free, no ads. Tawkit is a waqf: it may not be sold.
- Used in 74+ countries, in 48 languages.
- Author: Ismail Chagdali. He created the app in 2013 for home use; since 2016 it is used in mosques worldwide.
| On the screen | Details |
|---|---|
| Clock and dates | Clock, weekday, Hijri date and Gregorian date |
| Prayer times | Fajr, Shuruq (sunrise), Dhuhr, Asr, Maghrib, Isha, each with its adhan time and its iqama |
| Adhan and iqama | Sounds, adhan screen, countdown to iqama, black screen during the prayer |
| Night times | Middle of the night, last third of the night, tomorrow's Fajr |
| Qur'an and hadith | A new verse every minute (48 languages) and a new hadith every minute |
| Adhkar | After each prayer, plus morning and evening adhkar |
| Mosque content | Scrolling announcements, slides with text or pictures |
| Friday, Ramadan, Eid | Jumu'a time, Isha +30 minutes in Ramadan, Eid prayer banner |
| Weather | Temperature now and a 7-day forecast |
| Look | 40 backgrounds, your own picture, several fonts, landscape or portrait screen |
How to read this guide:
- Menu ☰ is the button at the top-left of the app. Every setting starts there.
- When the app asks for a time, type it in 24-hour format: 1:30 pm is
13:30. - Landscape is a horizontal screen. Portrait is a vertical screen.
- This guide describes version 9.63. The spelling of some names can differ a little on your screen (for example Azan for Adhan, Dohr for Dhuhr, Jomoa for Jumu'a, Azkar for Adhkar).
2. Choose your version ↑
For a mosque screen, use the Android app on a TV box. All versions show the same app with the same options.
| Version | Best for | How you get it |
|---|---|---|
| Android app (APK) | Android TV boxes, smart TVs with Android, tablets, phones | Download the APK from the download page and install it |
| Offline ZIP (HTML) | Windows, Mac, Linux, Raspberry Pi. Also for advanced users who want to change files (fonts, sounds, languages) | Download the ZIP, unzip it, open index.html in a browser |
| Web version | Any device with a browser, nothing to install | Open offline.tawkit.net |
| Online version | Older version with a free account and fewer features | online.tawkit.net |
Good to know:
- Web version: it is the same offline app, put on the web. Internet is needed only the first time, then it keeps working offline. For a screen used every day, the APK or the ZIP is better.
- iPhone and iPad: open offline.tawkit.net in Safari, then choose "Add to Home Screen" to launch it easily next time.
- A device where the app cannot be installed: open offline.tawkit.net in its browser.
- Amazon Fire TV: avoid it. It does not allow auto-start, so the app must be launched by hand after every restart.
The Android app differs from the browser versions in three points: the app plays the sounds itself, it has no Fullscreen button, and its menu has an AUTO-START checkbox.
3. What you need for a mosque screen ↑
Any TV with an HDMI input and an Android TV box is enough. A smart TV that runs Android needs no box.
| Item | Recommendation |
|---|---|
| Screen | Any TV or monitor with HDMI |
| Player | Android TV box, or a smart TV with Android. A computer or a Raspberry Pi also works with the ZIP version |
| Android version | 9 to 13 is best. Newer versions can block auto-start and USB |
| Memory (RAM) | At least 2 GB |
| Real-time clock (RTC) | Recommended. It keeps the time during power cuts |
| Internet | Not needed all the time (see below) |
- Device without RTC: after a power cut, switch Wi-Fi on for a moment. The time is corrected. Then switch Wi-Fi off again.
- Internet is needed only sometimes: for the weather (about once a week), for export and import of settings (a few minutes), and to correct the clock.
- The device date, time and time zone must be correct. Tawkit takes the time from the device as it is.
- The app is free; devices are not. The author gives the app for free and has no link with selling devices. Install the app yourself, or ask a volunteer or a shop.
4. Install and start ↑
4.1 Android (TV box, smart TV, tablet, phone)
- Open the download page and download the APK that fits your Android version.
- Install the APK and allow the permissions it asks for.
- Open Tawkit. In Menu ☰, tick AUTO-START so Tawkit starts with the device. Green means active, gray means off.
| Your Android version | APK to download |
|---|---|
| Android 5 to 14 | Main APK |
| Android 15 and 16 | ARM64 APK |
| Old device where the app does not open | Old version 9.61 |
- Updating: uninstall the old version before you install a new one. Export your settings first if you want to keep them (section 21).
- Box or TV without a browser: download the APK on a PC, copy it to a USB key, plug the key into the box or TV, and install the APK there with a file manager.
4.2 Computer or Raspberry Pi (ZIP version)
- Download the ZIP from the download page and unzip it.
- Open the file
index.htmlin a browser (Chrome, Edge, Firefox or Opera). - Click Menu ☰ → Fullscreen mode. This click also lets the browser play the sounds later.
- Do not use a private or incognito window: it does not keep your settings.
- On Android with the ZIP, use the Opera 88 browser (avoid Opera 51).
4.3 Web version (nothing to install)
Open offline.tawkit.net in the browser. Internet is needed the first time only. On iPhone and iPad, use Safari and "Add to Home Screen".
4.4 With a TV remote
The arrows move a pointer on the screen and OK clicks. Section 20 gives the details.
5. First setup ↑
Five steps are enough to get a correct screen. The app saves every change at once.
- Language: Menu ☰ → click your language code (EN, AR, FR, UR...). The app restarts.
- City: Menu ☰ → Mosque location → choose the country, then the city.
- Mosque name: Menu ☰ → Options → click the mosque name and type yours.
- Iqama: Menu ☰ → Adjust Adhan and Iqama times → set the minutes between adhan and iqama for each prayer, the Jumu'a time, and summer time if your country uses it.
- Check: compare the clock and today's times with your mosque's timetable. If the times differ, see section 8.
Then switch on what you want: black screen during prayer (section 11), adhkar (12), slides (13), announcements (14), backgrounds (16).
| Use | Recommended settings |
|---|---|
| Mosque, landscape TV | City; iqama minutes or fixed iqama times; black screen during prayer; last-minute alert; adhkar; announcements |
| Vertical screen made with a landscape TV | Force vertical display, rotate left or right (section 17) |
| Home | "Home clock - hide Iqama times"; adhan by voice; night times |
| Ramadan | Isha +30 minutes; Isha prayer duration up to 180 minutes for Tarawih; "days left until Ramadan" in the two months before |
| Friday | Jumu'a time (automatic or fixed); black screen start and end for Friday; Jumu'a adhan sound if you want it |
| Several screens | Set up one screen, export its settings, then import them on the others (section 21) |
You can check your settings without waiting for a prayer: use the test mode (section 20).
6. The screen explained ↑
Most parts of the screen react to a click, so you can change common options without opening the menu.
| Part of the screen | What it shows | What a click does |
|---|---|---|
| Menu ☰ (top-left) | The main menu | Opens and closes the menu |
| Mosque name | The name you typed in Options | Landscape: moves the date to the top-right and the name to the left |
| Dates | Weekday, Hijri date, Gregorian date | Click the Hijri date to correct it by one day |
| Clock | Small clock (hours and minutes) or full clock with seconds | Switches between the two |
| Weather | Temperature and icon. Landscape: also today's highest and lowest | 7 clicks reset the whole app (section 21) |
| Next-prayer box | Time left before the next prayer | Click the time: prayer names move to the middle. Click the text: bigger box (landscape) |
| Prayer table | The 6 times: name, adhan time, iqama | See the shortcuts in section 20 |
| Tomorrow box | Middle of the night, last third of the night, tomorrow's Fajr | 3 clicks: test mode |
| Shuruq and Duha box | Sunrise time and Duha time (some layouts only) | — |
| Middle box | A Qur'an verse, new every minute. Short notices also appear here | New verse |
| Bottom band | A hadith, new every minute, or your scrolling announcements | Switches between hadith and announcements |
| Bottom line | App name, version and the code of your city | Landscape: click the app name for 5 or 6 prayer cells |
| Star (bottom-left) | Green: internet works. Red: no internet. Only if the internet check is on | — |
| Palestine flag (top-left) | Optional flag | Restarts the app |
| Logo | The app logo. Landscape: can be replaced by the Jumu'a box | Double-click: black screen |
| Eid banner | "Eid prayer" and its time, in the days before Eid | — |
The prayer table
- The iqama is shown as minutes after the adhan (for example
10') or as a clock time. Fixed iqama times always show as clock times. - On Friday, the Dhuhr cell shows "Jumu'a" with the Jumu'a time.
- The tomorrow box is bright from 10 minutes after Maghrib until the middle of the night, and dimmed the rest of the day.
- Landscape: a frame marks the current prayer from the adhan to the iqama.
Landscape and portrait
The app chooses the layout by itself: landscape when the screen is wider than tall, portrait otherwise. In portrait, the positions of the boxes change with the background you choose. Some options exist only in landscape: 5 or 6 cells, date at the top-right, bigger next-prayer box, Jumu'a box, and today's highest and lowest temperature.
7. What happens at each prayer ↑
Tawkit runs the whole sequence by itself: adhan, countdown, iqama, black screen, adhkar, then slides. Nobody needs to touch the screen.
Adhan → Countdown to the iqama → Iqama → Black screen → Adhkar → Slides
The table gives the exact moment of each step and the menu where you switch it.
| When | What happens | Where you switch it |
|---|---|---|
| 3 minutes before the adhan | Slides and adhkar stop | Always |
| 1 minute before the adhan | The background changes, if you chose one background per prayer | Change screen background |
| X minutes before Fajr | First Fajr adhan: an alert sound | Adjust Adhan and Iqama times |
| At the adhan | Adhan sound. Adhan screen for 60 seconds, with the prayer name and the clock | Options |
| At the adhan | The countdown to the iqama starts | Options |
| 50 seconds after the adhan | Arabic interface only: a reminder about du'a between adhan and iqama, for 1 minute | — |
| 90 seconds before the iqama | The counter turns red | Options |
| 60 seconds before the iqama | The message "Please switch off your phones" with an alert sound. Option: giant seconds | Options |
| 33 seconds before the iqama | A hadith about the iqama in the bottom band, for 30 seconds | Options |
| At the iqama | Iqama sound. Iqama screen for about 10 seconds (option), then the black screen | Options; Adjust screen blackout |
| During the prayer | Black screen for the prayer duration you set. The clock and the date can stay visible | Adjust screen blackout |
| After the prayer | Adhkar after the prayer, or one fixed picture for 5 minutes | Display Adhkar |
| After these adhkar | Morning adhkar (after Fajr) or evening adhkar (after Asr, Maghrib or Isha) | Display Adhkar |
| After the adhkar | Slides in a loop, until 3 minutes before the next prayer | Display slides |
Three rules explain most surprises:
- The iqama screen, the black screen, the adhkar and the slides start at the end of the countdown. If the countdown is off, or if the home mode is on, they do not start by themselves. The sounds still play.
- The prayer duration counts from the iqama.
- Morning and evening adhkar also run when the adhkar after prayers are off.
Shuruq and Duha
- At Shuruq there is no adhan sound. A "Shuruq time" notice shows for 10 seconds and the countdown to Duha starts.
- At Duha time (Shuruq + 15 minutes by default) a short sound plays and the "Duha time" screen shows for 20 seconds. The slides start 30 seconds later, if they are on.
New day, restart, power cut
- At 00:00 the app loads the new day: dates, prayer times, today's announcements and the background of the day.
- After a restart or a power cut, everything is calculated again. If the restart happens between an adhan and its iqama, the countdown continues.
Friday has its own sequence: see section 10.
8. Prayer times ↑
Tawkit reads the times of your city from its own yearly timetable; it does not need internet for this. Most cities of the world are included.
8.1 Choose your city
Menu ☰ → Mosque location → choose the country, then the city. The times load at once.
8.2 Small corrections (a few minutes)
Menu ☰ → Adjust Adhan and Iqama times. Use − and + next to each prayer to move its adhan time, from −60 to +60 minutes.
8.3 Use the exact timetable of your mosque
This is the method used by most mosques. You prepare the times on a home computer, then send them to the mosque screen with an ID.
- On a home computer, open offline.tawkit.net in the browser.
- Make all the settings of your mosque there.
- Menu ☰ → Export/Import settings → Export settings. Download the settings file.
- Open the file with Notepad, edit the times of your mosque, and save.
- Go to settings.tawkit.net and import the edited file. The website gives you an ID like
XXXX-XXXX. - On the mosque device, with internet for this step: Menu ☰ → Export/Import settings → Import by ID. Type the ID and confirm.
- The app reloads with the correct times and settings.
Rules for the file:
- Each day is one line: the date, then Fajr, Shuruq, Dhuhr, Asr, Maghrib, Isha, in 24-hour format.
- Keep the line exactly in this shape, and change only the times:
"01-01~~~~~05:40|07:05|12:20|15:30|17:45|19:10",
- The year must be complete: 365 or 366 lines. If it is not, the app shows "Invalid Imported Times ! Settings File Used." and uses the city times.
- Use Notepad on Windows. Change only the text between the quotes
" "and do not add other quotes. - The file must stay under 90 KB.
- Keep the option "Use prayer times from imported file" enabled, or the app goes back to the city times.
8.4 Your city is not in the list
- Choose any city, export the settings, replace the times with yours, upload the file on settings.tawkit.net, then use Import by ID (same steps as 8.3).
- To create the yearly times of your city, use the prayer times generator.
- To ask for a new city in the app: tell the Tawkit AI assistant on the website the city, the country, and where its official times come from. It forwards the request to the author.
8.5 Import without internet
Menu ☰ → Export/Import settings → Import local file, then choose the settings file on the device. This does not work on some Android devices; use the ID method there.
8.6 Summer time (daylight saving)
Menu ☰ → Adjust Adhan and Iqama times.
| Option | Use it when |
|---|---|
| Add one hour during summer | Your times are in winter time and your country changes on the last Sunday of month 03 and of month 10 (European rule). The app then adds the hour by itself |
| +1 hour or −1 hour | Any other case: you move all prayer times by one hour yourself |
8.7 The clock is one hour wrong
Tawkit is an app, not the system of your device. It takes the time from the device as it is.
- First correct the date, time and time zone in the settings of the device.
- Go back to Tawkit and restart it: Menu ☰ → Reload application.
- If you cannot correct the device, use Menu ☰ → Options → "Adjust main clock, add or remove hours". Click the number to add or remove hours (from −7 to +7).
This option moves the clock of the app only. It does not move the prayer times.
8.8 Night times
Three times can be shown near Fajr: the middle of the night, the last third of the night, and tomorrow's Fajr. The night is counted from Maghrib to the next Fajr. Switch them on or off in Options.
9. Adhan and iqama ↑
The times are set in Menu ☰ → Adjust Adhan and Iqama times. The sounds, screens and counters are set in Menu ☰ → Options.
9.1 Sounds
| Option | Default | What it does |
|---|---|---|
| Adhan and iqama by voice (MP3) | Off | Plays the full adhan, with a special adhan for Fajr. When it is off, a beep plays at the adhan and a short tone at the iqama |
| Short adhan | Off | A short adhan instead of the full one. Needs the voice option on |
| Short iqama | Off | A short iqama sound. Needs the voice option on |
| First Fajr adhan | 0 (off) | An alert sound X minutes before the real Fajr adhan |
| Jumu'a adhan | Off | Adhan sound at the Jumu'a time |
- There is no sound at Shuruq. A short sound plays at Duha time.
- In a browser, sounds can stay blocked until someone clicks the page once. Click Fullscreen mode after each start. The Android app plays the sounds by itself.
9.2 Iqama times
| Option | Default | What it does |
|---|---|---|
| Iqama minutes | 10 for each prayer | Minutes between the adhan and the iqama, from 1 to 70 |
| Duha minutes | 15 | Minutes between Shuruq and Duha time, from 12 to 30 |
| Fixed time for iqama (Fajr, Dhuhr, Asr, Isha) | Empty | The same clock time every day, for example 13:30, instead of minutes after the adhan. If the fixed time is not after the adhan, 10 minutes are used |
| Display Iqama as time | Off | Shows the clock time of the iqama instead of the minutes |
| Dhuhr = Asr − X minutes | 0 (off) | Sets the Dhuhr adhan X minutes before Asr. Click the number to change it |
9.3 Countdown and alerts before the iqama
| Option | Default | What it does |
|---|---|---|
| Iqama countdown | On | A ring with the minutes and seconds left before the iqama. The black screen, adhkar and slides also need it |
| Full-screen counter | Off | A big counter instead of the ring |
| Last-minute counter | Off | Giant seconds during the last minute |
| Counter turns red | On | Red during the last 90 seconds |
| Last-minute alert | On | A message with a sound 60 seconds before the iqama. Click the text under the option to write your own message |
| Hadith before the iqama | Off | A hadith of the Prophet ﷺ about the iqama, 33 seconds before it |
| Show Adhan screen | On | Full-screen notice for 60 seconds |
| Show Iqama screen | Off | Notice for about 10 seconds before the black screen |
| Semi-transparent windows | On | The background stays visible behind the Adhan, Iqama and Duha screens |
At home, choose "Home clock - hide Iqama times" in Options: no iqama, no countdown, only the adhan times.
10. Jumu'a, Ramadan, Eid and the Hijri date ↑
10.1 Jumu'a (Friday)
On Friday the Dhuhr cell shows "Jumu'a" with the Jumu'a time. Set it in Menu ☰ → Adjust Adhan and Iqama times.
| Option | Default | What it does |
|---|---|---|
| Jumu'a time | AUTO | AUTO uses the Dhuhr time of the day. Or type a fixed time, for example 13:15 |
| Jumu'a adhan sound | Off | Plays the adhan at the Jumu'a time |
| Show Jumu'a (landscape) | Off | A box with next Friday's Jumu'a time replaces the logo |
| Friday black screen: start | 2 | The black screen starts X minutes after the Jumu'a time (2 to 120) |
| Friday black screen: end | 30 | The black screen ends X minutes after the Jumu'a time (up to 120) |
- On Friday there is no iqama countdown, no iqama sound and no adhkar after Jumu'a.
- The Friday black screen needs the option "Black screen during prayer" (section 11).
10.2 Ramadan
- Isha +30 minutes: Menu ☰ → Adjust Adhan and Iqama times → "Add 30 minutes to Isha during Ramadan".
- Tarawih: in Menu ☰ → Adjust screen blackout, raise the Isha prayer duration, up to 180 minutes.
- Days left until Ramadan: shown with the announcements during the two months before Ramadan (Rajab and Sha'ban). Switch it in Edit Mosque announcements.
- Special verses show during the last ten nights.
10.3 Eid prayer
In Menu ☰ → Options, enable the Eid prayer and set its time. A banner "Eid prayer" with the time then shows on the screen.
| Eid | Banner shows | Default time |
|---|---|---|
| Eid al-Fitr | From 28 Ramadan until 10:00 on Eid day | 08:00 |
| Eid al-Adha | From 7 Dhul-Hijjah until 10:00 on Eid day | 07:00 |
10.4 Hijri date
The app calculates the Hijri date. Click the Hijri date on the screen to correct it: each click adds one day, from −3 to +3.
- At the start of a new Hijri year, the old year can show for about 2 days. It then corrects itself.
- At the start of a month, the exact day sometimes cannot be set. Wait about 2 days and try again.
10.5 What the app does by itself during the year
| Period | What you see |
|---|---|
| Rajab and Sha'ban | "Ramadan in ... days" before the announcements (option) |
| Ramadan | Isha +30 minutes (option) |
| 20 to 28 Ramadan | Verses about the last ten nights |
| 1 Shawwal and 10 to 13 Dhul-Hijjah | Takbir of Eid |
| 1 to 9 Dhul-Hijjah | Verses about the ten days |
| 12 to 14 of the other months | Verses about the white days |
| Sunday and Wednesday evening | A reminder of the Sunnah fast of Monday and Thursday, for 30 minutes after Maghrib and after Isha |
The fasting reminder is not shown in Ramadan, on 9 to 13 Dhul-Hijjah, or on the last 2 days of Sha'ban.
11. Black screen ↑
The screen goes black during the prayer so that nothing distracts the worshippers. Set it in Menu ☰ → Adjust screen blackout.
| Option | Default | What it does |
|---|---|---|
| Black screen during prayer | On | Black from the iqama, for the prayer duration |
| Prayer duration | Fajr 9, Dhuhr 8, Asr 8, Maghrib 7, Isha 9 minutes | Counted from the iqama. From 5 to 40 minutes; Isha up to 180 (Tarawih) |
| Clock on the black screen | On | The clock stays visible |
| Date on the black screen | Off | The date stays visible |
| Black screen after sunrise | Off | Black from 30 minutes after Shuruq until 60 minutes before Dhuhr |
| Black screen after Isha | Off | Black from 60 minutes after Isha until 60 minutes before Fajr |
| Friday start and end | 2 and 30 | See section 10.1 |
- By hand: double-click the logo to make the screen black. Click the black screen to bring the app back.
- The two long black screens (after sunrise, after Isha) save the TV when the mosque is empty.
- The prayer duration also sets when the adhkar start, even when the black screen is off.
12. Adhkar ↑
After each obligatory prayer the screen shows the adhkar for about 5 minutes. Set them in Menu ☰ → Display Adhkar.
| Option | Default | What it does |
|---|---|---|
| Adhkar after prayers | On | After Fajr, Dhuhr, Asr, Maghrib and Isha (not after Jumu'a). Each screen stays 18 seconds |
| Repeat adhkar once | Off | The list is shown twice |
| One image only, fixed 5 minutes | Off | One adhkar picture for 5 minutes instead of the list. It can be your own picture (section 16) |
| White background | Off | The white version of that picture |
| Morning adhkar after Fajr | On | Each screen stays 25 seconds |
| Evening adhkar after Asr, Maghrib or Isha | On, On, Off | Choose after which prayers they show |
- The adhkar start a few seconds after the black screen ends.
- Click the adhkar screen to stop it. Click the 5-minute picture to close it; the morning or evening adhkar then continue.
- The adhkar need the iqama countdown (section 7).
13. Slides ↑
Slides show your own texts or pictures full screen, between the prayers. Set them in Menu ☰ → Display slides.
| Option | Default | What it does |
|---|---|---|
| Enable slides | Off | Slides run after the adhkar and after Duha time, until 3 minutes before the next prayer |
| Random order | On | Slides come in a random order |
| Duration of each slide | 15 seconds | From 10 to 60 seconds |
| Duration of the main screen between slides | 12 seconds | From 10 to 60 seconds |
Click Add Slide and type one of these:
- A text. Type the character
|where you want a new line. - A picture from the internet. Paste its link, starting with
http. The screen needs internet to show it. - A picture file (ZIP version). Copy the JPG or PNG file into the
slidesfolder of the app, then type its name, for exampleposter.jpg.
Use EDIT to change a slide and X to delete it. Click a slide on the screen to stop the slides. Do not use the character " in a slide.
14. Mosque announcements ↑
Announcements scroll in the band at the bottom of the screen, in place of the hadith. Set them in Menu ☰ → Edit Mosque announcements.
- Enable the scrolling messages.
- Click Add message. The new message appears at the top of the list, active, for every day.
- Double-click the text to edit it.
- Double-click the day (DAILY) to choose when the message shows.
Each line of the list has a checkbox (active or not), an arrow to move it up, the day, the text, and X to delete.
| Day value | The message shows |
|---|---|
DAILY | Every day |
JOMOA | On Friday |
SATURDAY, SUNDAY, MONDAY, TUESDAY, WEDNESDAY, THURSDAY | On that day of the week |
A Hijri date MM/DD | On that date each year: 09/27 is 27 Ramadan, 10/01 is 1 Shawwal |
10DLHJ | From 1 to 9 Dhul-Hijjah |
- A click on the bottom band switches between the hadith and the announcements.
- Keep at least one active DAILY message. If the announcements are on and no message is active today, the band stays empty and no hadith shows.
- The app adds two reminders by itself: the Sunnah fast of Monday and Thursday, and the days left until Ramadan.
- You can type
<b>word</b>for bold text. Do not use the character".
15. Sound alerts ↑
A sound alert plays a short sound, with or without a message, some minutes before or after a prayer time. Set them in Menu ☰ → Sound alerts: enable them, then click Add.
Write each alert in this form:
Minutes.BEFORE.KEYWORD.(Your message)
Minutes.AFTER.KEYWORD.(Your message)
| Keyword | Time |
|---|---|
FAJR | Fajr |
SHRQ | Shuruq (sunrise) |
DOHR | Dhuhr |
ASSR | Asr |
MGRB | Maghrib |
ISHA | Isha |
NISF | Middle of the night |
TULT | Last third of the night |
| Example | Result |
|---|---|
15.BEFORE.FAJR.(Salam Alaykoum) | 15 minutes before Fajr: sound and message |
10.AFTER.MGRB.(Time for Adhkar) | 10 minutes after Maghrib: sound and message |
30.BEFORE.TULT.(Last third of the night) | 30 minutes before the last third of the night |
1.BEFORE.ASSR.() | 1 minute before Asr: sound only, no message |
Rules:
- Write the keywords in UPPERCASE.
- You can add several alerts. They work day and night. The message stays 12 seconds on the screen.
- Do not put a dot
.inside the message. - Only one alert plays in the same minute.
- An alert must stay between two neighbouring times of this chain: Isha → middle of the night → last third → Fajr → Shuruq → Dhuhr → Asr → Maghrib → Isha. For example,
10.AFTER.MGRBworks only if Isha comes more than 10 minutes after Maghrib. - The sound is short and the same for all alerts. For messages without sound, mute the TV.
- Test sound here in the window plays the alert sound.
16. Backgrounds and your own pictures ↑
16.1 Backgrounds
The app has 40 backgrounds, numbered 0 to 39. Choose them in Menu ☰ → Change screen background.
| Mode | What it does |
|---|---|
| Manual | Keeps the background you choose with ◀ ▶ |
| At every prayer | One background for each of the six times. It changes 1 minute before the adhan. Click a prayer to change its number |
| Daily | One background for each day of the week. It changes at midnight |
| Daily at random | Each day the app picks one background from your list of numbers. Click the numbers to change the list |
- Shortcut: click the Fajr name for the next background, or the Fajr time for the previous one.
- In portrait, the position of the boxes changes with the background. Try several to find the layout you like.
- Background 38 is a light one with dark text.
16.2 Your own pictures
Menu ☰ → Manage personal files → enable → upload the image.
| Picture | Where it shows |
|---|---|
| Background image | Behind the app, in place of the 40 backgrounds. The background buttons are then switched off |
| Adhkar image | On the adhkar screen, for 5 minutes after each prayer. Also enable "One image only, fixed 5 minutes" (section 12) |
- Use
.jpgor.pngfiles of 1 MB at most. - All your pictures share about 5 MB. The window shows how much is used ("Storage: x%").
- X deletes a picture.
- Big pictures can slow down weak devices.
- Personal files may not work on some old Android versions.
17. Display options ↑
The look of the clock, the prayer table and the texts is set in Menu ☰ → Options.
17.1 Clock and numbers
| Option | Default | What it does |
|---|---|---|
| 24-hour display | Off | For the clock and all the times. Off means 12-hour with AM and PM |
| Leading zero for AM/PM | Off | Shows 04:35 AM instead of 4:35 AM |
| Full clock (with seconds) | Off | Same as a click on the clock |
| Arabic numerals, or the numerals of the chosen language | Off | For the clock, times, dates, counters and temperatures |
| Adjust main clock | 0 | Adds or removes hours when the device time is wrong (section 8.7) |
17.2 Layout
| Option | Default | What it does |
|---|---|---|
| Center prayer names, landscape | On | Prayer names in the middle of the cells |
| Center prayer names, portrait | Off | Prayer names in the middle of the rows |
| 5 cells only, landscape | Off | Shuruq moves to a box at the top-right, with the Duha time |
| Bigger next-prayer counter, landscape | Off | Enlarges the box that counts down to the next prayer |
| Date on the right, mosque name on the left, landscape | Off | Same as a click on the mosque name |
| Jumu'a time in place of the logo, landscape | Off | Shows next Friday's Jumu'a time |
| Dim past prayers | Off | Prayers of the day that have passed are faded |
| Shade background behind prayer times | On | Shapes behind the cells, for easier reading |
| Night times | On | Middle of the night, last third, tomorrow's Fajr |
| Home clock - hide Iqama times | Off | For home use: no iqama, no countdown |
| Palestine flag | On | Flag at the top-left |
| Internet check | Off | Green or red star, checked every 30 minutes |
In landscape you can also enlarge the prayer and iqama times.
17.3 Vertical screen
A screen that is taller than wide gets the portrait layout by itself. For a landscape TV fixed vertically on the wall, use Force vertical display (in Options): choose rotate left ↶ or rotate right ↷. The app restarts. The TV-remote pointer also works on the rotated screen.
17.4 Fonts
Open "Adjust application UI fonts" in Options.
| Font for | Default | Used for |
|---|---|---|
| Texts | Amiri | Prayer names and interface texts. 9 fonts to choose from |
| Times | FreeSerifBold | Prayer times. 6 fonts |
| Clock | FreeSerifBold | The main clock. 6 fonts |
| Adhkar | Taha | Adhkar, slides, hadith, announcements, Eid banner. 3 fonts |
Some languages use their own script and font (for example Bengali, Hindi, Chinese, Thai, Korean, Japanese). The text and adhkar font choices are hidden for them.
18. Languages ↑
The app speaks 48 languages. Open Menu ☰ and click your language code at the top; the app restarts in that language.
| Code | Language | Code | Language | Code | Language | Code | Language |
|---|---|---|---|---|---|---|---|
| AR | Arabic | DA | Danish | KK | Kazakh | SI | Sinhala |
| BN | Bengali | DE | German | KM | Shikomoro | SO | Somali |
| PA | Punjabi | EN | English | KO | Korean | SQ | Albanian |
| UR | Urdu | ES | Spanish | KY | Kyrgyz | SV | Swedish |
| HI | Hindi | FA | Persian | MS | Malay | SW | Swahili |
| AF | Dari | FP | Filipino | NL | Dutch | TA | Tamil |
| PS | Pashto | FR | French | NO | Norwegian | TG | Tajik |
| KU | Kurdish | HA | Hausa | OM | Oromo | TH | Thai |
| AM | Amharic | ID | Indonesian | PT | Portuguese | TK | Turkmen |
| AZ | Azerbaijani | IT | Italian | RU | Russian | TR | Turkish |
| BG | Bulgarian | JA | Japanese | UG | Uyghur | UK | Ukrainian |
| BS | Bosnian | ZH | Chinese | UZ | Uzbek | WO | Wolof |
- Language of the Qur'an verses: it is a separate choice. Menu ☰ → Options → choose the language of the verses (since version 9.63). You can keep the verses in Arabic and the interface in your language.
- Arabic, Urdu, Kurdish, Dari, Punjabi, Pashto, Persian and Uyghur are shown from right to left.
- A language is missing or a translation is wrong? Tell the Tawkit AI assistant on the website. The author adds new languages on request.
19. Weather ↑
The screen shows the temperature now (°C) with an icon; in landscape it also shows today's highest and lowest. The app starts with the position of Makkah, so set your own position first.
| Option | Default | What it does |
|---|---|---|
| Weather | On | Shows the temperature and the icon |
| Weather next to prayer times | Off | Shows the forecast for the hour of each prayer, in its cell |
| Position by browser | — | The device gives its position. Allow the location when the browser asks |
| Position by hand | Makkah | Type latitude,longitude, for example 48.8566,2.3522 for Paris |
- The forecast comes from Open-Meteo.com. The app downloads it when it starts and every night at 00:01.
- The app keeps 7 days of forecast, so internet about once a week is enough.
- The forecast is saved on the device, so it stays after a restart, even without internet.
- A dash
-in place of the temperature means: no position, or no data yet.
20. Shortcuts, test mode and TV remote ↑
20.1 Shortcuts on the screen
| Click on | Effect |
|---|---|
| Clock | Small clock or full clock with seconds |
| Bottom band | Hadith or scrolling announcements |
| Qur'an verse | A new verse |
| Iqama of Isha | A new hadith |
| Fajr name / Fajr time | Next / previous background |
| Next-prayer time | Prayer names in the middle |
| Next-prayer text (landscape) | Bigger next-prayer counter |
| Hijri date | Corrects the Hijri date by one day (from −3 to +3) |
| Mosque name (landscape) | Date at the top-right, mosque name on the left |
| App name at the bottom-left (landscape) | 5 or 6 prayer cells |
| Palestine flag | Restarts the app |
| Black screen, Adhan / Iqama / Duha screen, adhkar, slides, big counter | Closes or stops it |
| Double-click on | Effect |
|---|---|
| Logo | Black screen now. Click the black screen to remove it |
| Iqama of Fajr | Iqama shown as a clock time or as minutes |
| Iqama of Maghrib | Checks the internet now |
| Isha time (landscape) | Jumu'a box on or off |
| App name and version at the top of the menu | Restarts the app |
| Several clicks | Effect |
|---|---|
| 7 clicks on the weather area | Erases all settings and restarts the app. Useful when the app is blocked by bad settings |
| 3 clicks on the tomorrow box (tomorrow's Fajr time) | Test mode on or off |
20.2 Test mode
Test mode lets you check your settings without waiting for a prayer. Click 3 times on the tomorrow box to turn it on; the verses are hidden while it is on. Click 3 times again to turn it off.
| In test mode | Starts |
|---|---|
| 3 clicks on the Dhuhr time | Adhkar after prayer |
| 3 clicks on the Dhuhr name | Slides |
| 3 clicks on the Asr time | Morning adhkar |
| 3 clicks on the Asr iqama | Evening adhkar |
| 3 double-clicks on the Maghrib name | A 2-minute test countdown, then the normal iqama sequence with a 1-minute prayer |
20.3 TV remote and keyboard
- Press an arrow or OK: a pointer appears on the screen.
- The arrows move the pointer. At the edge of the screen it comes back on the other side.
- OK is a click. OK twice quickly is a double-click.
- The pointer hides after 5 seconds without a key.
- In the menu and in the windows, use the ▲ ▼ buttons to scroll and ✖ to close.
- A computer keyboard works the same way: arrows and Enter.
21. Save, copy and reset your settings ↑
The app saves every change at once, on the device itself. No account is needed.
21.1 What is saved, and where
- Saved: all options, announcements, slides, sound alerts, imported prayer times and your pictures.
- The settings belong to one browser (or one app) on one device. Another browser, another device or the web version starts with its own settings.
- A private or incognito window keeps nothing.
- After you change a setting of the device (not of the app), reload the app: Menu ☰ → Reload application.
21.2 Export: make a backup
Menu ☰ → Export/Import settings → Export settings. Internet is needed. The app gives you a link to download your settings file. Keep this file.
The file holds the options, the announcements, the slides and the yearly prayer times. Your pictures are not in it.
21.3 Import
| Way | Steps |
|---|---|
| Import by ID | Upload the file on settings.tawkit.net; it gives an ID like XXXX-XXXX. On the screen: Export/Import settings → Import by ID → type the ID. Needs internet |
| Import local file | Export/Import settings → Import local file → choose the file on the device. Works without internet, but not on some Android devices |
- The app restarts after an import.
- Each part found in the file (options, announcements, slides, times) replaces the current one. Parts that are not in the file stay as they are.
21.4 The same settings on several screens
- Set up one screen completely.
- Export its settings and download the file.
- Upload the file on settings.tawkit.net to get an ID.
- On each other screen, use Import by ID.
21.5 Edit the settings file
Open the file with Notepad. Change only the text between the quotes " ", never add other quotes, and keep the file under 90 KB. The page settings.tawkit.net/help.html explains every setting of the file.
21.6 Reset everything
Click 7 times on the weather area. The app erases all settings, announcements, slides, imported times and pictures, then restarts as new (Arabic interface, Makkah). Export first if you want to keep your settings. Use the reset when the app is blocked after a bad import or bad settings.
22. Extras of the ZIP version ↑
With the ZIP version you can replace files in the app folder: your own adhan, pictures, adhkar or translations. This is allowed for your home and your mosque only (section 25).
| You want to change | Where | How |
|---|---|---|
| Adhan and iqama sounds | Folder audio | Replace the MP3 and keep its name: audio_fajr.mp3 (Fajr adhan), audio_azan.mp3 (other adhans), short_azan.mp3, short_iqama.mp3 |
| Backgrounds | Folder themes | HR-0.jpg to HR-39.jpg for landscape, VR-0.jpg to VR-39.jpg for portrait |
| Slide pictures | Folder slides | Copy your JPG or PNG there, then add a slide with the file name (section 13) |
| Adhkar texts | Folder azkar | azkar.js (after prayers), azkar-sabah.js (morning), azkar-masaa.js (evening) |
| Qur'an verses | Folder ayats | One file per language |
| Hadiths | File ahadith.js | — |
| Interface texts | Folder languages | One file per language, for example lang-EN.js |
| Fonts | Folder font | Replace the font files |
| Logo | File logo.png | Replace the picture |
| First settings of a new installation | File settings-defaults.js | Explained on settings.tawkit.net/help.html |
Rules for a safe change:
- Keep a copy of the original file.
- Keep the same file name.
- For text files, use a plain text editor such as Notepad and save in UTF-8, so the Arabic text stays correct.
- Change only the words. Keep the quotes, commas and the shape of the file.
- In the adhkar files, a line with
-----ends one screen, and the character|starts a new line. - Portrait screens skip long verses and long hadiths. Keep several short ones in the files.
- Restart the app after a change.
Timetable file of the mosque, with iqama times
Some mosques have a yearly table with the adhan and the iqama of every day, and two Jumu'a times. The ZIP version can read it from the file wcsv.js in the app folder.
- Fill
wcsv.js: one line per day, with the values separated by commas. - Enable the option "prayer and Iqama times file" in Menu ☰ → Adjust Adhan and Iqama times. It is an option for advanced users.
- Restart the app.
| Value number in the line | Content |
|---|---|
| 1 and 2 | Free. Put the date here as MM-DD (for example 03-15), and the weekday if you like |
| 3, 4 | Fajr adhan, Fajr iqama |
| 5 | Shuruq |
| 6, 7 | Dhuhr adhan, Dhuhr iqama |
| 8, 9 | Asr adhan, Asr iqama |
| 10, 11 | Maghrib adhan, Maghrib iqama |
| 12, 13 | Isha adhan, Isha iqama |
| 14, 15 | First Jumu'a, second Jumu'a |
When this file is in use:
- The iqama shows as a clock time.
- These options are ignored: adhan minutes −/+, fixed iqama time, Dhuhr = Asr − X.
- These options still work: summer time, +1 or −1 hour, Isha +30 minutes in Ramadan.
- Jumu'a on AUTO takes the first Jumu'a of the file. The Jumu'a box in landscape also shows the second Jumu'a.
23. Troubleshooting ↑
Find your problem in the left column. If the app is blocked and nothing else works, 7 clicks on the weather area reset it.
Installing and starting
| Problem | What to do |
|---|---|
| The app does not open on an old Android device | Install the old version 9.61 from the download page |
| The app cannot be installed on the device | Open offline.tawkit.net in the browser of the device |
| The app does not start by itself after a restart | Tick AUTO-START in the menu (green). Android 9 to 13 works best; newer versions can block auto-start. Amazon Fire TV does not allow it |
The screen shows 33333333333 and looks broken | The Chrome browser of the device is too old. Use Opera (version 88 or newer, APK on the website) or Firefox |
| No sound | Click the page once: Menu ☰ → Fullscreen mode. Check the volume of the TV. The Android app plays sounds by itself |
| The web version still shows an old version | Clear the cache of the browser |
Clock and prayer times
| Problem | What to do |
|---|---|
| The clock is one hour wrong | Correct the time zone and summer time in the settings of the device, then reload the app (section 8.7) |
| All prayer times are one hour wrong | Check "add one hour during summer" and +1 / −1 hour (section 8.6) |
| The times differ from the mosque by a few minutes | Move each adhan with − and + (section 8.2), or import the mosque timetable (section 8.3) |
| The time is lost after a power cut | The device has no real-time clock. Switch Wi-Fi on for a moment |
| The date or the times do not change | Check the date of the device. In an imported timetable, that day may be missing |
| The Hijri date is one day off | Click the Hijri date to correct it (section 10.4) |
| My city is not in the list | See section 8.4 |
Import and settings
| Problem | What to do |
|---|---|
| "Invalid Imported Times ! Settings File Used." | The imported year is not complete. Correct the file (365 or 366 lines) and import again |
| The settings file is refused | Keep it under 90 KB, edit it with Notepad, and use quotes only around the values |
| "Import local file" does nothing | Use Import by ID |
| The app is blocked after an import or a bad setting | 7 clicks on the weather area |
| The settings are lost | You opened another browser or another address, used a private window, or the browser data was cleared. Import your backup |
| A picture cannot be uploaded ("Storage quota exceeded") | Use pictures under 1 MB and delete old ones |
Display
| Problem | What to do |
|---|---|
| No black screen, adhkar or slides after the prayer | The iqama countdown is off, the home mode is on, or it is Friday |
| The bottom band is empty | Announcements are on but no message is active today. Add a DAILY message, or switch the announcements off |
The weather shows - | Set your position (section 19). Internet is needed |
| The star is red | No internet. This matters only for weather, export and import |
| The verse box shows an error with "ayats" | ZIP version: the verses file you edited has too few short verses |
Still stuck? Ask the Tawkit AI assistant on the website, or contact a volunteer of your country (section 25).
24. Known issues in version 9.63 ↑
These small problems exist in 9.63. Each one has a simple way around it.
| What you may see | What to do |
|---|---|
| In the fonts window, a click on the name "STC" (clock) or "FODA" (adhkar) selects SULTAN | Click the round button, not the name |
| Black screen settings: pressing − when the Dhuhr duration shows 5 keeps lowering the real value. The black screen of Dhuhr can then fail | Do not press − at 5. If it happened, press + until the value you want shows |
| Black screen settings: + on the Maghrib duration is not saved at once | After it, press + then − on another prayer's duration. This saves everything |
| After a restart between the adhan and the iqama of Dhuhr, Asr or Maghrib, the black screen of that prayer has the wrong length | Do not restart the app during a countdown |
| Announcements are on but none is active today: the hadith is hidden too | Keep at least one active DAILY message |
| "Ramadan in X days" stays on the screen after Sha'ban ends | Restart the app at the start of Ramadan |
| Changing 24-hour display, fonts, numerals or the main clock, or pressing Fullscreen, during the minute of an adhan plays the adhan again and restarts the countdown | Change settings outside the adhan minute |
| On a slow device, or when the browser window is hidden or minimized, an event can be missed or the countdown can run slow | Keep Tawkit visible in front. Avoid very large pictures |
| The star stays green although the internet is cut | Double-click the Maghrib iqama to check again |
25. Volunteers, rules of use and contact ↑
25.1 Volunteers
Volunteers in many countries install and set up the app in mosques and homes, for free or for a fee agreed with the mosque's administration.
- Find a volunteer: on the volunteers page, by country, with a WhatsApp number.
- Become a volunteer: fill in the "Become a volunteer" form with your name, city, country and WhatsApp number.
25.2 Terms of use
- Tawkit is free. It is not open source and it may not be sold.
- You may change it for personal use only: your home and your mosque.
- Do not remove or change the name of the app or the name of the author.
- Do not distribute a changed version.
- You may install the app for people for free, or for a fee agreed with the mosque's administration.
- Developers may use the prayer-times files of Tawkit (folder
data) in their own apps.
25.3 Selling devices with the app
Selling a device with Tawkit installed is allowed, with a profit of at most 50% of the price of the device and its accessories, if the seller:
- tells the buyer that the app is free,
- gives free support to the buyer, for the app and for the device,
- does not change or hide the name of the app.
25.4 Updates
The author offers the app for free and develops it in his free time. New releases and important updates are announced by the newsletter. Subscribe on the updates page.
25.5 Contact and suggestions
- The author receives too many emails to answer them, so there is no contact form and no email address. The Tawkit AI assistant on the website is the way to reach him.
- Tell the assistant your request for a new city or a new language; it forwards the request to the author.
- Suggestions are welcome. The author adds them step by step to future releases when he finds them useful.
- The project has no team and is not open to business collaborations. What helps most is volunteers who install the app for people.
25.6 Internet and privacy
No account is needed. Your settings, messages and pictures stay on your device. The app uses the internet only for these:
| Service | Used for | What is sent |
|---|---|---|
| Open-Meteo.com | Weather | The position you set |
| tawkit.net | Internet check (the star) | Nothing |
| settings.tawkit.net | Export, and import by ID | Your settings file, or the ID |
| Picture links in slides | Showing the picture | Nothing |
26. Glossary ↑
| Word | Meaning | Other spelling on screen |
|---|---|---|
| Adhan | Call to prayer | Azan, Athan |
| Iqama | Call to start the prayer in congregation | — |
| Fajr, Dhuhr, Asr, Maghrib, Isha | The five daily prayers | Dohr, Assr |
| Shuruq | Sunrise. Not a prayer | Shoruq |
| Duha | Forenoon prayer time, after sunrise | Doha |
| Jumu'a | Friday prayer, with the khutbah (sermon) | Jomoa |
| Adhkar | Words of remembrance, said after prayers, in the morning and in the evening | Azkar |
| Hijri | The Islamic lunar calendar | — |
| Middle of the night | Half of the time between Maghrib and the next Fajr | NISF |
| Last third of the night | The last third of that time | TULT |
| Tarawih | Night prayers in Ramadan | — |
| Takbir | Glorification said during the days of Eid | — |
| White days | The 13th, 14th and 15th of each Hijri month, days of recommended fasting | — |
| Waqf | A gift given for the sake of Allah; it cannot be sold | — |
| APK | The file that installs an app on Android | — |
| RTC | Real-time clock: a small part that keeps the time when the power is off | — |
Didn't find your answer?
Ask the Tawkit AI assistant in your language. Ask your full question at once, with all the details.