{"id":15619640,"url":"https://github.com/mohamedashraf701/prayers_times","last_synced_at":"2025-04-28T13:33:45.640Z","repository":{"id":187393296,"uuid":"676829525","full_name":"MohamedAshraf701/prayers_times","owner":"MohamedAshraf701","description":"Seamlessly access precise prayer times with our Flutter package tailored to your location. Enhance your namaz routine effortlessly.","archived":false,"fork":false,"pushed_at":"2024-03-26T11:01:48.000Z","size":521,"stargazers_count":9,"open_issues_count":3,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-30T10:05:03.017Z","etag":null,"topics":["dart","flutter","flutter-app","flutter-examples","flutter-package","flutter-plugin","muslim","muslim-prayer-times","muslims-prayer","namaz","namaz-time","prayer","prayer-muslim","prayer-times","prayers","prayers-times","prayertimes"],"latest_commit_sha":null,"homepage":"https://pub.dev/packages/prayers_times","language":"Dart","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/MohamedAshraf701.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-08-10T05:36:26.000Z","updated_at":"2025-03-01T15:51:20.000Z","dependencies_parsed_at":null,"dependency_job_id":"625d7a46-96b6-4cb5-8234-9c9574fe26f3","html_url":"https://github.com/MohamedAshraf701/prayers_times","commit_stats":null,"previous_names":["mohamedashraf701/prayers_times"],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MohamedAshraf701%2Fprayers_times","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MohamedAshraf701%2Fprayers_times/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MohamedAshraf701%2Fprayers_times/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MohamedAshraf701%2Fprayers_times/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MohamedAshraf701","download_url":"https://codeload.github.com/MohamedAshraf701/prayers_times/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251320079,"owners_count":21570510,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["dart","flutter","flutter-app","flutter-examples","flutter-package","flutter-plugin","muslim","muslim-prayer-times","muslims-prayer","namaz","namaz-time","prayer","prayer-muslim","prayer-times","prayers","prayers-times","prayertimes"],"created_at":"2024-10-03T08:40:43.792Z","updated_at":"2025-04-28T13:33:45.556Z","avatar_url":"https://github.com/MohamedAshraf701.png","language":"Dart","funding_links":["https://www.buymeacoffee.com/ashraf704"],"categories":[],"sub_categories":[],"readme":"# prayers_times\n\n![Flutter Platform](https://img.shields.io/badge/platform-flutter-yellow)\n[![pub package](https://img.shields.io/pub/v/prayers_times.svg)](https://pub.dev/packages/prayers_times)\n\n## بِسْمِ اللهِ الرَّحْمٰنِ الرَّحِيْمِ \n\nPrayers Times is a Flutter package that provides utilities for calculating and displaying Islamic prayer times (Namaz times), as well as related insights like Qibla direction. It's a comprehensive solution for handling prayer timings in your Flutter applications.\n\n## Features\n\n- Calculate accurate Islamic prayer times (Namaz times) based on various calculation methods.\n- Determine Qibla direction based on geographical coordinates.\n- Calculate middle of the night and last third of the night times.\n- Conversion utilities for different Islamic time formats.\n\n# Namaz_times\n\n## Installation\n\nAdd `prayers_times` as a dependency in your `pubspec.yaml` file:\n\n```yaml\ndependencies:\n  flutter:\n    sdk: flutter\n  prayers_times: \u003clatest_version\u003e\n```\n\n## Usage\n\nImport the package in your Dart file:\n\n```dart\nimport 'package:prayers_times/prayers_times.dart';\n```\n\n## Calculate Prayer Times\nTo calculate and display prayer times for a specific location, follow these steps:\n\n1. Define the geographical coordinates for the location.\n2. Specify the calculation parameters for prayer times, such as the calculation method and madhab.\n3. Create a `PrayerTimes` instance using the provided coordinates and parameters.\n4. Use the provided methods to access various prayer times and convenience utilities.\n\n```dart\n// Define the geographical coordinates for the location\nCoordinates coordinates = Coordinates(21.1959, 72.7933);\n\n// Specify the calculation parameters for prayer times\nPrayerCalculationParameters params = PrayerCalculationMethod.karachi();\nparams.madhab = PrayerMadhab.hanafi;\n\n// Create a PrayerTimes instance for the specified location\nPrayerTimes prayerTimes = PrayerTimes(\n  coordinates: coordinates,\n  calculationParameters: params,\n  precision: true,\n  locationName: 'Asia/Kolkata',\n);\n```\n\n## Prayer Times With Specific Date\n\nTo calculate prayer times for a specific date, you can create an instance of the `PrayerTimes` class and provide a custom `DateTime` object using the `dateTime` parameter.\n\n```dart\nPrayerTimes prayerTimes = PrayerTimes(\n  coordinates: Coordinates(latitude, longitude),\n  calculationParameters: CalculationMethod.karachi(),\n  locationName: 'Your Location',\n  dateTime: DateTime(2023, 8, 15), // Specify the desired date\n);\n```\n\n## Prayer Times\nDisplay prayer times or Calculate accurate Islamic prayer times (Namaz times) based on various calculation methods.\n\n```dart\nprint('Fajr Start Time:\\t${prayerTimes.fajrStartTime!}');\nprint('Fajr End Time:\\t${prayerTimes.fajrEndTime!}');\nprint('Sunrise Time:\\t${prayerTimes.sunrise!}');\nprint('Dhuhr Start Time:\\t${prayerTimes.dhuhrStartTime!}');\nprint('Dhuhr End Time:\\t${prayerTimes.dhuhrEndTime!}');\nprint('Asr Start Time:\\t${prayerTimes.asrStartTime!}');\nprint('Asr End Time:\\t${prayerTimes.asrEndTime!}');\nprint('Maghrib Start Time:\\t${prayerTimes.maghribStartTime!}');\nprint('Maghrib End Time:\\t${prayerTimes.maghribEndTime!}');\nprint('Isha Start Time:\\t${prayerTimes.ishaStartTime!}');\nprint('Isha End Time:\\t${prayerTimes.ishaEndTime!}');\n```\n\n## Tahajjud \u0026 Sehri End Time\n\n```dart\nprint('Isha End Time:\\t${prayerTimes.ishaEndTime!}');\nprint('Tahajjud End Time:\\t${prayerTimes.tahajjudEndTime!}');\n```\n\n## Convenience Utilities\nThe `PrayerTimes` instance provides convenience utilities to determine the current and next prayer times, making it easy to display relevant information to users.\n\n```dart\n// Convenience Utilities\nString current = prayerTimes.currentPrayer();\nString next = prayerTimes.nextPrayer();\nprint('Current Prayer: $current ${prayerTimes.timeForPrayer(current)}');\nprint('Next Prayer: $next ${prayerTimes.timeForPrayer(next)}');\n```\n\n## Sunnah Times\nUtilize the `SunnahInsights` class to calculate and display Sunnah times, such as the middle of the night and the last third of the night.\n\n```dart\n// Sunnah Times\nSunnahInsights sunnahInsights = SunnahInsights(prayerTimes);\nprint('Middle of the Night: ${sunnahInsights.middleOfTheNight}');\nprint('Last Third of the Night: ${sunnahInsights.lastThirdOfTheNight}');\n```\n\n## Qibla and Madina Directions\n\nThe `Qibla` class provides methods to calculate the Qibla direction (direction of the Kaaba in Makkah) and the madina direction (direction of Al-Masjid an-Nabawi) from a given location. These calculations are based on the geographic coordinates (latitude and longitude) of the specified location and the coordinates of Makkah and Al-Masjid an-Nabawi. The calculations use spherical trigonometry to determine the angle between the specified location and the respective directions.\n\n## Calculate Qibla Direction\n\nThe `qibla` method calculates the Qibla direction based on the geographic coordinates of the specified location and the coordinates of Makkah (the Holy Kaaba). The result is the clockwise angle from the North direction.\n\n```dart\ndouble qiblaDirection = Qibla.qibla(coordinates);\n```\n\n## Calculate Madina Direction\n\nThe `madina` method calculates the madina direction based on the geographic coordinates of the specified location and the coordinates of Al-Masjid an-Nabawi. The result is the clockwise angle from the North direction.\n\n```dart\ndouble madinaDirection = Qibla.madina(coordinates);\n```\n\n## Customization\n\nThe package offers customization options for various properties and calculations. Refer to the documentation for detailed information on customization options.\n\n---\n\n## Documentation\n\nFor detailed usage instructions and API documentation, please refer to the [documentation](https://pub.dev/documentation/prayers_times/latest/).\n\n---\n\n## Changelog\n\nSee the [CHANGELOG](https://github.com/MohamedAshraf701/prayers_times/blob/main/CHANGELOG.md) for a history of changes in the package.\n\n---\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](https://github.com/MohamedAshraf701/prayers_times/blob/main/LICENSE) file for details.\n\n---\n\n## Get in touch\n\nIf you have any questions, feel free to reach out:\n\n- Email: ashrafchauhan567@gmail.com\n- GitHub: [@MohamedAshraf701](https://github.com/MohamedAshraf701)\n\n---\n\n## Contributing\n\nContributions to the `prayers_times` package are welcome! Please read the [contribution guidelines](CONTRIBUTING.md) before submitting a pull request.\n\n---\n\n# Support\n\u003cp\u003e\u003ca href=\"https://www.buymeacoffee.com/ashraf704\"\u003e \u003cimg align=\"left\" src=\"https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png\" height=\"50\" width=\"210\" alt=\"ashraf704\" /\u003e\u003c/a\u003e\u003c/p\u003e\u003cbr\u003e\u003cbr\u003e\n\n---\n\nFeel free to explore the features of the `prayers_times` package and customize it to suit your needs. If you have any questions or feedback, don't hesitate to reach out. Happy coding!","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmohamedashraf701%2Fprayers_times","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmohamedashraf701%2Fprayers_times","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmohamedashraf701%2Fprayers_times/lists"}