Skip to content

SadaqahCode/muslim-services

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 

🌙 Muslim Services

Islamic Background Service for Android
Prayer reminders, focus modes, and privacy tools for Muslims

Version License Platform Privacy


🕌 What is Muslim Services?

Muslim Services is a background app for Android that helps Muslims stay on top of their Islamic obligations.

It runs quietly in the background, sending notifications before each prayer time, blocking distracting apps during Salah, and providing insights about your phone usage from an Islamic perspective.

What it does

  • Sends notifications before each prayer time
  • Can automatically enable Do Not Disturb during Salah
  • Tracks which apps you use and shows Islamic context
  • Shows Hijri date alongside Gregorian
  • Provides focus modes for Ramadan, work, sleep
  • Works offline (no internet needed for basic features)

Why it exists

Many Muslims miss prayers because they're busy or distracted. Apps constantly send notifications. Muslim Services helps you prioritize Salah and gives you control over when apps can interrupt you.


🚀 Installation

[!NOTE] > Status: Currently in alpha. Play Store release planned for Q2 2026.

From Play Store (Coming Soon)

1. Search "Muslim Services"
2. Install
3. Grant notification permission
4. Set your location for prayer times
5. Choose calculation method

✨ Features

🕌 Prayer & Islamic Calendar

  • Prayer Time Notifications - Get notified 5, 10, or 15 minutes before each Salah
  • Multiple Calculation Methods - ISNA, Muslim World League, Egyptian, Makkah, Karachi, Tehran
  • Madhab Support - Choose Hanafi or Standard for Asr timing
  • Hijri Calendar - See Islamic date, detect Ramadan and Islamic holidays
  • Offline - Everything works without internet after initial setup

🧘 Focus Modes

  • Prayer Mode - Auto Do-Not-Disturb 5 minutes before each prayer
  • Ramadan Mode - Special notifications for Suhoor, Iftar, Taraweeh (coming v1.5)
  • Night Guard - Block apps after bedtime to protect Fajr prayer (coming v1.5)
  • Work Mode - Block social media during work hours (coming v1.5)

🔒 Privacy

  • Local Storage - All data stays on your phone, encrypted
  • No Tracking - Zero analytics, zero telemetry
  • No Internet - Works completely offline (except initial setup)
  • Open Source - Code is public, anyone can verify

📊 App Usage Insights

  • See how much time you spend on each app
  • Islamic context: "2 hours on TikTok = 24 pages of Quran"
  • Weekly usage reports
  • All data stored locally

🔐 Permissions

Permission Required? Why We Need It
Notifications Yes Send prayer time reminders
Location One-time Calculate prayer times for your location (or enter manually)
Do Not Disturb Optional Auto-silence during prayer if you enable it
Notification Listener Optional Filter which apps can notify during prayer
Usage Access Optional Show your app usage statistics
Foreground Service Yes Keep running in background for timely notifications

🗓️ Roadmap

  • v1.0 (Q2 2026) - ✅ Prayer times, basic focus mode, Hijri calendar
  • v1.5 (Q3 2026) - Ramadan mode, Qibla compass, app timers
  • v2.0 (Q4 2026) - Halal product scanner, habit tracking
  • v3.0 (Q1 2027) - Desktop app, family sharing

Full Roadmap


🤝 Contributing

Contributions welcome!

  • 💻 Code: Fix bugs, add features
  • 📝 Docs: Improve documentation
  • 🧪 Testing: Test on devices, report bugs
  • 🎨 Design: UI/UX improvements

Contributing Guide


💰 Support

Muslim Services is free and open source.

If you want to help cover costs (servers, testing devices):

Or just star the repo ⭐


📞 Contact


📚 Documentation


📜 License

GPL-3.0 - Free to use and modify. See LICENSE


🌙 About Sadaqah Code

Sadaqah Code is an Islamic open-source initiative dedicated to building high-quality, free, and accessible digital tools for Muslims worldwide.

We believe that code can be a form of worship when it serves the community. Our mission is to provide transparent, ad-free, and community-owned software that upholds Islamic values.

Note: Sadaqah Code was founded and is maintained by the FlagoDNA team. While FlagoDNA leads the technical development, Sadaqah Code represents the spirit of community ownership and open-source contribution.


Bismillah.

Sadaqah Code Team
Technology for the Ummah


Status: Active Development

About

No description, website, or topics provided.

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Contributors