# Muslim Launcher 2 🕌

[English](#english) | [Bahasa Indonesia](#bahasa-indonesia) | [Privacy Policy](#privacy-policy-)

---

## English

An innovative custom Android launcher designed specifically to reduce smartphone addiction in a meaningful way. It transforms screen-wasting habits (mindless scrolling) into consistent daily habits of reading the Holy Quran, practicing Dhikr, and reflecting on Authentic Hadiths.

### Core Concept
Instead of simply locking apps with rigid timers, Muslim Launcher utilizes an **"Ibadah Points"** system. Distracting applications (games, social media, entertainment) are automatically blocked.

To unlock and access blocked applications, you need a certain amount of points (e.g., 50 Points) to unlock an app for 60 minutes. Points are earned through multiple worship channels:

1. 📖 **Read Holy Quran (Primary — +10 to +25 Points):** Read interactive verses with Uthmani script, Tajweed color coding, and audio/focus validation.
2. 📿 **Mindful Dhikr (Face Presence — +10 Points per round):** Digital tasbih (33x) powered by smart front-camera face presence detection (valid even with closed eyes for serene contemplation), calming haptic feedback, rhythm pacing, and Arabic/Latin transliterations. Specially designed for everyday remembrance as well as when you are unable to read the Holy Quran (e.g., during menstruation/haid, or in a state of ritual impurity).
3. 📜 **Authentic Hadith Reflection (+3 to +8 Points):** Daily curated collection of authentic Prophetic Hadiths with focus-aware reading time and dynamic point calculations. Ideal for learning prophetic wisdom and as a convenient alternative during excused periods (e.g., menstruation/haid) or on the go.

### Key Features
* 🌟 **Diverse Worship Point System:** Earn points by reading Quran, doing Dhikr (tasbih), or reflecting on Hadiths.
* 📿 **Smart Face-Presence Dhikr:** Interactive digital tasbih with face presence detection, gentle haptic feedback on each count, anti-rush rhythm pacing, virtues (fadhilah), and automatic history logging.
* 📜 **Daily Authentic Hadith Collection:** Random daily shuffle of 50 verified Hadiths with theme filtering and multi-language translations.
* 🛡️ **Native Background App Blocker:** Powered by native Android `AccessibilityService`. If you attempt to open a blocked app without enough points, the lock screen gently intercepts you and offers worship options.
* 🚫 **Permanent Blocker for Gambling & Adult Content Apps:** In compliance with Islamic law, apps categorized under gambling/betting (slots, casino, poker, domino island chips, sports betting, lotteries) as well as explicit adult content apps and bypass/anti-censorship browsers (which facilitate access to adult content) are **permanently blocked**. They cannot be unlocked with points under any circumstances. When intercepted, they display an Islamic reminder with relevant Quranic verses (QS. Al-Ma'idah: 90 for gambling, QS. Al-An'am: 151 for adult content), spiritual counsel, and a direct one-tap option to uninstall the prohibited application.
* 👁️ **Ghadhul Bashar Lower-the-Gaze Reminders:** Dedicated Quranic reminder cards before opening browsers or high-risk social media platforms to maintain spiritual mindfulness.
* 🔒 **Temporary Unlock System:** Once 50 points are spent, non-productive apps become accessible normally for 60 minutes. When the duration expires, apps are locked again.
* 🌐 **Full Multilingual Support:** Comprehensive localized interface in 6 languages: English, Bahasa Indonesia, Bahasa Melayu, العربية, Afrikaans, and Kiswahili.
* 📱 **Distraction-Free Aesthetics:** A clean, minimalist layout with high-contrast dark theme support to break visual smartphone triggers.

### Data Sources 📖
* **Holy Quran Data:** Sourced from the **[Tanzil Project](https://tanzil.net)** and bundled locally (`assets/quran.json`) for 100% offline availability (Uthmani Script, Tajweed, Saheeh International English translation, Indonesian Kemenag translation, and Latin transliteration).
* **Hadith Data:** Curated from classical authentic Hadith collections (*Kutub as-Sittah* — Sahih al-Bukhari, Sahih Muslim, Jami` at-Tirmidhi, Sunan Abi Dawud, etc.) bundled locally (`assets/hadiths.json`) with thematic categorizations and multi-language translations.

### Privacy Policy 🔒
This application respects your privacy. Muslim Launcher uses Android's **Accessibility Service** purely to detect when a blocked application is opened so it can redirect you to the lock screen.
* **No Data Collection:** We do not collect, store, or transmit any personal data, typing behavior, or screen content.
* **On-Device Machine Learning:** Camera frames for eye tracking and face presence detection are processed 100% on-device in real-time memory and are never recorded, stored, or sent over any network.
* **Offline First:** All core features, Quran, Hadith, and Dhikr datasets operate 100% offline on your local device.
* **Open Source Transparency:** The entire source code of this application is fully open source in this repository for complete community auditability.

### Open Source & Amal Jariyah 🤲
This codebase is completely open and free to be developed, modified, and distributed by anyone. The creator's primary mission is to spread this application, its code, or at least the core concept and idea behind it as widely as possible in the hope of gaining *amal jariyah* (continuous reward / ongoing charity) inshaAllah. Feel free to fork, enhance, and build upon this project for the benefit of the Ummah!

### Support / Request Features ☕
If you find this app helpful in reducing smartphone addiction and increasing your Ibadah, or if you'd like to request a new feature, consider supporting the development!
* [Support / Request Features via Ko-fi](https://ko-fi.com/andrisetiawan84153)

---

## Bahasa Indonesia

Sebuah custom launcher Android inovatif yang dirancang khusus untuk mengurangi kecanduan smartphone dengan cara yang berkah dan bermanfaat. Aplikasi ini mengubah kebiasaan membuang waktu (*mindless scrolling*) menjadi kebiasaan rutin membaca Al-Quran, berdzikir, dan mentadabburi Hadits Shahih.

### Konsep Utama
Alih-alih sekadar memblokir aplikasi dengan pengatur waktu seperti launcher pada umumnya, Muslim Launcher menggunakan sistem **"Poin Ibadah"**. Aplikasi-aplikasi non-produktif (game, media sosial, video pendek) akan diblokir secara otomatis.

Untuk membuka dan mengakses aplikasi yang diblokir selama 60 menit, Anda membutuhkan sejumlah poin (misalnya: 50 Poin). Poin dapat diperoleh melalui berbagai jalur ibadah:

1. 📖 **Membaca Al-Quran (Jalur Utama — +10 s.d. +25 Poin):** Membaca ayat Al-Quran ber-Tajweed lengkap dengan teks Arab, Latin, arti, serta validasi suara/fokus mata.
2. 📿 **Dzikir Khusyu' (Deteksi Wajah — +10 Poin per putaran 33x):** Tasbih digital interaktif dengan deteksi kehadiran wajah melalui kamera depan (mata terpejam saat dzikir tetap sah), getaran haptic lembut, pembatas ritme dzikir agar tidak terburu-buru, teks Arab, Latin, arti, fadhilah, dan pencatatan riwayat. Sangat cocok untuk rutinitas harian maupun bagi yang **sedang tidak bisa membaca Al-Quran** (misalnya: sedang berhalangan/haid atau dalam keadaan hadas).
3. 📜 **Tadabbur Hadits Shahih (+3 s.d. +8 Poin):** Membaca dan merenungi koleksi Hadits Shahih harian dengan kalkulasi poin dinamis berbasis panjang matan dan waktu fokus. Pilihan ideal untuk mendalami sunnah Rasulullah ﷺ sekaligus solusi alternatif yang sangat bersahabat bagi yang sedang berhalangan/haid atau memiliki waktu luang yang singkat.

### Fitur Unggulan
* 🌟 **Sistem Poin Ibadah Fleksibel:** Kumpulkan poin melalui tilawah Al-Quran, putaran Dzikir, maupun tadabbur Hadits.
* 📿 **Mode Dzikir Khusyu' Cerdas:** Tasbih digital dengan deteksi kehadiran wajah (*Face Presence*), getaran lembut di setiap hitungan dzikir, ritme jeda agar tidak terburu-buru, lafadz Arab/Latin/Arti, preset fadhilah, dan riwayat dzikir otomatis.
* 📜 **Koleksi 50 Hadits Shahih Harian:** Diacak setiap hari dengan filter tema (Akidah, Ibadah, Akhlak, Muamalah) serta terjemahan multi-bahasa.
* 🛡️ **Pemblokiran Latar Belakang Asli:** Berjalan menggunakan `AccessibilityService` Android. Jika aplikasi non-produktif dibuka tanpa poin yang cukup, layar pemblokiran akan langsung mengarahkan Anda ke pilihan ibadah.
* 🚫 **Pemblokiran Total & Permanen untuk Aplikasi Judi & Konten Dewasa:** Sesuai syariat Islam, seluruh aplikasi kategori perjudian/taruhan (slot, kasino, poker, domino taruhan/chip, taruhan bola, togel) serta aplikasi konten dewasa eksplisit dan peramban anti-blokir/bypass (yang memungkinkan akses konten pornografi/dewasa) **diblokir secara permanen dan total**. Aplikasi ini tidak dapat dibuka maupun di-unlock dengan poin sama sekali. Saat dicegat, aplikasi menampilkan pengingat syariat berserta ayat Al-Qur'an (QS. Al-Ma'idah: 90 tentang larangan berjudi, QS. Al-An'am: 151 tentang larangan mendekati kekejian), nasihat syariat, dan tombol untuk langsung menghapus/meng-uninstall aplikasi tersebut.
* 👁️ **Peringatan Ghadhul Bashar (Menundukkan Pandangan):** Menampilkan ayat Al-Qur'an untuk menundukkan pandangan dan mengingat Allah sebelum membuka peramban umum serta media sosial utama berisiko tinggi.
* 🔒 **Sistem "Unlock" 60 Menit:** Setelah 50 poin ditukar, aplikasi non-produktif dapat diakses normal selama 60 menit sebelum terkunci kembali secara otomatis.
* 🌐 **Dukungan Multi-Bahasa Lengkap:** Mendukung 6 bahasa (Bahasa Indonesia, English, Bahasa Melayu, العربية, Afrikaans, dan Kiswahili) yang reaktif di seluruh layar dan dialog.
* 📱 **Tampilan Adaptif & Bebas Overflow:** Layout yang dioptimasi untuk berjalan mulus 120Hz di segala ukuran layar, resolusi, dan skala font aksesibilitas.

### Sumber Data 📖
* **Data Al-Quran:** Bersumber dari **[Tanzil Project](https://tanzil.net)** yang dibundel secara lokal (`assets/quran.json`) agar dapat diakses 100% offline (Rasm Uthmani, Tajweed, Terjemahan Kemenag RI, Saheeh International, dan Transliterasi Latin).
* **Data Hadits:** Dikompilasi dari kitab-kitab hadits mu'tabar (*Kutubus Sittah* — Shahih Bukhari, Shahih Muslim, Sunan Tirmidzi, Sunan Abu Dawud, dll.) yang dibundel secara lokal (`assets/hadiths.json`) lengkap dengan klasifikasi tema dan terjemahan.

### Kebijakan Privasi (Privacy Policy) 🔒
Aplikasi ini sangat menghargai privasi dan keamanan data Anda:
* **Tanpa Pengumpulan Data:** Kami sama sekali tidak mengumpulkan, menyimpan, atau mengirimkan data pribadi, riwayat pengetikan, maupun konten di layar Anda.
* **Pemrosesan di Perangkat (*On-Device*):** Pemrosesan kamera untuk deteksi mata/wajah dilakukan secara lokal di RAM *real-time* dan tidak pernah disimpan sebagai file gambar atau dikirim ke internet.
* **100% Berjalan Offline:** Seluruh sistem pemblokiran, Al-Quran, Hadits, dan Dzikir berjalan luring tanpa memerlukan koneksi internet.
* **Transparansi Open Source:** Seluruh kode sumber aplikasi ini bersifat sumber terbuka (*open source*) di repositori ini sehingga dapat diaudit oleh siapa saja secara transparan.

### Pengembangan & Amal Jariyah 🤲
Kode sumber ini sepenuhnya bebas dan boleh dikembangkan, dimodifikasi, serta disebarluaskan oleh siapa pun. Pembuat memiliki misi utama untuk menyebarkan aplikasi ini, kode sumbernya, atau setidaknya ide dan konsep di baliknya seluas-luasnya, dengan harapan dapat mendatangkan **amal jariyah** yang terus mengalir insyaAllah. Silakan fork, kembangkan lebih lanjut, atau adaptasi proyek ini untuk kebaikan dan kemaslahatan bersama!

### Dukung / Usulkan Fitur ☕
Jika Anda merasa aplikasi ini bermanfaat dalam mengurangi kecanduan smartphone dan meningkatkan ibadah Anda, atau Anda ingin mengusulkan fitur baru, mari dukung pengembangannya:
* [Dukung / Usulkan Fitur via Trakteer](https://trakteer.id/andri_setiawan108/tip)

---
*Dibuat untuk memotivasi Anda memperbanyak interaksi dengan Al-Quran, Dzikir, dan Hadits serta mengubah kebiasaan screen-time menjadi pahala yang berlimpah.*