Tcalm — Prayer Times & Media Pause

# Tcalm: Offline Prayer Times & Smart Media Pause for Chrome **Accurate prayer times. Peaceful reminders. Distraction-free prayer.** Tcalm is an offline-first Chrome extension designed to help you stay connected to your daily prayers. It calculates prayer times locally using an astronomical calculation engine based on solar declination and the equation of time. No internet connection or external API is required for normal daily operation. ## Key Features ### 1. Accurate Offline Prayer Times - **14 calculation methods** using the same method IDs as Tcalm/Aladhan, including the Egyptian General Authority of Survey (default), Muslim World League (MWL), ISNA, Umm al-Qura, Karachi, Tehran, Moonsighting, and more. - Standard and Hanafi Asr calculation options. - Configurable high-latitude calculation rules. - Automatic daily recalculation to keep prayer times accurate. ### 2. Smart Prayer Notifications - Receive prayer notifications in English or Arabic. - Each notification displays the prayer's exact time in your preferred clock format. - Set optional advance reminders to be notified a chosen number of minutes before prayer. - Enable a gentle chime for an additional audio reminder. ### 3. Intelligent Media Pause Tcalm can pause supported media playing in Chrome tabs at prayer time, helping you create a quieter environment for prayer. Its media control supports a range of playback technologies, including: - Standard HTML media and custom players. - Detached audio elements used by some web applications. - Media inside cross-origin iframes, where browser permissions and access allow. - Open Shadow DOM roots. - Web Audio applications by suspending their AudioContext instances and resuming them when appropriate. **Flexible pause duration:** - **0 minutes, the default:** Pause media once without automatically resuming it. Playback remains paused until you choose to resume it. - **Greater than 0 minutes:** Keep supported media paused for the configured duration, then resume only the media Tcalm paused itself. **Built-in testing and recovery tools:** - Test media pausing using the same code path as the actual feature. - Identify affected tabs by page title. - See how many tabs were scanned and receive diagnostic information when media cannot be paused. - Resume media paused during testing or end an active pause period early. Media control depends on Chrome permissions, website behavior, and browser restrictions. Some playback may resist automated pausing. Learn more: https://github.com/Monessem/Pray-calm#media-control--the-honest-limits ### 4. Flexible Location Settings Choose between two location modes: - **Manual location:** Select from built-in country and city presets or enter your own coordinates. - **Automatic location:** Use browser geolocation after explicitly granting permission. An optional IP-based location approximation is also available. This is the only feature that contacts a third-party service. ### 5. Worldwide Location Database Find your location using a built-in database covering: - **194 countries and 593 cities worldwide.** - English and Arabic country and city names. - Geographic coordinates and timezone information. - City-specific timezones for countries spanning multiple timezones, including the United States, Russia, Brazil, and Indonesia. - Suggested prayer calculation methods based on the selected country. The location database works offline. ### 6. Automatic Timezone Detection - Automatically detect your timezone or select an IANA timezone manually. - Account for daylight saving time (DST). - Recalculate prayer times daily using the selected timezone. ### 7. Hijri Calendar View the Hijri date directly in the popup, with an adjustable day offset to accommodate local calendar preferences. ### 8. Customizable Time Format Choose between: - **12-hour format:** Includes AM/PM in English or ص/م in Arabic. - **24-hour format:** Uses the standard 24-hour clock. Your preference applies consistently across prayer lists, the next-prayer card, the live clock, and notifications. ### 9. Beautiful, Accessible Interface Enjoy a responsive popup designed for clarity and ease of use, featuring: - A live countdown to the next prayer. - Light, dark, and system themes. - Full keyboard accessibility. - Complete right-to-left (RTL) support for Arabic. - A golden mosque extension icon with a transparent background and soft shadow for visibility on light and dark Chrome toolbars. ### 10. Modern Settings Interface The settings page features a modern interface inspired by Apple's iOS design language. Highlights include: - Liquid Glass-inspired navigation surfaces. - Grouped settings with subtle dividers. - Native-style toggle switches and segmented controls. - Responsive pill buttons with interactive feedback. - Inline SVG icons and organized section navigation. - An optimized layout for desktop and narrow screens. - A Chrome tab favicon featuring the extension logo. - Arabic-first typography and enhanced text readability. - Refined dark-mode styling, shadows, and themed scrollbars. - Accessible helper-text contrast. - Performance optimizations to reduce unnecessary background work and improve scrolling. The interface is fully RTL-aware, while the underlying settings logic, identifiers, and save behavior remain consistent. ### 11. Privacy-Friendly Diagnostics Tcalm includes a self-cleaning support log to help diagnose issues without allowing diagnostic data to accumulate indefinitely. - Retains internal events for a maximum of one week. - Limits the log to 120 entries, approximately 45 KB. - Automatically removes expired entries. - Uses the system notification channel by default on fresh installations. - Keeps the guaranteed on-screen alert window disabled unless explicitly enabled. ### 12. Guided First-Run Setup Tcalm guides new users through a simple, three-step setup process. **Step 1: Welcome** Learn what Tcalm does and understand the scope of its media-pause capabili…