Giter VIP home page Giter VIP logo

awqat-salaat's Introduction

النسخة العربية متوفرة هنا

Awqat Salaat Widget GitHub Release

This is a simple Islamic Windows widget that shows the time of the next prayer, alongside a countdown, on the taskbar in order to help the user keep tracking of prayers times.

The widget can show the prayers times of the whole day and update automatically, to show times of the next day, when the time of last prayer (Isha) has entered.

This widget support visual notification when the time of the next prayer becomes close to a certain configurable limit.

Actually, the widget uses two services to get the prayers times based on user settings:

Caution

The only purpose of this widget is to have an idea whether the next prayer is close or not in a simple way without having to click/open anything. Although most prayers times provided by the APIs are almost precise, there is no guarantee that this will be always the case, especially for Maghrib prayer. So DON'T rely on the widget to get the exact time, especially for performing rituals such as fasting or establishing prayers right after entering their times.

Supported Platforms

Awqat Salaat is a Windows widget that is available in two forms:

Awqat Salaat (Deskband)

This widget takes advantage of a feature called Desk Band which is an old feature and has been deprecated and removed completely from Windows 11. However, the older vesions (Windows 7, 8, 8.1 and 10) still support this feature.

Although the widget was designed specifically for Windows 10, starting from version 1.1 the widget is compatible with Windows 7/8/8.1 and all versions of Windows 10 with some subtle visual differences on Windows 7/8/8.1.

Also note that if you choose to use the widget on Windows 7/8/8.1 then make sure to install .NET Framework 4.7.2 Runtime and the font Segoe MDL2 Assets.

Awqat Salaat WinUI Awqat Salaat WinUI Icon

This widget is a regular app that can run on Windows 11 and on Windows 10 1809 or later. This app bring Awqat Salaat to Windows 11 which wasn't supported in earlier versions of the widget.

Note

Although this app can run on Windows 10, it's not recommended due to the limitiations listed below, use deskband widget instead.

Requirements:

Note

If you get an error about missing Windows App Runtime after installing it, go to the download page and download Redistributable instead of Installer, open the zip and install the package MSIX\win10-x64 (or x86)\Microsoft.WindowsAppRuntime.DDLM.1.5.msix

Limitations & known issues

  • The widget is injected into the taskbar, thus it's not a part of it.
  • The widget overlap the taskbar content which can lead to overlapping issue when the taskbar become full.
  • The widget may not respond to all changes in the taskbar to update its position (can be re-positioned manually).
  • The widget cannot be shown/hidden from the taskbar itself. However, a context-menu and a system tray icon are available to control the widget.
  • Explorer will not manage the widget so it has to be launched externally at Windows startup. This can be configured in Settings.
  • On 2-in-1 devices, you may need to manually re-position the widget after switching to/from tablet mode.
  • The blurred background effect doesn't work, for some reason, even though it works when the widget is not injected into the taskbar.

Installation

Go to Releases page and download the installer that matches your OS architecture.

Warning

If you choose the x86 version of the installer while your OS is x64, then the widget won't install correctly.

After downloading the installer, double-click on it to install the widget.

If you choose Awqat Salaat WinUI, launch the app and jump directly to step 3.

It's expected that the widget will not appear after the installation finish, so you need to activate it manually. Here are the steps:

  1. Right-click on the taskbar then move the mouse over Toolbars. For unknown reasons, the widget name will be absent in the list of toolbars so you have to repeat this step again.

Right-click on taskbar and hover over Toolbars item

  1. In the second time, the widget name Awqat Salaat will appear so click on it to activate the widget.

Right-click on taskbar again and this time Awqat Salaat name will appear under Toolbars

  1. Now the widget should appear on the taskbar. Click on it to show settings panel then enter the necessary inputs and click on ✔️ to save changes.

The widget appear on the taskbar and settings panel open

Tip

Make sure to check available options for Calculation Method since there can be one for your country; otherwise just leave the default one. Custom method might be supported in future versions of the widget as well.

Showcase

Windows 10 (Deskband)

Note

The theme always match system theme on Windows 10.

Regular

Awqat Salaat widget showing next prayer time Awqat Salaat widget showing prayers times for the whole day

Compact

Awqat Salaat compact widget showing next prayer time Awqat Salaat compact widget showing countdown

Reminder notification

Awqat Salaat widget notification for near prayer time

Elapsed time notification

Awqat Salaat widget notification for entered prayer time

Windows 11 (WinUI)

Note

The theme always match system theme.

Regular

Awqat Salaat WinUI widget showing next prayer time on center-aligned taskbar Awqat Salaat WinUI widget showing next prayer time on left-aligned taskbar Awqat Salaat WinUI widget showing prayers times for the whole day

Compact

Awqat Salaat WinUI compact widget showing next prayer time Awqat Salaat WinUI compact widget showing countdown

Reminder notification

Awqat Salaat WinUI widget notification for near prayer time

Elapsed time notification

Awqat Salaat WinUI widget notification for entered prayer time

Build

To build Awqat Salaat (Deskband) widget and the preview app, the following is needed:

  • .NET Framework 4.7.2 development tools

To Build Awqat Salaat WinUI widget, the following is needed:

  • .NET SDK
  • Windows App SDK

In addition, to build the installers the following SDK is needed:

  • Wix Toolset Sdk v4.0.3

Changelog

For a list of changes, check the changelog here.

Notes

  • The widget cache all the times of the current month, obtained from the API, so that it can work in offline mode.
  • The preview app is used for development purposes only.
  • The Hijri date shown in the widget is provided by the runtime (.NET Framework/.NET) and is based on Um Al Qura calendar, thus it may not match the exact date everywhere.

Acknowledgement

  • CSDeskBand: A library that simplifies the creation of DeskBands using WinForms or WPF.
  • H.NotifyIcon: A library that simplifies the creation of system tray icons.
  • Islamic Finder: They provide a simple API for getting the prayers times.
  • Al-Adhan: They provide a flexible API for getting the prayers times.
  • Nominatim: An open-source geocoding service.

Contact

For any question or problem reporting, please consider opening a new issue or send an email to [email protected].

License

This project is licensed under the terms of MIT License.

awqat-salaat's People

Contributors

khiro95 avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar

Forkers

pa-0 mrani24

awqat-salaat's Issues

Islamic Finder service is down again

Unfortunately, the Islamic Finder service seem to be facing technical issues lately and this affect Awqat Salaat widget dramatically, thus more services need to be added to overcome this dependency.

[FEATURE] Auto Re-Position

Is it possible to auto re-position every 1 min for like 5 mins (5 times) as soon as the windows start, and/or re-position automatically as soon as the current position changes which triggers the re-positioning?

Syuruq/Sunrise Time

Salam Brother, just a sugestion, can you give option to add time for syuruq/sunrise?
Jazakallah..

Remaining time is not showing

I installed AwqatSalaat.WinUI_Release-x64.msi in my Windows 11 but it's not showing the remaining time of next prayer.

image

But if I change the language to Arabic, it displays:

image

Some suggestions

Salam, Great work, Glad that I found this when I was thinking about making one myself. I have some suggestions that I was going to implement on my app inspired by how I wanted my app to behave:

  • to minimize the size of the widget as you discussed in a previous issue, we can have the widget show the next prayer time until the time the user chooses to be notified, the widget then should switch to a countdown

  • Like Salatuk, the widget displays elapsed time since the Athan at first and then switches to showing the next prayer time later (I don't know exactly how much elapsed passed before switching to the next prayer time but I believe Salatuk split the time in half.

  • I haven't dived deeper yet into Windows app SDK and WinUI 3, is it possible to have a setting where we choose the widget's position? I have the left area empty but the right is cluttered
    image
    image

  • any reason why the app is not in the Microsoft Store? for easier update

Option for white font

image

If you have the time.
It'd be great to have an option for selecting between white and black font like windows time and wifi icons and so on.
Thanks

Windows Update

After the latest Windows update, I can no longer bring the counter down!
image

Alignment issue

Zoom the pic and see that the Asr and it's time is a little bit up than the After and it's time.
image

Position of the widget is not inside the taskbar

Hi, I found an issue in the position of the widget in the taskbar, here is how it looks:
image

I think a possible cause for this issue is that, I have a 2 in 1 laptop that could work as tablet, so the taskbar size and look changes to appear bigger and the look and position of the widget is correct in this mode.
image

I know, I might be in the minority here, but I would be glad if you could find a solution for it.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.