Iftar Command Line Tools
npm install iftar
A fast and simple CLI tool for checking iftar and suhoor times in Turkish cities.
``bash`
npm install -g iftar
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!
`
`bash`
iftar istanbul
`bash`
iftar list
`
š Available Cities:
Adana Adiyaman Afyonkarahisar Agri
Aksaray Amasya Ankara Antalya
...
`
- 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
The interactive mode supports fuzzy search:
`bash`
$ iftar
? Select a city: ist
⯠Istanbul
`bash`
$ iftar
? Select a city: ank
⯠Ankara
| Command | Description |
| -------------- | ------------------------ |
| iftar | Interactive city picker |iftar
| | Get times for a city |iftar list
| | List all available cities|iftar --help
| | Show help |
`bash``
git clone https://github.com/eneserdogan/iftar.git
cd iftar
npm install
node index.js
Contributions are welcome! Please feel free to submit a Pull Request.
See the Releases section for changelogs.
GPL-3.0 - see LICENSE for details.