Story · Building Sajdah
The journey so far: building Sajdah for Apple TV
In January 2026 I started a small side project: a way to play the Quran on the biggest screen in the house. Nine months later, Sajdah is a Quran, prayer and remembrance companion for Apple TV. This is the story so far.
Why a Quran app for the TV
A phone is personal. A TV belongs to the whole room. In many Muslim homes, Quran recitation plays in the background for hours, and the TV is often the best speaker and the biggest screen in the house. I wanted a way to fill the living room with recitation and let everyone follow the verses together, without passing a phone around.
The first commit landed on 27 January 2026, under the name QuraanTV. It already had a reciter picker, a player and verse timing. From the start I wanted Quran listening to be free and ad-free, something I hoped could be a small sadaqah jariyah: a good deed that keeps giving after the work is done.
From QuraanTV to Sajdah
QuraanTV described the first version well: Quran recitation on a TV. Within weeks the app also had prayer times, the Athan and a Qibla compass, and the name felt too narrow. Sajdah, the prostration in prayer, points at the whole daily rhythm the app now serves: prayer, Quran and remembrance. You will still see the shorter spelling, Sajda, in a few places, including the address of the app's page. The code is still called QuraanTV, because renaming it would change nothing for anyone who uses the app.
The first months: getting the basics right on a TV
February 2026 was about foundations: hundreds of reciters, verse sync, prayer times with a Qibla compass, the Athan at prayer time, and an interface in many languages, including right-to-left Arabic. At the end of the month came Quran radio and live Islamic TV. Today Sajdah speaks 11 languages.
Then came App Review, which taught me more than I expected:
- A QR code in Settings that pointed to a donation page was not allowed inside the app (guideline 3.1.1), even though the same link is fine on a website.
- An app's first subscription has to be submitted together with a new app version.
- tvOS apps need a privacy policy URL too.
- Rejection messages can be vague, so each round needs some detective work.
I turned several of these lessons into validation checks for the open-source App Store Connect CLI, so the next submission, mine or anyone else's, catches them before review does.
From player to daily companion
The early app was a good Quran player, but people mostly opened it around prayer times. So in March, with version 1.3.0, the home screen changed from a grid of reciters to a Today tab: the next prayer with a live countdown, the Hijri and Gregorian dates, a verse of the day, and one press to continue the last recitation.
Morning and evening adhkar came with it, as a full-screen counter you press with the Siri Remote. In April a hadith of the day followed, drawn from Imam an-Nawawi's forty hadith, together with an ambient mode that shows one calm verse at a time for all-day listening.
Onboarding, four times
No part of Sajdah has been rewritten as often as the first launch. The first version asked people to pick an accent color, and on a TV that step trapped the focus: the Siri Remote could not reach the Start button. I removed onboarding, brought it back as a single screen, removed it again, and in 1.5.0 it returns in its simplest form. You choose your language, pick a reciter, and hear Al-Fatiha in their voice.
The lesson: on a TV, every extra step costs more than on a phone, and the first thing people want is to hear the Quran.
The household prayer clock
Prayer times on a phone are personal. On a TV, they belong to everyone in the room. In August, Sajdah gained Prayer Room: six full-screen displays that turn the TV into a prayer clock for the home, switched with the remote's up and down buttons. The screen stays awake while Prayer Room is open.
The TV also changes how the Athan works. Apple TV has no notification banners to lean on, so the Athan is played by the app itself. That made reliability the real feature. In 1.5.0, every Athan pauses whatever is playing first, and prayer times are calculated in your location's time zone rather than the device's.
Reading along, word by word
From the first version, Sajdah highlighted the verse being recited. The idea I kept coming back to was a step further: highlight the word. That needs precise word timings for each specific recording, so 1.5.0 bundles timings for selected Hafs recordings and matches them to the exact audio. Where timings are missing or unreliable, the app falls back to verse tracking rather than lighting up the wrong word.
The player was redesigned around reading at the same time: a steady reading panel, the current word in gold, only four controls, and one More menu for everything else. Six Quran fonts arrived too, with Uthmanic free for everyone. The 1.5.0 release notes cover all of it.
None of this would exist without generous open data: Al Quran Cloud for text and translations, MP3Quran for recitations, Qur'anic Universal Audio for word timings, and Aladhan for prayer times.
What the TV taught me
- Design for the remote, not the pointer. Clicking around in the simulator hides focus traps. Every flow has to work with four directions and one Select button, tested on a real Siri Remote.
- Give people time. Player controls that hid after five seconds felt rushed. People read, step away and talk to each other. Forty seconds feels right in a living room.
- Right-to-left is more than a mirrored layout. The remote reports physical left and right, so in Arabic the app has to swap them itself. Arrows have to mirror, and letter-spacing breaks joined Arabic script.
- Never fall back to English quietly. If a translation is missing, hiding the line is better than English inside an Arabic or Swedish screen.
- Time zones are part of prayer times. Times have to be calculated in the place you pray, not the zone your TV happens to use.
- The screen saver is part of the design. On tvOS it can cover your app mid-recitation, so Sajdah keeps the screen awake while the player or Prayer Room is open.
- Show the moment, not the feature list. App Store screenshots that said "Fill your home with Quran" said more than a count of reciters, and on a TV the text has to be readable from the couch.
- Small numbers mislead. With a young app, a handful of people can swing any chart. I learned to wait for enough data and to keep my own test devices out of it.
Free at the core
One decision has not changed since the first commit: listening to the Quran in Sajdah is free, with every reciter, and there are no ads. Sajdah Premium is an optional subscription for the extras, such as live TV and radio, prayer times with the Athan, Prayer Room, Quran fonts and memorization tools. It is what keeps the app growing.
What comes next
A few ideas I am exploring, with no promises on dates:
- Daily rituals: gentle routines such as Surah Al-Kahf on Friday and Quran before bed.
- Memorization sessions: guided repetition for learning a passage together as a family.
- Ramadan mode: an iftar countdown and a daily reading plan for the holy month.
Sajdah has been shaped by the people who use it. If there is something you would love to see, tell me. Every suggestion gets read.