You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+16-42Lines changed: 16 additions & 42 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,65 +1,39 @@
1
1
# Related Notes
2
2
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.
4
4
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.
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
-
28
8
## Features
29
9
30
10
-**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.
33
11
34
-
## Installation
35
12
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
39
14
40
-
Alternatively, you can clone this repository and place it in your Obsidian plugins folder:
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.
44
18
45
-
## Usage
46
19
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
50
21
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.
52
26
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!).
55
29
56
30
## Privacy and Security
57
31
58
32
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.
59
33
60
34
**Related Notes Finder** is built with privacy at its core:
61
35
-**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.
63
37
64
38
## Development
65
39
@@ -83,9 +57,9 @@ For more information on developing Obsidian plugins, check out the [Obsidian Plu
83
57
84
58
## Contributing
85
59
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.
87
61
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.
89
63
90
64
### TODO
91
65
Here are the current development goals for the plugin:
0 commit comments