prayer-times-menubar-app

A menubar application for displaying the prayer times from your city.

Features

Actual times from any location
Change the calculation method or custom the angles for Fajr and Isha prayers
Create your own method by changing the times of the different prayers
Show additional times like Imsak, Sunrise and Midnight
Dark and Light mode. Follow by default the system.

Geolocation

You can enter your location in the settings panel, just enter: CITY, COUNTRY.
You can use the full name of the country or just the alpha-2 code ISO 3166.
When using the geolocation button, a request is made to IPinfo.io API to be able to get the city and country of you location. An internet connection is required.

This app use the Free plan from ipinfo.io, and can access up to 50k request/month.

Keyboard shortcut

You can use the following shortcuts:
Ctrl or Cmd + Alt + P Global shortcut to show/hide the app

Development

You will need a TOKEN from IPinfo.io.

// config.js

const TOKEN = 'your.token'
exports.TOKEN = TOKEN

---
// main.js

function geolocation () {
  console.log('Fetch geolocation via IPinfo.io.')
  // NOTE: Enter your TOKEN from IPinfo.io
  const TOKEN = config.TOKEN

  fetch(`https://ipinfo.io/json?token=${TOKEN}`)
    .then(res => res.json())
    .then(json => {
      // console.log(json.ip, json.city, json.country)
      store.setCityCountry(json.city, json.country)
    })
    .catch(err => console.log(err))
}

node-fetch v2.x is used because the ES Modules are not in use in this app.

Contributing

Contributions are welcome!

Translations

Follow these steps to translate the app in you language:

Create a folder with the 2 letters of your language in ./locales/
Copy this file (./locales/en/translation.json) in your folder
Start translating! :)

Note: the words between braces (e.g.:{{api}}) shouldn't be translated.

Available translations:

اَلْعَرَبِيَّةُ (Arabic)
বাংলা (Bangla)
English
Français (French)
Türkçe (Turkish)
O'zbek (Uzbek)

Credit | Dependencies

Electronjs.org
Menubar
electron-store
node-fetch
RESTful Prayer TImes API from Aladhan.com
IPinfo.io
Remix Icon
i18next internationalization framework
Logo: Islam by Olena Panasovska from NounProject.com

Donations

Donations can be made via cryptocurrencies:

XMR: 88TyfPkBEh44NFwdy5wMtv5M1aJFgNpWq4S97oZhSPwcCr4ah8cWyCRe8qE1Q3n9sAirVF23u6FkMCdSGiJSyLhHN5UcjcL
BTC: bc1qthw8u4he9zj6ajnfqxq6z5ang6w24hdds8j68r

Thank you!!

License

MIT

remahmoud/prayer-times-menubar-app