Hasanah is a VS Code extension that brings the beauty of the Quran and Hadith directly into your coding environment. It displays random Ayahs (Quranic verses) and Hadiths at customizable intervals, helping you stay spiritually connected while you code.
- Daily Inspiration: Displays random Ayahs and Hadiths at customizable intervals.
- Dual Language Support: Choose between Arabic (
ar
) and English (en
) for Ayahs and Hadiths. - Hijri Date: Get the current Islamic date with a single command.
- Customizable Delay: Set the interval (in minutes) between notifications.
- Quick Access: Fetch specific Ayahs or Hadiths via the command palette.
- Open VS Code.
- Go to the Extensions view (
Ctrl+Shift+X
orCmd+Shift+X
on Mac). - Search for "Hasanah".
- Click Install.
You can configure Hasanah via VS Code settings:
- Open the Command Palette (
Ctrl+Shift+P
orCmd+Shift+P
on Mac). - Search for
Preferences: Open Settings (UI)
. - Search for
Hasanah
to customize:- Delay: Set the interval between notifications (default: 30 minutes).
- Language: Choose between Arabic (
ar
) and English (en
).
Alternatively, edit your settings.json
file:
{
"hasanah.delay": 30,
"hasanah.language": "ar"
}
hasanah.getAyah
: Fetch and display a specific Ayah.hasanah.getHijriDate
: Display the current Hijri date.
We welcome contributions! Here's how to get started:
- Fork the repository: oovaa/hasanah.
- Clone your fork and install dependencies:
npm install
- Make your changes and test them using VS Code's extension debugger.
- Submit a pull request with a detailed description of your changes.
- Node.js (v16+)
- VS Code (v1.93+)
If the text is too long, it may get truncated. We're working on a solution using webview panels for better display.
While Hasanah requires an internet connection to fetch new content, we're exploring offline caching for future releases.
To hide a popup in Hasanah, simply press the Esc
key on your keyboard. This will hide the popup and allow you to continue working without interruptions.
- Inspired by the "Ayat" extension.
- Special thanks to Abdul Baaki Hudu for English Hadith support.
- APIs used:
- AlQuran Cloud
- Hadith API
- English Hadith API (Experimental)
Hasanah is open-source software licensed under the MIT License.
May this project be a source of barakah in your coding journey. π
"And whoever does an atom's weight of good will see it." (Quran 99:7)
Enjoy!
A huge thank you to everyone who uses and supports this extension. Your feedback and contributions make it better every day. May your coding journey be filled with inspiration and productivity. and a special thank for you. π©·
Ψ΅Ψ―ΩΨ© Ψ¬Ψ§Ψ±ΩΨ© ΨΉΩ Ψ¬Ω ΩΨΉ Ψ§ΩΩ Ψ³ΩΩ ΩΩΨ ΩΨ³Ψ£ΩΩΩ Ψ§ΩΨ―ΨΉΨ§Ψ‘ ΩΩΩΨΉ Ψ§ΩΩΩ Ψ¨ΩΨ§ ΩΨ¨ΩΩ . π