# obsidian-occura-plugin (Krusty84/obsidian-occura-plugin)

> A community plugin for Obsidian that highlights every other occurrence of a word or phrase you double-click in the open note, so you can see how often it appears.

- GitHub: https://github.com/Krusty84/obsidian-occura-plugin
- GitHub.Locker page: https://github.locker/Krusty84/obsidian-occura-plugin
- Stars: 345
- Language: TypeScript
- License: MIT
- Last push: 2026-11-15

## Questions and answers

Written by GitHub.Locker from the README and the repository; check the README below for details.

**Is it a standalone app or something inside Obsidian?**

It is a plugin that runs inside Obsidian, not a separate program. You can install it from Community Plugins or copy its files into your vault manually.

**How do I get it running?**

Open Obsidian settings, go to Community Plugins, choose Browse, search for Occura Plugin, install it and turn it on. For a manual install, copy main.js and manifest.json into your vault's .obsidian/plugins/obsidian-occura-plugin/ folder and enable it in Community Plugins.

**Do I need anything besides Obsidian?**

No. The README mentions only Obsidian itself, with no extra services, accounts or API keys.

**Does it work in every Obsidian view?**

Not entirely. Automatic keyword highlighting, permanent highlighting and convert-to-tag commands work only in Source or Live Preview mode. Word-class highlighting also works in Reading View since version 1.6.0.

**Why did the author build this instead of using an existing tool?**

The author missed the Notepad++ and IDE habit of double-clicking a word to see how often it appears in the open document, and did not find an Obsidian plugin that did that.

**Can I group words into colored classes?**

Yes. Since 1.5.0 you can create word classes with individual colors, for example for terms from different domains or filler words, and add a selected word to a class from the context menu.

**Does it match phrases and ignore case?**

Yes. It highlights repeated phrases with spaces, not only single words, and has a case-insensitive mode. Keywords can be imported or exported as a comma-separated text file.

**Can I turn found occurrences into permanent highlights or tags?**

Yes. Commands can set or remove permanent highlights for occurrences, and another converts found occurrences into tags, all in Source or Live Preview mode.


---

## README (checked against GitHub 2026-11-18)

Source: https://github.com/Krusty84/obsidian-occura-plugin/blob/main/README.md

# Occura Plugin: highlighting word occurrences

### Why another plugin?

I couldn't find the usual functionality that I used in Notepad++ or different IDEs, where double-clicking on a word immediately showed me how often it appears in the open document.

### Features

#### Release 1.6.3

Support for Obsidian color schemes has been added, thanks to dear [werunom](https://github.com/werunom) for the idea.
<img width="647" height="121" alt="image" src="https://github.com/user-attachments/assets/085fa5ef-a675-43d3-9520-8d02c294bef4" />

<img width="637" height="488" alt="image" src="https://github.com/user-attachments/assets/4a62fe27-42c9-4b8e-a142-1e7b3745e60a" />

#### Release 1.6.2

This release stabilizes occurrence matching and navigation across Source Mode,
Live Preview, and Reading View. Counts now cover the complete note, Unicode word
boundaries are supported, short selections are debounced, and permanent
highlight/tag commands avoid protected Markdown regions.

Keyboard shortcuts are configured through **Obsidian Settings → Hotkeys**. Occura
does not install global keyboard handlers or reserve built-in Find shortcuts.

#### Release 1.6.1

No new features. Some issues has been fixed.

#### Release 1.6.0

New features has been added:

1. Dynamic occurrences highlighting, words classes highlighting now works in Reading View too, not only in Source or Live Preview mode
<img width="1136" height="229" alt="image" src="https://github.com/user-attachments/assets/721389e4-3511-4bd7-8534-efc91e1d07f2" />
<br>
<br>
2. Added navigation between occurrences with new commands and configurable hotkeys:
   - Go to next occurrence
   - Go to previous occurrence
<img width="1088" height="946" alt="image" src="https://github.com/user-attachments/assets/15118c60-09df-4031-95af-bfd883c2b50b" />
<br>
<br>
<img width="699" height="126" alt="image" src="https://github.com/user-attachments/assets/e28e427b-c882-4cbc-9619-bede5b30e89e" />
<br>
<br>
3. Added support for highlighting repeated phrases with spaces, not only single words
<img width="1092" height="749" alt="image" src="https://github.com/user-attachments/assets/866f81a3-d598-466d-aa2f-587fc81b93b9" />
<br>
<br>
<img width="723" height="240" alt="image" src="https://github.com/user-attachments/assets/8354833d-8501-4b18-b26c-e89cf2fec257" />
<br>
<br>
4. Added a context menu action to quickly add the selected word into an existing word class
<img width="457" height="411" alt="image" src="https://github.com/user-attachments/assets/6ed9b4e3-783b-4240-8ec7-de643a5d1901" />
<br>
<br>
<img width="710" height="145" alt="image" src="https://github.com/user-attachments/assets/9786bda4-14ed-408a-b212-2fd899adc576" />

#### Release 1.5.1

No new features. Various minor issues with Obsidian's expansion quality rating system have been resolved, I hope.
I'm preparing for more functionality, so stay tuned for updates.

#### Release 1.5.0

New features has been added:

1. You can create classes of words with individual colors, for example terms from different domains, parasite words, etc

<img width="1094" height="950" alt="image" src="https://github.com/user-attachments/assets/416f6e73-9175-43e0-81d0-d432d252cfa2" />

#### Release 1.4.1:

The issues with selecting special chartes like $ # % @ has beein fixed, thanks dear [Logovaz26](https://github.com/Logovaz26)

#### Release 1.4.0:

New features has been added:

1. Added case insensitivity mode for dynamic word selection

2. Keywords can be uploaded/downloaded to/from a plain text file with a comma separator between words

3. Added a reset button to default settings

<img width="843" alt="image" src="https://github.com/user-attachments/assets/57c9b219-1fe3-499b-8a4d-09a9e071e31b" />

#### Release 1.3.2:

Some bugs have been fixed, thanks dear [BlackUdon](https://github.com/BlackUdon)

#### Release 1.3.1:

Some bugs have been fixed, thanks dear [BlackUdon](https://github.com/BlackUdon)

#### Release 1.3.0:

Automatic highlighting of keywords (It works only in Source or Live preview mode!)

New settings has been added
![image](https://github.com/user-attachments/assets/3041fbf9-b258-421e-89aa-894bb025546e)

New command has been added

![image](https://github.com/user-attachments/assets/262ff0f5-bb12-4e13-880e-ffed812681bd)

#### Release 1.2.0:

Convert found occurrences to tags (It works only in Source or Live preview mode!)

New command has been added

![image](https://github.com/user-attachments/assets/d218a52d-3447-4676-baf1-9d7b5d212468)

#### Release 1.1.0:

Permanent Highlighting for found occurrences (It works only in Source or Live preview mode!)

New command has been added:

1. Set permanently highlight for occurrences
2. Remove permanently highlight for occurrences

![image](https://github.com/user-attachments/assets/93a04250-f060-437a-a887-31daa41abe80)

When Occura has highlighted the available occurrences, call the command: **Set permanently highlight for occurrences** and then the occurrences will be highlighted by the regular for Obsidian.md by color

![image](https://github.com/user-attachments/assets/1d638501-3477-4fe6-8166-48271c122520)

And call the: **Remove permanently highlight for occurrences** command to remove the previously set highlight

#### Release 1.0.0:

Basic functionality

- You simply double-click on a word and see the other occurrences of the word (or the selected part of it) highlighted.

  ![изображение](https://github.com/user-attachments/assets/164e0b3e-e02c-4903-abd5-a4006a931200)

- In the settings, you can specify the highlight color, hotkeys for quickly enabling/disabling the plugin, and the display of the number of matches found in the Status bar.

  ![изображение](https://github.com/user-attachments/assets/e6f33f63-a39b-4997-bae3-ba7cfa9c5b66)

#### Installing the plugin

- Open Obsidian settings
- Go to Community Plugins
- Select Browse and search for Occura Plugin
- Install the plugin
- Look through "Installed plugins" and enable Occura Plugin (toggle)

#### Manually installing the plugin

- Copy over `main.js` and `manifest.json` to your vault `/path/to/your/vault/.obsidian/plugins/obsidian-occura-plugin/`.
- Enable plugins in Obsidian settings
- Enable Occura Plugin in the Community Plugins tab

For platform and mode verification, see [MANUAL_TESTING.md](MANUAL_TESTING.md).

#### License

[MIT](https://choosealicense.com/licenses/mit/)

#### Author

[Alexey Sedoykin](https://www.linkedin.com/in/sedoykin/)

