Metadata-Version: 2.1
Name: time-to-pray
Version: 0.1.0
Summary: A desktop utility for Islamic prayer times
Home-page: https://github.com/omerbustun/time-to-pray
Author: Ömer Üstün
Author-email: omerbustun@gmail.com
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: PyQt6
Requires-Dist: PyQt6 ==6.5.2
Requires-Dist: PyQt6-sip ==13.5.2
Requires-Dist: Requests ==2.31.0

Time to Pray ![Time to Pray Icon](assets/icon.png)
===============

**Time to Pray** is a desktop utility designed to keep you informed about Islamic prayer times. Directly from your system tray, view a real-time countdown to the next prayer. The application proactively retrieves the monthly prayer schedule for your chosen location and caches the data for instantaneous reference. Stay on track with your prayer commitments, knowing the exact time remaining until the next call.

Features
--------

*   Real-time countdown to the next prayer, accessible from the system tray.
*   Proactively fetches the monthly prayer schedule based on your configured location.
*   Easy-to-access "Settings" dialog for configuring your preferred city and selecting your desired prayer times calculation method.
*   Utilizes PyQt6 for a seamless user interface experience.

Setup & Installation
--------------------

1.  **Clone the Repository**
    
    ```bash
    git clone https://github.com/omerbustun/time-to-pray.git
    ```
    ```bash
    cd time-to-pray
    ```
    
2.  **Install Dependencies**
    
    Make sure you have Python installed. Then, install the required packages:
    
    ```bash
    pip install -r requirements.txt
    ```
    

Usage
-----

To run the application:

```bash
python src/main.py
```

Once launched, an icon will appear in your system tray. Right-click the icon to access the settings or hover to view the detailed countdown.

Configuration
-------------

The application uses the `settings.json` file for configuration. You can use the "Settings" dialog in the application or manually edit this file (not recommended). The configuration parameters are:

*   `city`: The city you are located in.
*   `country`: The country name or code (e.g., "tr" for Turkey).
*   `latitude` & `longitude`: The geographical coordinates of your location. The application automatically fetches these from the API based on the specified city and country.
*   `method`: The method used to calculate prayer times.

Contributing
------------

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

License
-------

This project is licensed under the GNU General Public License, version 3 (GPLv3). See the [LICENSE](LICENSE) file for the full license text.
