Quran Life

by Imed Ghomari
5
4
3
2
1
Score: 57/100

Description

Category: Learning & Knowledge Management

The Quran Life plugin manages daily Qur'an review, visual mindmap memorization and Anki card export. It calculates an approximate daily verse target and review cycle from a selected Quran part and time goal, with reading and audio listening modes. Its editor stores surah and part mindmaps as individual files, alongside linked notes and verse groups, while import and export tools package selected material as shareable ZIP files. The Anki deck view creates APKG files and supports reimporting updated cards without losing review progress. Plugin data, recitation caches and downloaded offline audio remain in a fixed data folder that can be synchronised through vault file sync. The plugin is still under development, with rough edges, breaking changes and possible one time data migrations between versions.

Reviews

No reviews yet.

Stats

2
stars
2,405
downloads
0
forks
52
days
11
days
23
days
254
total PRs
10
open PRs
18
closed PRs
226
merged PRs
0
total issues
0
open issues
0
closed issues
1,040
commits

RequirementsExperimental

  • Anki 23.10 or newer on desktop or mobile

Latest Version

24 days ago

Changelog

Community review fixes

  • Fixed the two issues reported by the Obsidian community plugin review.
  • No visible changes — this release keeps Quran Life compliant with the latest review checks.

Full Changelog: https://github.com/imed-ghomari/quran-life/compare/1.0.36...1.0.37

README file from

Github

Quran Life — Obsidian Plugin

🚧 Under development — will be fully operational soon.

Quran Life is still being built and is not finished yet. Expect rough edges, breaking changes and one-time data migrations between versions. Feel free to try it. I'm working on the quran mindmaps. I'll add a way to import them directly to the plugin shortly. After that the plugin will be ready for use.

Daily Qur'an review, mindmap memorization and Anki export, autosaved to your vault.

Requires Anki (23.10 or newer, desktop or mobile). The plugin prepares your cards — daily reading, mindmaps, verse groups — and Anki handles all reviews and scheduling.

📖 Documentation: https://imed-ghomari.github.io/quran-life/ — user guides and mindmap symbol legend. ✍️ Blog: https://imed-ghomari.github.io/quran-life/blog — essays on the memorization method behind the plugin.

Installation

  1. Open Obsidian Settings → Community plugins and enable community plugins if prompted.
  2. Search for Quran Life and click Install, then Enable.

Manual install

  1. Download the latest release .zip from the releases page.
  2. Extract it into your vault's .obsidian/plugins/quran-life directory.
  3. Restart Obsidian and enable Quran Life in Settings → Community plugins.

Via BRAT

  1. Install the BRAT plugin and enable it.
  2. In BRAT settings, choose Add Beta plugin and paste this repository URL.
  3. Enable Quran Life in Settings → Community plugins.

Usage

Daily portion

  • In the plugin settings, choose the Quran part you want to review and your daily target in minutes.
  • The plugin computes an approximate number of verses per day and a full cycle length for the selected part, so you can pace your review.
  • Toggle between Listening (audio reciter) and Reading modes.

Mindmap memorization

  • Open a surah or part from the plugin's mindmap editor to create and edit visual memorization maps. Only surahs with a mindmap are exported, so always start here.
  • Mindmaps are stored as individual files in the plugin's data folder, so any file sync keeps them in sync across devices.

Anki export

  • From the plugin settings, configure the part order and surah-within-part order for the next export.
  • In the Anki Deck view, press Export to generate an .apkg file, then import it into Anki (double-click the file, or File → Import). Re-importing updates your cards without losing review progress — see the import walkthrough.

Mindmap import / export (sharing)

  • In the Anki Deck view, the MINDMAPS card has Import and Export buttons.
  • Import: choose a .zip file, tick what to bring in, then Import. Items you already have are skipped unless Replace existing is on. You can import several zips gradually — for example one per Quran part.
  • Export: tick your mindmaps, verse groups and notes, then Export. A supported .zip downloads (a copy is also saved in your vault) — send it to other users and they can bring it in with Import.

Storage

Everything the plugin stores lives in one folder — the plugin's own data folder inside Obsidian's configuration directory (<configDir> is .obsidian unless you renamed it):

<configDir>/plugins/quran-life/data/
├── assets/               # the Qur'an corpus, downloaded once on first run
├── splits/               # Anki split anchors, one file per surah
├── mindmaps/             # tldraw mindmaps: surah-, part- and meta-<n>.json
├── docs/                 # the markdown note belonging to each mindmap
├── daily/                # daily portion settings + per-part listening progress
├── recitation-cache/     # word-timing slices for offline playback
├── offline-audio/        # downloaded recitation audio, one folder per reciter
├── deleted-mindmaps.json # delete tombstones (stable deletes across syncs)
└── anki-export.json      # Anki export order preferences

Sync your vault to keep your data in sync across devices. It works best with Resilio Sync. It hasn't been tested with Syncthing or other sync services. Offline recitation audio downloaded from the settings tab lives inside the same data folder, in data/offline-audio/ — syncing the whole plugins/quran-life folder covers everything. The location is fixed — there is deliberately no setting to move it — so every vault and every device syncs exactly one predictable directory.

Older installs downloaded audio to <configDir>/plugins/quran-life/offline-audio/ (next to data/); the plugin moves it into data/offline-audio/ automatically on update — no action needed, and previously downloaded files keep working.

Development

npm run build

Release

npm run plugin:release

Releases are published from the main branch.

License

MIT © imed-ghomari

Similar Plugins

info
• Similar plugins are suggested based on the common tags between the plugins.
Mind Map
6 years ago by James Lynch
An Obsidian plugin for displaying markdown notes as mind maps using Markmap.
Markmind
5 years ago by Mark
A mind map, outline for obsidian,It support mobile and desktop
ExcaliBrain
4 years ago by Zsolt Viczian
A graph view to navigate your Obsidian vault
Enhancing Mindmap
5 years ago by Mark
obsidian plugin editable mindmap,you can edit mindmap on markdown file
Canvas Mindmap
4 years ago by Boninall
A plugin to make your canvas work like a mindmap.
Obsidian Mindmap Nextgen
4 years ago by VeroCloud Pty Ltd (original by James Lynch)
Create mind maps from your obsidian markdown files
Flashcards
6 years ago by Alex Colucci
🎴 An Anki plugin for Obsidian.md
Lovely-Mindmap
3 years ago by shaun
Build your own knowledge graph with smiles :-)
Mxmind Mindmap
3 years ago by mxmind
mxmind for obsidian plugin
Mindmap
3 years ago by YunXiaoYi
An Obsidian plugin for creating Mindmaps.
Aloud
3 years ago by Adrian Lyjak
Obsidian TTS Plugin
Yanki
2 years ago by Eric Mika
Obsidian plugin to sync flashcards from a folder in your vault to Anki. Pure Markdown syntax. No fuss.
Anki Sync
5 years ago by debanjandhar12
Obsidian plugin to make flashcards and sync them to Anki
Decks
9 months ago by Xherdi Lika
An Obsidian Flashcards plugin
Canvas Mindmap Helper
3 years ago by Tim Smart
Note Synchronizer
4 years ago by Songchen Tan
Synchronizes Obsidian notes to Anki in a breeze 💨️
MoreDraw
2 years ago by webceoboy2011
mordraw.com for obsidian plugin
Awesome Flashcard
4 years ago by AwesomeDog
Handy Anki integration for Obsidian.
Auto Anki
3 years ago by ad2969
Using AI to automate card creation for Spaced Repetion in Anki
gogoga Mind Map
a month ago by jackweigogoga
Obsidian plugin: edit Markdown notes as XMind-style mind maps.
Quran Lookup
4 years ago by Abu Ibrahim
Retrieve Quran verses in Obsidian.md easily with this simple text replacement plugin
QB Reader Parser
3 years ago by Jacob Barta
QBReader parsing for quiz bowl answerlines
Better Mind Map
a year ago by Utkarsh Raj
Obsidian plugin to for mind maps, vizualize current note as mind map.
Memorization
3 years ago by Joseph Cochran
AutoPause
3 months ago by ckep1
Allows only one audio track playing in Obsidian at a time, pausing the others.
text2anki-openai
4 years ago by Mani Batra
Anki Integration
2 years ago by Noah Boos AKA Rift
Create flashcards from your notes with a seamless interface, structuring them with metadata and syncing effortlessly via AnkiConnect.
Quran Helper
2 years ago by Ammar Alakkad
Obsidian plugin to find and insert any Quran Ayah (verse) in your notes
ASCII Tree Generator
2 years ago by Matěj Michálek
Blue Star
2 years ago by Wang Guoshi
A plugin for Obsidian that generates Anki flashcards in various ways.
Mappy
2 months ago by hiroyaiizuka
An Obsidian plugin to view and edit Markdown notes as linked, illustrated mind maps.
Memodack
2 years ago by Pavlo Kobyliatskyi
Your second language memory tool
Deck To Anki
a month ago by 熊猫别熬夜
Deck To Anki 是 Obsidian 中用来快速制作成Anki牌组的插件,通过 AnkiConnect 将笔记推送到 Anki。可以单向同步、更新、修改卡片,以及反向定位到 Obsidian 卡片所在的笔记、标题、块。
Qiaomu Radio
2 months ago by 向阳乔木
在 Obsidian 里发现和收听全球直播电台 | Discover and play live radio while you read, write, and think.
Noor
2 years ago by MKSherbini
Hadith Lookup
a year ago by Adnan Mukhtar
An Obsidian plugin that uses selected text as a reference ID to lookup and insert Quran and Hadith text and translation using the Hadith Unlocked API (https://hadithunlocked.com)
AI-AnkiSync
2 years ago by goev
OpenWords
a year ago by insile
用于英语学习中背单词与单词管理的 Obsidian 插件
Kindle Vocab
a year ago by Truong Gia Bao
Generate the markdown version of your Vocabulary Builder in Kindle, and put it in your Obsidian Vault.
Easy Recall
3 months ago by Geno Zhou
Anki Helper
9 months ago by Dusk
Note Player
24 days ago by xia-ataraxia
Obsidian plugin that plays note-backed playlists with YouTube (via yt-dlp), cached audio, and local files.