AbdeltwabMF / next-prayer

Islamic prayer reminder for Unix status bars.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Next Prayer

Islamic prayers reminder for Linux status bar


Installation

1. Arch-based distributions

yay -S next-prayer

2. Build from source

git clone https://github.com/abdeltwabmf/next-prayer.git
cd next-prayer
make all install

3. Docker image

  1. Use Docker Hub image by running the following commands:
docker pull abdeltwabmf/next-prayer
docker tag abdeltwabmf/next-prayer next-prayer
docker run --rm next-prayer next-prayer --version
  1. Build it yourself by running the following commands:
git clone https://github.com/abdeltwabmf/next-prayer.git
cd next-prayer
docker build -t next-prayer .
docker run --rm next-prayer next-prayer --version

Configuration

  1. After updating your configuration file save it locally and run the following command to fetch API data:
docker run --rm -v /path/to/your/config:/home/nextprayer/.config/next-prayer/np_config.py -v /path/to/your/data:/home/nextprayer/.local/share/next-prayer next-prayer np_fetch.py
  1. Afterword run the following command:
docker run --rm -v /path/to/your/data:/home/nextprayer/.local/share/next-prayer next-prayer next-prayer [options...]

πŸ€” Usage

Usage: next-prayer [options...]

Options:
  --help       Display this help message.
  --version    Version name.
  --next       Next prayer time.
  --all        All timings.
  --prev       Previous prayer time.
  --left       Time left to next prayer.
  --elapsed    Elapsed time since last prayer.
  --adhan      True if adhan is playing now.
  --hijri      Hijri date.
  --hybrid     The elapsed time since the previous prayer as far as the elapsed time <= THRESHOLD.

Use next-prayer options with docker as follows:

docker run --rm next-prayer next-prayer [options...]

Setup (Status bar)

Here are some examples how to setup the status bar with next-prayer:

1. dwmblocks

🌟 Add this 4-element Block to the blocks[] array in your config.h.

static const Block blocks[] = {
  /*Icon*/  /*Command*/              /*Update Interval*/  /*Update Signal*/
  {"πŸ•Œ ",    "next-prayer --hybrid",  29,                  0}
}

2. i3blocks

🌟 Add this section to your i3blocks config file.

[next-prayer]
command=next-prayer --hybrid
interval=29
label=<span>πŸ•Œ </span>
color=#FF8105
border=#FF8105
border_top=1
border_right=0
border_bottom=0
border_left=0

πŸ‘€ If you're using the docker version Add docker run --rm next-prayer at the very beginning of your command.


🐣 Contributors

Abdeltwabmf
Abd El-Twab M. Fakhry
mazzensaadd
Mazen Saad
MustafaAmer-1
Mustafa Amer

⚠️ License

Licensed under the GPL-v3 License.

About

Islamic prayer reminder for Unix status bars.

License:GNU General Public License v3.0


Languages

Language:C 73.0%Language:C++ 15.6%Language:Python 3.8%Language:CMake 2.6%Language:Roff 2.2%Language:Makefile 1.3%Language:Shell 0.9%Language:Dockerfile 0.5%