README file from
GithubMy Toolkit
An all-in-one productivity suite for Obsidian
Seven integrated modules — formatting, AI, image control, navigation, and focus — all in a single plugin.
Modules at a glance
| Module | Description | Shortcut | |
|---|---|---|---|
| 🎨 | Formatting Palette | 60+ elements in a searchable palette | Ctrl+Shift+F |
| 🤖 | AI Smart Suggestion | One-line continuation from context | Ctrl+Shift+G |
| 📐 | AI Template Generator | Full structured templates from a description | Ctrl+Shift+T |
| 🖼 | Image Control | Resize, align, rotate, caption, lightbox | Reading View |
| ⛶ | Fullscreen Note | Distraction-free writing + auto-fullscreen | Ctrl+Shift+Z |
| 🌳 | Premium File Tree | SF Symbols-style icons + image thumbnails | Sidebar |
| ⚡ | Quick Access Bar | Pinned one-click buttons above the file tree | Sidebar |
| 📁 | Folder Focus Mode | Zoom into a folder — hide everything else | Right-click |
🎨 Formatting Palette
Press Ctrl+Shift+F to open. Use ↑↓ to navigate, Enter to insert, Esc to close.
Categories: Insert · Callouts · Custom Callouts · Islamic (RTL) · Headings · Text · Lists · Code · Dividers
- Insert — Dates, times, progress bar generator, AI smart suggestion, AI template generator
- Callouts — All 12 built-in callouts (note, tip, warning, danger, bug…)
- Custom Callouts — Goal, Idea, Task, Formula, Remember, Blocker, Command, Config…
- Islamic — Ayah, Hadith, Dua with RTL layout and Arabic typography
- Headings — H1–H5
- Text — Bold, italic, highlight, strikethrough, inline code, subscript, superscript
- Lists — Bullet, numbered, task
- Code — Code block, math block
- Dividers — Line, double, dots, arrow, wave, dashed
🤖 AI Provider
Connect any OpenAI-compatible API — or run models locally for free with Ollama.
Supported providers:
| Provider | Notes |
|---|---|
| Ollama | Local, free — auto-fetches your installed models |
| OpenAI | gpt-4o-mini, gpt-4o… |
| Custom | OpenRouter, Groq, Anthropic proxy, or any /v1/chat/completions endpoint |
AI Smart Suggestion Ctrl+Shift+G
Reads the last 12 lines of context (or your selection) and suggests a single continuation — a callout, heading, checklist, or paragraph.
AI Template Generator Ctrl+Shift+T
Describe what you want to create, and the AI generates a complete structured markdown template.
Example: "Weekly meeting notes with action items" → Full template with headings, callouts, checklists, and placeholders
# Install: https://ollama.com
ollama pull qwen2.5:3b
ollama serve
# If you get a CORS error:
OLLAMA_ORIGINS="app://obsidian.md*" ollama serve
Then: Settings → AI Provider → Ollama → Fetch models → select model → Test Connection
🖼 Image Control
Click any image in Reading View to reveal a floating toolbar.
| Button | Action |
|---|---|
− / + |
Resize by 30 px steps |
⬤← ⬤ →⬤ |
Float left / center / float right |
↻ |
Rotate 90° |
✎ |
Add a caption |
⟲ |
Reset to original size and position |
⎘ |
Copy markdown link with current width |
⤢ |
Open fullscreen lightbox (pan · zoom · rotate) |
<div class="img-grid-2">...</div> <!-- 2-column grid -->
<div class="img-grid-3">...</div> <!-- 3-column grid -->
<div class="img-grid-4">...</div> <!-- 4-column grid -->
<div class="img-col">...</div> <!-- image + text column -->
<div class="img-col-right">...</div> <!-- reversed: text + image -->
<div class="img-caption">...</div> <!-- image with caption below -->
⛶ Fullscreen Note
Floating ⛶ button on every note. Toggle with Ctrl+Shift+Z.
Auto-fullscreen: Enters fullscreen automatically after a configurable inactivity period (5–120 s). A soft hint bar with a Cancel button appears 3 seconds before.
🌳 Premium File Tree
Apple-style SF Symbols-inspired icons for every file type — Markdown, PDF, Image, Video, Audio, Code, Archive, Canvas, Link, and plain text. Image files show a real 18×18 px thumbnail.
Row height: Compact / Default / Spacious
⚡ Quick Access Bar
A persistent bar of pinned buttons above the file tree. One click opens any note or folder.
Add items: + Add current file · + Add current folder · manual path input
📁 Folder Focus Mode
Right-click any folder → "📁 Focus on this folder" — the sidebar shows only that folder's contents. Everything else is hidden. Sub-folders start collapsed. A back button ("← All files") appears at the top to exit.
Main Folders tabs: Define top-level folders in Settings — they appear as tabs in a persistent bar above the tree. One click to focus, one click to exit.
Search, Graph View, and Quick Switcher (
Ctrl+O) always cover the full vault regardless of focus state.
Installation
From Community Plugins (coming soon)
Settings → Community Plugins → Browse → search My Toolkit → Install → Enable
Via BRAT (available now)
- Install BRAT
- BRAT → Add Beta Plugin →
ahmdmusa/obsidian-toolkit - Enable the plugin
Manual
- Download
main.js,styles.css,manifest.jsonfrom Releases - Copy to
<vault>/.obsidian/plugins/ahmed-toolkit/ - Restart Obsidian → Settings → Community Plugins → enable My Toolkit
Keyboard shortcuts
| Shortcut | Action |
|---|---|
Ctrl+Shift+F |
Formatting Palette |
Ctrl+Shift+Z |
Toggle Fullscreen |
Ctrl+Shift+G |
AI Smart Suggestion |
Ctrl+Shift+T |
AI Template Generator |
All shortcuts are remappable in Settings → Hotkeys.
Settings overview
| Section | Key options |
|---|---|
| 🎨 Formatting Palette | Enable / disable |
| 🖼 Image Control | Enable / disable |
| ⛶ Fullscreen Note | Enable, auto-fullscreen, inactivity timer (5–120 s) |
| 🤖 AI Provider | Provider, model (auto-fetch for Ollama), API key, response language, system prompt |
| 🌳 Premium File Tree | Enable, image thumbnails, row height |
| ⚡ Quick Access Bar | Enable, manage pinned items |
| 📁 Folder Focus Mode | Enable, manage main folder tabs (↑↓ to reorder) |
Compatibility
- Obsidian 0.15.0 or later
- Desktop and mobile
- Works with any community theme
Screenshots
🎨 Formatting Palette
🤖 AI Template Generator
⛶ Fullscreen Note
🤖 AI Provider Settings
🌳 Premium File Tree
⚡ Quick Access Bar
📁 Folder Focus Mode
⚡ Quick Access Bar Sidebar
مجموعة أدوات متكاملة — سبع وحدات في إضافة واحدة
| الوحدة | الوصف |
|---|---|
| 🎨 لوحة التنسيق | أكثر من 60 عنصر — Callouts، إسلاميات، عناوين، فواصل |
| 🤖 الذكاء الاصطناعي | اقتراح ذكي ومولّد قوالب كاملة |
| 🖼 التحكم في الصور | تكبير، محاذاة، تدوير، lightbox بالنقر |
| ⛶ ملء الشاشة | زر عائم + دخول تلقائي بعد فترة خمول |
| 🌳 شجرة الملفات | أيقونات SF Symbols + صور مصغّرة |
| ⚡ شريط الوصول السريع | أزرار ثابتة فوق الشجرة لأي ملف أو فولدر |
| 📁 وضع التركيز | كليك يمين على فولدر → يصبح جذر الـ sidebar |
التثبيت عبر BRAT
ahmdmusa/obsidian-toolkit
التثبيت اليدوي
انسخ الملفات إلى: <vault>/.obsidian/plugins/ahmed-toolkit/