IREMINDER(1)

NAME
ireminder - Prayer time reminder

SYNOPSIS
ireminder [-ipraytime path] [-skip event_name] [-reminder minutes] [-inplace] [-execr cmd] [-execs cmd] [-help]

DESCRIPTION
The ireminder script is written in perl and is meant to be a simplistic wrapper to call and process the 'ipraytime' application. ireminder is used to remind the user via audio indicators of an impending Islamic prayer event.

OPTIONS
Some of the options within ireminder allow for list inputs, those are meant to be a quoted series of text/numbers.

-ipraytime path
    Specify the path to the ipraytime executable. Unless this options is specified, the script will default to look for the binary in /usr/bin, /usr/local/bin and the current directory.

-skip event_name
    Specify name of prayer/event to skip, valid options include "imsaak fajr shorooq zuhr asr maghrib isha" (list ok).

-reminder minutes
    Specify prior to how many minutes to remind (list ok).

-inplace
    Specify to print output in-place (without scrolling).

-execr cmd
    Specify an external application trigger for reminders. The %m directive is recognized and is substituted with the normal output message or string. The %s directive is recognized and is substituted by the salat's name.

-execs cmd
    Specify an external application trigger for when the salat reaches its appointed time (ie. "salat now"). The %m directive is recognized and is substituted with the normal output message or string. The %s directive is recognized and is substituted by the salat's name.

-help
    Produce a help screen.

EXAMPLES

Here is an example of using ireminder to display a message prayer time, ignoring imsaak and shorooq:
    ireminder -skip "imsaak shorooq" -execs "notify-send -t 1000000 \"Ireminder\" \"It is time for %s.\"" &

Another Example:
    ireminder -execr "xmessage %m" -execs "xmessage %m"

REPORTING BUGS
Report bugs on the web using http://bugs.arabeyes.org

AUTHOR
Written by Nadim Shaikli as part of the Arabeyes.org project.

COPYRIGHT
iremidner is subject to the GNU General Public License (GPL).
Copyright © 2006, Arabeyes, Nadim Shaikli.

SEE ALSO
ipraytime(1) - The underlying prayer times calculator used iremidner.

The ITL library (libitl) from the Islamic Tools and Libraries project. It is the underlying requirement for ireminder to function. The ITL library was created and is hosted at www.arabeyes.org.