Everything about Madhav.

Madhav has three panel modes. Switch between them in Settings → Panel Behavior.

Hover mode

The panel hides at the right edge of your screen and slides in when your cursor touches the edge. Move away and it slides back. Perfect if you want zero distraction while working.

Fixed mode

The panel stays open at all times. Best for single-monitor setups or when you're actively using Madhav throughout the day.

Hotkey mode

The panel is hidden by default. Press your configured hotkey (default: Alt+M) to toggle it open or closed. Clicking outside the panel also closes it automatically.

Customise the panel in Settings → Appearance:

• Width — drag the slider from 280px to 520px. The panel resizes live.
• Background image or video — upload any photo or MP4. Use the crop overlay to choose which part shows inside the panel.
• Backdrop blur — slider from 0 to 40px. Higher blur creates a stronger frosted-glass look.
• Background opacity — controls how much the background shows through.

Madhav lives in the Windows system tray (bottom-right clock area). Right-click the tray icon to:

• Reset Panel Behavior — returns to Fixed mode (useful if panel is stuck hidden).
• Quit — fully exits Madhav.

Every item in Madhav is a Thought. Thoughts have a type that determines how they're displayed and filtered:

• 📝 Note — freeform text, markdown supported.
• ✅ Task — has a checkbox. Mark done, and the card auto-collapses and moves to a Completed section.
• 💡 Idea — same as Note, different visual accent for quick scanning.
• 🔖 Bookmark — paste a URL and Madhav fetches a rich preview (favicon, title, description, cover image).
• Uncategorized — the default. Assign a type later when you know what it is.

The Add Note input is always at the top of the panel. Click it, type, and press Ctrl+Enter to save. Use the category dropdown to pick a type before saving, or use a keyboard shortcut.

• Ctrl+1 — save as Uncategorized
• Ctrl+2 — save as Task
• Ctrl+3 — save as Note
• Ctrl+4 — save as Bookmark
• Ctrl+5 — save as Idea

Markdown is supported: **bold**, *italic*, `code`, - lists, # headings, [links](url), > quotes. A live preview appears as you type.

Press Alt+C from anywhere on your desktop — a floating capture window appears instantly without opening the full panel. Type your thought, pick a category, press Ctrl+Enter to save. The card animates away toward the sidebar. Press Esc to cancel.

• Works from any app — games, browser, code editor, anything.
• The window can be dragged by its top bar.
• Shortcut is configurable in Settings → Shortcuts → Quick Capture.

Select any text in any application, then press Alt+S. Madhav reads your clipboard and saves the selection as an Uncategorized note instantly. A Windows notification confirms the save.

Works in browsers, PDF viewers, code editors, Word, Excel — any app that supports text selection and copy.

Press Alt+Shift+S to open a full-screen snip overlay. Draw a rectangle around any text on screen — menu items, dialog boxes, images, screenshots. Release the mouse and the overlay closes instantly.

Madhav runs Tesseract OCR in the background and saves the detected text. Smart category detection applies automatically:

• URL detected → saved as Bookmark with https:// prefix.
• Bullet list detected → saved as Task with markdown formatting.
• Everything else → saved as Uncategorized.

All thought types support GitHub-flavoured markdown. The panel renders it with syntax highlighting.

• **bold text** → bold
• *italic text* → italic
• `inline code` → code
• - item or * item → bullet list
• 1. item → numbered list
• # Heading → heading
• > quote → blockquote
• [text](url) → link

Press the M button in the note input to open a quick reference card showing all supported syntax.

Create a Task thought and you get a checkbox. Click the checkbox to mark it done. The card automatically collapses and moves to a Completed section at the bottom of your list.

• Uncompleting a task expands it back to its original position.
• Completed tasks are grouped in a collapsible 'Completed · N' section.
• The section is collapsed by default — keeps your active list clean.
• Completed cards render at 60% opacity so you can tell at a glance what's done.

Set a reminder on any thought via the bell icon in the card action bar. Choose a time and Madhav fires a Windows desktop notification + a Telegram message at that time.

Save any URL as a Bookmark thought and Madhav automatically fetches a rich preview:

• Favicon from Google's favicon service.
• Page title and description (2-line clamp).
• Cover image (og:image) as a banner.
• A teal domain badge.
• Hover the card → a 'Visit ↗' button appears to open the link in your browser.

Twitter / X links use the public oEmbed API to show the author name and tweet text.

Click the search icon (🔍) in the filter bar to open the search input. Type to filter your thoughts in real time. Matched text is highlighted in amber directly inside rendered cards — works inside markdown.

Press Escape to close search and clear the query. Search stacks with category filters.

Click the Filter button to open a dropdown with checkboxes for each category. Select multiple types to filter by. Active filters appear as dismissible chips below the button.

• All filter types can be combined.
• Tasks have two sub-filters: Completed Tasks and Open Tasks.
• Filters and search both apply simultaneously.
• Press Escape to close the filter dropdown.

Archive a card with the archive button to soft-remove it from your main list without deleting it. Archived thoughts never load unless you explicitly select the 'Archived' filter — zero bandwidth cost until you need them.

From Telegram: /archive lists your last 10 archived thoughts.

Madhav uses a Convex cloud backend as the sync layer. Your thoughts are stored there (encrypted) and available to both the desktop app and the Telegram bot simultaneously — even when the app is closed.

• Desktop → Telegram: Every thought you add on desktop is pushed to your Telegram chat instantly.
• Telegram → Desktop: Send any message to @MadhavBot, pick a category, and it appears in the panel in real time.
• Always-on: The Telegram bot is hosted on Convex — it works 24/7 even when your PC is off.

Every thought pushed to Telegram has inline action buttons:

• Done / Undo — mark a task complete or revert it.
• Edit — tap to enter Editing Mode, then send the new text to update the thought.
• Del — delete the thought from both Telegram and the desktop.
• Copy Content — silently copies the text to your clipboard (no message sent).

Madhav notifies your Telegram chat when you make changes on desktop:

• Edit content → ✏️ Note updated + preview.
• Change category → 🏷️ Recategorized + preview.
• Complete a task → ✅ Task completed + preview.
• Set a reminder → 🔔 Reminder set + time.

All thoughts created on desktop are encrypted with AES-256-GCM before leaving your device. The encryption key is generated locally on first launch and stored only on your machine — it is never sent to any server.

Even the developer cannot read your note content. Convex stores only encrypted ciphertext.

• Algorithm: AES-256-GCM (Node.js crypto module).
• Your key: 30 hex characters in 6 groups (e.g. XXXXX-XXXXX-XXXXX-XXXXX-XXXXX-XXXXX).
• Telegram-created notes are stored plaintext (your Telegram account is already trusted).

Your encryption key is shown once during onboarding. Save it somewhere safe — if you lose your device, you'll need it to decrypt your thoughts on a new machine.

To view or recover your key: Settings → Advanced → Encryption Key. Paste your saved key in the Recovery field and restart the app.

Madhav checks for updates from GitHub Releases automatically on startup. If a new version is available, it downloads silently in the background and shows a banner at the bottom of the panel when ready.

• Click 'Restart Now' to install immediately.
• Dismiss the banner — the update installs automatically the next time you quit Madhav.
• The 'Latest ↗' link in the update section always opens the GitHub Releases page.

All global shortcuts are configurable in Settings → Shortcuts.