Qurany
Qurany brings a focused Quran player into the VS Code sidebar, so you can listen, switch reciters, and keep your place without leaving the editor.
What It Does
- Plays Quran recitations directly inside VS Code
- Lets you choose the surah and reciter from dedicated picker screens
- Shows the current ayah while the audio is playing
- Remembers where you stopped and resumes later
- Saves favorite surahs and reciters for quick access
- Gives you quick play or pause control from the status bar
- Lets you choose what happens after a surah ends: play once, go next, or loop
- Supports English and Arabic UI
Screenshots
Main Player
The player keeps everything in one place: now playing, current ayah, playback controls, volume, and quick access to surah and reciter selection.
Surah Picker
Browse surahs in a full-height picker instead of expanding the player layout. Favorites can be filtered with one tap.
Reciter Picker
Switch reciters from a dedicated screen and keep the experience focused and easy to scan.
Why It Is Useful
- You stay inside VS Code instead of jumping to a browser or another app
- The player is always one click away in the Activity Bar
- Long listening sessions are easier because progress is saved across sessions
- Favorite surahs and reciters are right there when you need them again
Install
From A VSIX File
- Open VS Code
- Run
Extensions: Install from VSIX
- Pick the latest
qurany-<version>.vsix file
- Open
Qurany from the Activity Bar
How To Use It
- Open the
Qurany icon in the Activity Bar
- Pick a surah
- Pick a reciter
- Press play
- Use the star buttons to save favorites
Qurany automatically keeps your last position, your favorites, and your current player state locally.
Notes
- Internet access is required for audio streaming
- Ayah-by-ayah sync depends on timing support for the selected reciter
- Audio is streamed, not downloaded for offline playback
Build A VSIX
If you want to package the extension yourself:
npm install
npm run build:vsix
The packaged extension will be created in the project root as:
qurany-<version>.vsix
If you want screenshots to render in the installed extension details page, package with public HTTPS image URLs by setting:
$env:QURANY_BASE_IMAGES_URL="https://raw.githubusercontent.com/<user>/<repo>/main/"
$env:QURANY_BASE_CONTENT_URL="https://github.com/<user>/<repo>/blob/main/"
npm run build:vsix
License
MIT
