Afnon · أفنون

An Android TV home screen built around the prayer day.

Arabic first (RTL) and English · Offline prayer times for 245 cities · 16 adhan voices · Qibla · 19 Quran radio stations and reciters

⬇ Download the APK · Releases · Try it in your browser

إِنَّ الصَّلَاةَ كَانَتْ عَلَى الْمُؤْمِنِينَ كِتَابًا مَّوْقُوتًا · النساء ١٠٣

Indeed, prayer has been decreed upon the believers at fixed times. (An-Nisa 4:103)

Afnon replaces the stock launcher on an Android TV with one quiet screen. The next prayer and a live countdown sit inside a mihrab arch. The day's six times run across the top, your favourite apps sit below, and the call to prayer comes to the TV by itself. Built and tested on a TCL 55P7K (Google TV, Android 12), driven only by the remote's D-pad, and also run on a Super General (CVTE) and a Xiaomi Mi TV (see the notes below).

How it started

Afnon started from cleanyourtv:

1. Debloat. cleanyourtv's prompt cleared the TCL's ads and bloat, reversibly, with a backup and a restore script.
2. Launcher. cleanyourtv's Apple TV-style home took over from the stock one.
3. Design. A new direction, Mihrab, was designed around the prayer day: lapis and gold, with an arch for the next prayer.
4. Build. Claude Code built it on the real TV over ADB, one screen at a time, checking each with a screenshot.

---

Screens

Home (English). The clock follows the TV's 12/24-hour setting. Gregorian and Hijri dates, six prayer times with the next one marked, favourites and more apps.	Today's prayers. Every time with its countdown, an adhan on/off bell per prayer, and the Qibla bearing from your city.
Quran Radio. A header pill opens the station card. The bars follow the live recitation.	The call. At prayer time the screen comes up over whatever is playing and the adhan plays by itself.
Reminder. A card a few minutes before the prayer (a banner when another app is open).	Screensaver. A dim, drifting arch with the clock and the next prayer, plus the radio when it plays.
Friday. Jumu'ah replaces Dhuhr, with a Surat al-Kahf reminder.	Ramadan. Iftar and suhoor take over the countdown.
All apps. Every launchable app. Hold OK to put one in favourites.	Settings on the TV. Prayer times, reminders and adhan, radio, display and language.

Features

• Prayer times, fully offline. Calculated on the TV with adhan-java. It ships with 245 cities in 45 countries across the Arab world, Asia, Europe, the Americas, Africa and Oceania, picked by region, then country, then city. Each city starts on the method and Asr school its mosques use; you can still choose the calculation method (Egyptian, Umm al-Qura, MWL, Karachi, Oman's Ministry of Awqaf, Morocco's Ministry of Habous and more), the Asr school (Shafi'i or Hanafi) and a Hijri date offset. Oman's cities start on the Ministry of Awqaf's method, fitted to its published timetable so every prayer is within a minute or two of it (see Method.OMAN_AWQAF). Morocco's start on the Ministry of Habous's rules, recovered from its timetables (see Habous); Morocco has kept GMT all year since 20 September 2026, so a TV with older time-zone data needs a GMT+0 zone until its firmware updates. The Hijri date and Ramadan mode always use the Umm al-Qura calendar, so where local moon sighting differs (the United States, for one) set the offset.
• Qibla and room direction. The Qibla bearing from your city, and a one-time "which way does the TV face" setting, so the screen can say "Qibla is behind you".
• The adhan. 16 voices to choose from, plus a separate Fajr adhan. If the TV is muted or at zero, the volume comes up for the adhan and goes back afterwards.
• Reminders. A card on Home, or a banner over other apps, 5 to 30 minutes before each prayer. It can also say «اقترب موعد صلاة …», and when a prayer's adhan is off, «حان الآن موعد صلاة …» as its time begins (both lower whatever is playing for a moment instead of pausing it; see tools/fetch-announce.sh below).
• Friday and Ramadan. Both modes switch themselves on from the date.
• Quran Radio. إذاعة القرآن الكريم from Cairo (98.2 FM) by default, streamed live. Station, on Home's radio card or in Settings → Radio, picks another:
  • Quran radios: Nablus, Shabab FM Quran (Nablus), Qatar 1 and 2, Oman, Jordan, and from the Saudi Broadcasting Authority (Saudi Radio+) its Holy Quran Radio and Nida Al-Islam Radio.
  • Ten reciters' 24/7 channels from mp3quran.net (Alafasy, Abdul Basit, Al-Minshawi, Al-Husary, Al-Muaiqly, Al-Ghamdi, Al-Sudais, Al-Dosari, Al-Qatami, Mohammad Rashad Al-Shareef).
  • Live level bars, from the audio itself.
  • It pauses for the adhan and resumes after.

Privacy

Afnon has no accounts, no analytics and no ads. The radio is the only feature that uses the internet, and it connects only to the chosen station's stream, one at a time: stream.radiojar.com (Cairo), quran-radio.org (Nablus), streaming.zaytonatube.com (Shabab FM), live.kwikmotion.com (Qatar and the Saudi Quran stations), jrtv-live.ercdn.net (Jordan), partwota.cdn.mgmlcdn.com (Oman) or backup.qurango.net (the reciters). The list is in Radio.STATIONS. Afnon makes no other network requests, and its network security config allows plain HTTP for the Cairo stream only. Your city and settings stay on the TV.

The web preview is a separate static site, not the app. It loads nothing from other sites except the station's stream when you press Play, and keeps your settings in your browser.

Permission	Why
INTERNET, WAKE_LOCK	The radio stream, kept playing with the screen off
RECORD_AUDIO	Required by Android's Visualizer, to read Afnon's own player for the level bars. It does not use the microphone.
WRITE_SECURE_SETTINGS	Turns the TV's sleep timer off while the radio plays, and puts it back after. Turns Afnon's own remote buttons service back on after a force-stop. On TCL, also writes the remote button mappings (see TCL notes)
ACCESS_FINE_LOCATION	Android 9+ hides the Wi-Fi name without it; Home shows the name. Afnon never reads the TV's location
Accessibility service	Remote button mapping (see RemoteKeys.java)

Install

Easiest: from your phone

No computer needed. Install afnon-installer.apk on an Android phone (8 or later) on the same Wi-Fi as the TV, open it and follow the screens:

1. Prepare. How to turn on Developer options and USB debugging (or Wireless debugging) on the TV.
2. Connect. TVs on the Wi-Fi appear by themselves (mDNS for classic debugging, Wireless debugging's random port and the pairing port, and a sweep for port 5555); or type the address, with or without a port. Then accept "Allow USB debugging?" on the TV, or type the six-digit pairing code it shows.
3. Install. The latest afnon.apk from this repo's releases (skipped when the TV already has it), then the steps in tools/setup-steps.txt at that release's tag, the same file tools/install.sh runs.
4. Make it yours. The city and prayer settings, the four favourites (with the TV's own app icons) and a cleanup: ads, tracking and preloaded apps, turned off (never uninstalled) from tools/clean-catalog.tsv, with an undo.

The installer keeps no copies of what can change: the APK, the setup steps and the cleanup list come from GitHub, and the cities and apps from Afnon on the TV (SetupProvider), so a new Afnon release needs no new installer. Source in installer/ (plain Java, an ADB client library and Conscrypt for TLS).

Quick: the APK

Download afnon.apk from the latest release, then:

export TV=192.168.1.50:5555
adb connect $TV
adb -s $TV install -r afnon.apk
adb -s $TV shell cmd package set-home-activity tv.afnon.home/.MainActivity
adb -s $TV shell settings put secure screensaver_components tv.afnon.home/.AfnonDream
adb -s $TV shell pm grant tv.afnon.home android.permission.RECORD_AUDIO
adb -s $TV shell pm grant tv.afnon.home android.permission.WRITE_SECURE_SETTINGS
adb -s $TV shell pm grant tv.afnon.home android.permission.ACCESS_FINE_LOCATION

Then turn on Afnon remote buttons in the TV's Settings → Accessibility. The APK includes the adhan recordings.

If Home still opens the stock launcher (stock Android TV and Google TV keep theirs ahead of any app), use the phone installer or tools/install.sh: they turn the stock launcher off behind a safety switch that turns it back on if Afnon doesn't come up, and the installer's cleanup can undo it.

From source

You need a computer with adb, JDK 17, the Android SDK (platform 34), and the TV with Developer options → USB / Network debugging on.

git clone https://github.com/egyjs/afnon-android-tv-launcher.git
cd afnon-android-tv-launcher
export TV=192.168.1.50:5555          # your TV's address
adb connect $TV                      # accept the prompt on the TV
bash tools/install.sh                # fetches the adhans, builds, installs, sets Afnon as home

install.sh runs tools/fetch-adhans.sh the first time. That script downloads the 16 recordings from abodehq/Athan-MP3 (and two from meypod/audio_files). They aren't in this repo because those collections have no licence.

The spoken reminder and «حان الآن موعد صلاة …» are 12 short clips made on your machine: install.sh runs tools/fetch-announce.sh the first time, which reads tools/announce-lines.txt with a Microsoft neural Arabic voice through edge-tts (pip install edge-tts; VOICE= picks another) into app/src/main/assets/announce/. They aren't in this repo; the release APK includes them. Without them those two stay silent and everything else works.

Close network debugging when you're done. Port 5555 is plain text, and on some firmware any device on your network can get a shell through it. Switch USB debugging and Network debugging off in Developer options, revoke the USB debugging authorisations, reboot, and check that nc -vz <tv-ip> 5555 fails.

Everyday changes

I want to…	Do this
Change favourites	All apps → hold OK on an app → Put in favourites instead of…
Change city, method, adhan voice, radio options	The remote's Settings button, or the gear on Home
Point a remote button at another app	Edit the table at the top of RemoteKeys.java, then bash tools/install.sh
Change colours or the star pattern	afnon-mihrab/tokens.json (and tokens.night.json for night mode), then npm run tokens in site/; Ui.starLattice
Disable a stock app	bash tools/disable.sh <package> (reversible; logged to state/disabled.log)
Re-enable an app	bash tools/enable.sh <package>, or on the TV: Settings → Apps → See all apps → Show system apps → the app → Enable
Go back to stock	bash tools/restore.sh, then reboot. Re-enables everything in the log, restores home, screensaver and sleep timer, and uninstalls Afnon.

Trying things without waiting for a prayer

adb shell am start -n tv.afnon.home/.MainActivity --es test friday    # or ramadan, now (back to today)
adb shell am start -n tv.afnon.home/.MainActivity --es test reminder  # Home's reminder card, spoken
adb shell am start -n tv.afnon.home/.MainActivity --es test call      # the call screen, 8 s later
adb shell am start -n tv.afnon.home/.MainActivity --es test banner    # the banner and its voice, 8 s later (open another app)
adb shell am start -n tv.afnon.home/.MainActivity --es test announce  # «حان الآن موعد صلاة …», 8 s later
adb shell am start -n tv.afnon.home/.MainActivity --es test radio     # radio on / off
adb shell am start -n tv.afnon.home/.MainActivity --es station nablus # pick a station (ids in Radio.STATIONS)
bash tools/shot.sh home                                               # screenshot to state/shots/

TCL notes

Some of this is TCL-specific. Each piece fails quietly on other brands:

• Audio Only (screen off while listening) asks TCL Settings to show its own countdown dialog (com.tcl.settings.SHOW_WINDOW, Type=AudioOnly). Elsewhere Afnon falls back to a black, dimmed screen.
• TCL remotes send Settings as KEYCODE_NOTIFICATION and the browser key as code 4159.
• The remote buttons go through TCL's own button remapping (TclKeys.java), so the accessibility service doesn't filter keys and holding Volume keeps changing it. Elsewhere the service filters keys itself.
• install.sh grants TCL's APP_AUTO_START so the remote buttons service survives a reboot.
• Android's screen_brightness setting does nothing on this TV, because TCL drives the backlight itself.

Other brands (CVTE)

Tested on one Super General TV (CVTE board, Android 9). CVTE makes the boards in many budget TVs; Afnon detects them by their hotkey service and each piece is skipped elsewhere:

• The firmware answers the remote's buttons itself (from /vendor/menu_config_xml/hotkey.xml), so the remote buttons service doesn't filter keys there (FirmwareKeys.java) and holding Volume keeps changing it.
• The firmware leaves Source to the app in front, so Home opens CVTE's source menu (com.cvte.tv.globalui) itself.
• Buttons wired to an app that can't be replaced (ESHARE opens EShare) can be pointed at another app with the redirects preference, e.g. com.ecloud.eshare.server=com.droidlogic.miracast. Empty by default.
• If Afnon guesses wrong about key filtering on some TV, the key_filter preference (on/off) forces it.
• install.sh grants location, which Android 9+ needs before Home can show the Wi-Fi name.

Other brands (Xiaomi)

Tested on one Xiaomi Mi TV (MiTV-MOOQ0, Android TV 10, 1.8 GB RAM, MediaTek), after a debloat with cleanyourtv's list for that model. Home, the app list, favourites, the screensaver and the remote buttons service run (its buttons are not checked with the remote yet), and install.sh makes Afnon Home there (it turns the stock launcher off behind its safety switch). Notes:

• Xiaomi's TV Manager force-stops apps, and Android then switches the remote buttons service off. Home turns it back on.
• The firmware gives a few built-in apps a phone-style entry only (Clock, MediaTek's Netflix watcher, a disclaimer screen). Afnon leaves those out of its app list.
• The remote's Input button sends KEYCODE_MEDIA_RECORD (130). Afnon doesn't map it yet; open Live TV from the favourites for HDMI.
• Holding Volume and the Audio Only screen-off have not been checked there yet.
• Free memory matters on this 1.8 GB set: a screen-mirroring app stuck at full CPU (AirScreen) had filled RAM and swap and froze other apps before Afnon was installed.

Project layout

app/src/main/java/tv/afnon/home/
  MainActivity        Home: clock, prayer row, favourites, radio pill and card, Inputs panel, focus map
  Inputs              The TV's sources for the Inputs panel, and its own inputs screen
  PrayerDayActivity   Today's prayers, Qibla dial, room direction
  AllAppsActivity     Every app; hold OK to arrange favourites
  SettingsActivity    On-TV settings (prayer, reminders, radio, display, network, device)
  NowActivity         The call to prayer
  AfnonDream          Screensaver
  PrayerWatch         Reminders, banner and the call, run inside the accessibility service
  RemoteKeys          Remote button mapping
  TclKeys             The same buttons through TCL's own remapping, so held keys still repeat
  Radio, RadioBars    Quran Radio player and its level bars
  ScreenOffActivity   Screen off while listening (TCL Audio Only, or a black fallback)
  Announce            The spoken reminder and «حان الآن موعد صلاة …»
  PrayerDay, Prefs, Reminders, Adhans, Text, Tokens, Ui …
installer/            The phone app that installs and sets up Afnon over ADB (Finder, Adb, Tv, Setup, Personalise)
tools/setup-steps.txt What Afnon needs after install: one list for install.sh and the phone installer
tools/clean-catalog.tsv  The cleanup list, built weekly from cleanyourtv by tools/gen-clean-catalog.py
tools/                install, restore, disable/enable, fetch-adhans, fetch-announce, screenshot
docs/screenshots/     the images above, all from the real TV

---

بالعربية

أفنون شاشة رئيسية لتلفاز أندرويد، تبدأ من يوم الصلاة. الصلاة القادمة والعدّ التنازلي في قلب محراب، ومواقيت اليوم الستة في الأعلى، وتطبيقاتك المفضلة تحتها. ويأتي الأذان إلى التلفاز وحده في وقته.

• مواقيت بلا إنترنت: تُحسب على التلفاز نفسه، مع ٢٤٥ مدينة في ٤٥ دولة تُختار بالمنطقة ثم الدولة ثم المدينة، وعدة طرق حساب، والمذهب الشافعي أو الحنفي في العصر، وتعديل التاريخ الهجري. التاريخ الهجري ووضع رمضان يعتمدان دائمًا على تقويم أم القرى، فإن اختلفت رؤية الهلال المحلية (كما في الولايات المتحدة) فاضبط التعديل.
• القبلة واتجاه الغرفة: اتجاه القبلة من مدينتك، وإعداد لمرة واحدة لاتجاه التلفاز، فتقول لك الشاشة «القبلة خلفك».
• الأذان: ١٦ صوتًا وأذان خاص للفجر. إن كان الصوت مكتومًا يرتفع للأذان ثم يعود كما كان.
• التنبيهات: بطاقة على الرئيسية، أو شريط فوق التطبيقات الأخرى، قبل كل صلاة.
• الجمعة ورمضان: تتغير الشاشة وحدها؛ الجمعة مكان الظهر مع تذكير بسورة الكهف، والإفطار والسحور في رمضان.
• إذاعة القرآن الكريم: من القاهرة (٩٨٫٢ إف إم) افتراضيًا، بث مباشر، وأعمدة تتحرك مع صوت التلاوة نفسه. تتوقف للأذان ثم تُستأنف، ويمكن إطفاء الشاشة أثناء الاستماع لتوفير الكهرباء. ومن الإعدادات ← الإذاعة ← المحطة: إذاعات القرآن الكريم من نابلس وشباب إف إم وقطر وعُمان والأردن والسعودية، أو قناة أحد القرّاء العشرة على مدار الساعة.
• أزرار الريموت: أزرار التطبيقات والإعدادات والمدخلات تعمل مع أفنون. والخدمة نفسها تأتي بالأذان، فإن أوقف أحد تطبيقات التنظيف أفنون أعادت الشاشة الرئيسية تشغيلها.
• مصادر الإدخال: زر في الرئيسية بجانب زر الوضع الليلي يفتح قائمة المصادر في التلفاز كما يفعل زر المصدر، لأجهزة التحكم التي ليس فيها هذا الزر. وإن لم تكن للتلفاز قائمة خاصة، يعرض أفنون منافذ HDMI وAV بنفسه.
• العربية أولًا: من اليمين إلى اليسار، مع الإنجليزية، والأرقام عربية أو لاتينية.
• بلا حسابات ولا إعلانات ولا تتبّع. الإذاعة وحدها تستخدم الإنترنت.

للتثبيت حمّل ملف afnon.apk من صفحة الإصدارات، أو ابنِه من المصدر كما في قسم Install أعلاه. وللعودة إلى الشاشة الأصلية شغّل tools/restore.sh ثم أعد تشغيل التلفاز. وبعد الانتهاء أغلق «تصحيح الأخطاء عبر الشبكة» في خيارات المطوّرين.

---

Credits

• Prayer times: adhan-java (MIT) by Batoul Apps.
• Adhan recordings: abodehq/Athan-MP3. They are not in the source; fetch-adhans.sh downloads them, and the release APK includes them with this credit. If you hold the rights to a recording and want it removed, open an issue.
• Radio: إذاعة القرآن الكريم, Cairo; Holy Quran Radio, Nablus; Shabab FM; Qatar's, Oman's and Jordan's Quran radios; the Saudi Broadcasting Authority's Holy Quran Radio and Nida Al-Islam Radio; and mp3quran.net's reciter channels, each via its own public stream. Afnon is not affiliated with any of them.
• Fonts: Amiri, Alexandria and Marcellus, all under the SIL Open Font Licence. See THIRD_PARTY.md.
• Started from cleanyourtv. Built with Claude Code on the real TV, screenshot by screenshot.

Contributions are welcome; see CONTRIBUTING.md. Released under the MIT licence.