iftar

A fast and simple CLI tool for checking iftar and suhoor times in Turkish cities.

Installation

``bash
npm install -g iftar
`

Usage

$3

Run without arguments to select a city interactively:

`bash
iftar
`

`
? Select a city: Istanbul

🌙 IFTAR TIME INFO

📍 City: Istanbul
📅 Date: March 15, 2025 (Saturday)
🌙 Hijri: 15 Ramadan 1446

🌅 Suhoor: 05:32
🌆 Iftar: 18:24
⏱️ Duration: 12h 52m

⏳ 5h 31m remaining!
`

$3

`bash
iftar istanbul
`

$3

`bash
iftar list
`

`
📍 Available Cities:

Adana Adiyaman Afyonkarahisar Agri
Aksaray Amasya Ankara Antalya
...
`

Features

- Interactive Selection: Fuzzy search with autocomplete
- 81 Turkish Cities: All provinces supported
- Hijri Date: Islamic calendar date display
- Time Remaining: Countdown to iftar
- Fasting Duration: Total fasting hours

Autocomplete

The interactive mode supports fuzzy search:

`bash
$ iftar
? Select a city: ist
❯ Istanbul
`

`bash
$ iftar
? Select a city: ank
❯ Ankara
`

Commands

| Command | Description |
| -------------- | ------------------------ |
| iftar | Interactive city picker |
| iftar | Get times for a city |
| iftar list | List all available cities|
| iftar --help | Show help |

Development

`bash
git clone https://github.com/eneserdogan/iftar.git
cd iftar
npm install
node index.js
``

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Version

See the Releases section for changelogs.

License

GPL-3.0 - see LICENSE for details.