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

Installation

npm install -g iftar

Usage

Interactive Mode

Run without arguments to select a city interactively:

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!

Direct City Input

iftar istanbul

List All Cities

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:

$ iftar
? Select a city: ist
❯ Istanbul

$ iftar
? Select a city: ank
❯ Ankara

Commands

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

Development

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.