wrenger / obsidian-languagetool

LanguageTool Plugin for Obsidian
GNU Affero General Public License v3.0
12 stars 1 forks source link

Obsidian LanguageTool Plugin

This plugin for Obsidian.md integrates LanguageTool to provide advanced grammar and spellchecking.

This is a fork of the original obsidian-languagetool-plugin, with the following changes:

  • Added support for synonyms and mother tongue
  • Add tooltip button for disabling rules
  • Remove old code and clean up the codebase, following Obsidian's best practices
  • Fix multiple bugs and freezes

Note: if you are worried about the privacy of your notes, you should self-host LanguageTool locally on your PC or on a server. If you decide to self-host the service, you must change the link in the configuration accordingly.

Installation

  1. In Obsidian, under Settings / Community plugins, turn off "Safe mode" (read the safety warning).
  2. Click the Browse button for Community plugins.
  3. In the top-left search field, search for "LanguageTool". Click the Install button.
  4. After the installation is successful, click Enable to enable the plugin.

Setting Up & Use Case

After installing and enabling the plugin, you can set up hotkeys (under Settings / Hotkeys), which can be found under the description "LanguageTool" through the Filter search field, to find specific hotkey functions quicker. Ensure no conflict exists with existing hotkeys and the spellcheck function within Obsidian if enabled (Settings / Editor / Spellcheck ON/OFF).

LanguageTool tries to auto-detect the language used. Selecting a specific language (under Settings / LanguageTool / Static language) usually is not necessary. This feature enables the user to spellcheck in different languages within the same document (e.g., a dissertation written in English with quotes in a foreign language), which is ordinarily not possible with the built-in spellcheck function of Obsidian.

You can also specify a document language in the properties of a document. Just add a property (usually crtl+;) with the name lt_language and a language code (en-US, de-DE, ...) as value.

Custom Spellchecker Dictionary: You can add words to this dictionary directly from the editor and remove them again in the Obsidian settings (Settings / LanguageTool / Spellcheck Dictionary).

Premium Accounts

We support LanguageTool Premium.

⚠️ Please report any bugs, issues, or suggestions related to this Plugin to us (this GitHub Repository) directly and not to LanguageTool, as this is an unofficial community plugin

You (obviously) need a Premium Account and an API key to use the premium features. You can generate your API key at https://languagetool.org/editor/settings/access-tokens

Configure your email, API key, and the new URL (https://api.languagetoolplus.com) in the plugin settings

Manually installing the plugin