Skip to content

Commit bd104c7

Browse files
Updated README
1 parent a674b8c commit bd104c7

File tree

1 file changed

+16
-42
lines changed

1 file changed

+16
-42
lines changed

README.md

Lines changed: 16 additions & 42 deletions
Original file line numberDiff line numberDiff line change
@@ -1,65 +1,39 @@
11
# Related Notes
22

3-
**Related Notes Finder** is an Obsidian plugin that intelligently suggests related notes by their meaning, helping you uncover hidden connections and insights within your knowledge vault. Built with privacy in mind, this plugin operates entirely on your local device—your data stays private and secure.
3+
Find notes with similar meaning intelligently, helping you uncover hidden connections and insights within your Obsidian vault. Built with privacy in mind, this plugin operates entirely on your local device—your data stays private and secure.
44

5-
<details>
6-
<summary>Note From the Creator</summary>
7-
This plugin excites me. For me, Obsidian’s greatest value lies in reducing the strain of writing. The whole Zettelkasten approach—don’t worry about structure, just focus on relationships—is an amazing method to capture thoughts and build a personal knowledge base. However, there’s still one significant pain point in my writing routine: relating notes. It’s challenging to remember existing notes (especially when you have over a thousand) and decide how to connect them. This plugin aims to ease that burden by presenting an overview of the most closely related notes in meaning—all while staying local and on-device, a core Obsidian principle that I deeply value.
8-
</details>
5+
![Screenshot](https://github.com/JoramMillenaar/obsidian-related-notes/raw/master/example.gif)
96

107

11-
<details>
12-
<summary>The Technology Behind Driving It</summary>
13-
I won’t delve into too much detail or documentation here, but I can’t help but rave about the incredible technology that powers this plugin. At its core is an AI that transforms sentences and paragraphs into representations that encapsulate not just the words but the meaning. These “meaning” representations are stored and used to calculate the closest neighbors in a multidimensional “meaning space.” This space is high-dimensional, enabling it to capture the many nuances of meaning embedded in language. It’s truly fascinating technology, offering immense potential to enhance both our minds and knowledge vaults!
14-
∂</details>
15-
16-
---
17-
18-
# 🚧 **Under Construction: Plugin in Development** 🚧
19-
20-
> ### ⚠️ **Notice: This Plugin is a Work in Progress!** ⚠️
21-
>
22-
> **This README outlines the intended functionality for the Related Notes Finder plugin, but the plugin is not yet fully operational as described.**
23-
>
24-
> I'm actively working to bring these features to life. Contributions are encouraged and appreciated! Feel free to dive in, experiment, and help shape the final product.
25-
26-
---
27-
288
## Features
299

3010
- **Fully Local and Private**: Your notes and data are never sent outside your device. All processing is done locally to ensure complete privacy.
31-
- **Automatic Note Linking**: The plugin analyzes your notes' content to suggest contextually related notes, without requiring manual tags or links.
32-
- **Easy Navigation**: Quickly access related notes in the sidebar to deepen your understanding and make connections across your knowledge.
3311

34-
## Installation
3512

36-
1. Open Obsidian and go to **Settings > Community plugins**.
37-
2. Click on **Browse** and search for "Related Notes Finder."
38-
3. Click **Install** and then **Enable** the plugin.
13+
## Settings
3914

40-
Alternatively, you can clone this repository and place it in your Obsidian plugins folder:
41-
```bash
42-
git clone https://github.com/JoramMillenaar/related-notes.git
43-
```
15+
Go to **Settings > Related Notes Finder** to customize the plugin’s behavior:
16+
- **Number of Related Notes**: Set how many notes to display as related.
17+
- **Plugin Server Port** (advanced): The plugin spins up a small local server for all the AI tricks. This determines which port to use for the local communication.
4418

45-
## Usage
4619

47-
1. With the plugin enabled, open any note in your Obsidian vault.
48-
2. Use the command palette (press `Ctrl/Cmd + P`) and type "Show Related Notes" to view suggestions based on the current note's content.
49-
3. Suggested notes will appear in the sidebar (or your preferred location), allowing you to explore related ideas and make new connections.
20+
## Usage
5021

51-
## Configuration
22+
1. When the plugin is initially enabled, it will automatically start forming the relations in the background. You can see the progress on the bottom right.
23+
2. After that is finished, open a note and find a new tab in the leaf of your note with a telescope icon. Here you should see the top-related notes as represented by the percentage of overlap in meaning.
24+
3. You can press on any of the notes in the list to navigate to.
25+
4. If you created a new note or you edited your current note, be sure to press the refresh button to update the relations. This will also let the other notes relate to your new changes.
5226

53-
Go to **Settings > Related Notes Finder** to customize the plugin’s behavior:
54-
- **Number of Related Notes**: Set how many notes to display as related.
27+
### Commands
28+
- Use the command palette (press `Ctrl/Cmd + P`) and type "Refresh relations of all notes" to reset all the relations. This could be useful if the relations seemed to have been corrupted (the plugin is still in development!).
5529

5630
## Privacy and Security
5731

5832
One of Obsidian's greatest strengths is its commitment to data ownership and privacy. This plugin upholds that philosophy by making privacy its highest priority. All processing and note relations happen entirely on your device, ensuring your notes stay yours—always.
5933

6034
**Related Notes Finder** is built with privacy at its core:
6135
- **Local Processing**: Every analysis and operation occurs directly on your device. Your notes never leave your vault.
62-
- **No Third-Party Dependencies**: The plugin requires no internet access or external APIs, providing a fully private and secure experience.
36+
- **No Third-Party Dependencies**: Once installed, the plugin requires no internet access or external APIs, providing a fully private and secure experience.
6337

6438
## Development
6539

@@ -83,9 +57,9 @@ For more information on developing Obsidian plugins, check out the [Obsidian Plu
8357

8458
## Contributing
8559

86-
Contributions are always welcome! If you have ideas for improvements or new features, please open an issue or submit a pull request to start a discussion.
60+
Contributions are very welcome! If you have ideas for improvements or new features, please open an issue or submit a pull request to start a discussion. I have plenty of ideas on powerful features to implement in the future, but I can use some help in getting the plugin to a stable point first.
8761

88-
This plugin relies on [relate-text](https://github.com/JoramMillenaar/relate-text) for much of its core logic. Contributions to this library are equally encouraged and will directly enhance the functionality of the plugin.
62+
At the momentm, this plugin relies on [relate-text](https://github.com/JoramMillenaar/relate-text) for much of its core logic. Contributions to this library are equally encouraged and will directly enhance the functionality of the plugin.
8963

9064
### TODO
9165
Here are the current development goals for the plugin:

0 commit comments

Comments
 (0)