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 and 1:1 line-break mapping.

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

Select any text inside a note card or the input box and a floating toolbar appears above your selection. Click a format button to wrap the selected text in the matching markdown syntax.

• Bold — wraps selection in **...**
• Italic — wraps selection in *...*
• Inline code — wraps selection in `...`
• Link — wraps selection in [...](url), prompts for the URL
• Bullet list — prefixes each line with -
• Numbered list — prefixes each line with 1. 2. 3.
• Checkbox — prefixes each line with - [ ]

Hold Alt and right-click any card to enter multi-select mode. Cards show a marching-ants selection border. Continue Alt+right-clicking to add more cards to the selection.

• Delete selected — permanently removes all selected cards.
• Archive selected — moves all selected cards to the archive.
• Start session — launches a focused Session with only the selected cards visible; everything else blurs out.

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.

Experimental features are enabled in Settings → Advanced → Experimental. They are fully functional but may change behaviour, get redesigned, or be promoted to core settings based on feedback. Nothing here is unstable — just not yet finalised.

Controls how the per-card action bar (archive, delete, reminder, edit) appears on note cards.

V1 — Click to reveal

Action buttons appear only after you click a dedicated button on the card. Keeps cards clean and avoids accidental taps.

V2 — Hover to reveal (default)

Action buttons fade in as soon as you hover over the card. Faster for power users, minimal extra visual noise.

A slider in Settings → Advanced → Experimental lets you set the base font size for note content, from 12px (compact) to 18px (large). The live preview updates as you drag.

On multi-monitor setups, Madhav's panel defaults to the primary display. The Display Picker lets you anchor it to any connected monitor. Detected displays are shown as numbered pills — tap one to move the panel.

The panel repositions immediately. Hover and peek behaviour adapt to the chosen display's edges and work area.

Switch the panel between the right edge (default) and left edge of your screen. A two-button pill toggle in Settings → Advanced → Experimental controls this.

• ← Left edge — panel slides from the left. Useful if your primary workflow is left-aligned or you have a second monitor on the right.
• Right edge → — default. Panel slides from the right edge.

Adjust the top and bottom internal padding of the panel. Useful if you have a large menu bar, a taskbar on top, or prefer more breathing room. Set in Settings → Advanced → Experimental → Screen margins.

Values are stored as AppSettings.topMargin and AppSettings.bottomMargin (in pixels). Default is 0 for both.

Choose which thought type is pre-selected when you open the note input. Set in Settings → Advanced → Experimental → Default category.

• Uncategorized (default) — no type pre-assigned, pick later.
• Task — useful if most of what you capture are to-dos.
• Note — good for knowledge-capture workflows.
• Idea — great for creative or brainstorm-heavy sessions.
• Bookmark — pre-selects Bookmark type for URL-heavy capture sessions.

Toggle off the animated intro video that plays on launch. Useful if you launch Madhav frequently and want it to open directly to the panel without the intro delay.

Setting is in Settings → Advanced → Experimental → Disable splash screen. Takes effect on the next app restart.

These features are planned and actively being explored. They're not in the app yet, but are on the development roadmap. Have feedback or want to influence priority? Join the Discord or Telegram community.

Sync Tasks and reminders set in Madhav directly to your Google Calendar. Create an event from a Task in one tap, and see your calendar events as context alongside your notes.

• Convert any Task to a Google Calendar event from the card action bar.
• Reminders set via the Telegram bot appear on your calendar automatically.
• Two-way: completing a task in Madhav marks the event done; dismissing a calendar event can archive the task.
• OAuth 2.0 — you connect your Google account once in Settings. No credentials are stored by Madhav servers.