MH API

MH API is a Obsidian plugin that acts as a shared foundation for MH Obsidian plugins. It centralizes reusable interfaces, file operations, filters, automation, formatting, and integration helpers so consumer plugins can stay consistent and avoid duplicating the same behavior.

🌟 Features

• Native-looking settings, modals, searchable lists, draggable item lists, toggles, confirmations, exclusion lists, and context menus.
• Color, icon, date, time, and date-time pickers, including offline Obsidian icons and an optional online Lucide catalog.
• File, file-name, folder, tag, property, property-value, command, logic-folder, and custom suggesters for modals and text inputs.
• Rules and condition editors for properties, names, paths, folders, tags, timestamps, booleans, lists, and recurring dates.
• Reusable cards, headers, breadcrumbs, sidebars, search controls, view controls, and responsive layouts.
• Note information such as word counts, reading time, links, tags, properties, headings, tasks, dates, and file statistics.
• Automated note actions for properties, tags, aliases, CSS classes, text, tasks, files, templates, commands, notices, and clipboard values.
• Recent accessed, modified, and created file histories with filtering, persistence, and change listeners.
• Shared date and time formats, localization, IDs, cloning, relative-time formatting, recurrence helpers, and rule configuration utilities.

💡 Usage

See the MH API documentation for installation requirements, runtime access, every public feature, configuration options, and integration examples.

🛠️ Installation

Community Plugins

1. Open Settings → Community plugins.
2. Select Browse and search for MH API.
3. Select Install, then Enable.

BRAT

1. Install and enable BRAT.
2. Choose Add beta plugin in BRAT.
3. Enter this repository URL:

   https://github.com/heide-oficial/mh-api
   

4. Enable MH API in Settings → Community plugins.

Manual installation

1. Download main.js, manifest.json, and styles.css from the same GitHub release.
2. Create the following folder inside your vault:

   <vault>/.obsidian/plugins/mh-api/
   

3. Place the three downloaded files in that folder.
4. Reload Obsidian and enable MH API in Settings → Community plugins.

🔒 Privacy and disclosures

• No telemetry, analytics, advertisements, accounts, license keys, or closed-source components are used.
• The optional local + Lucide icon source requests icon metadata from https://unpkg.com; the default local icon source works offline.
• API operations may read, modify, move, create, or trash vault files only when invoked by the user or a consumer plugin.
• The settings tab loads the Ko-fi support banner from https://storage.ko-fi.com and includes an optional donation link.

🌎 Supported languages

• English (1.0.0+)
• Brazilian Portuguese (1.0.0+)

Help break the language barrier! Want to translate MH API into your language? Download the en.us.json language file, create a copy using the appropriate language code, and translate the text values without changing the keys. Once finished, submit the translated file through a GitHub pull request or attach it to a new GitHub issue. Your contribution will be credited in the project.

💖 Support

Please consider supporting my work. There are many hours of work, thinking and effort behind it. The two easiest ways to support the plugin are either by starring the repository or by donating any amount on Ko-fi. Thank you!

🤝 Credits

Created by Matheus Heidemann - heide-oficial.

📑 License

Licensed under the GNU General Public License v3.0.