Relation Sync
Alessandro Casnigo109 downloadsAutomatically syncs inverse relations in frontmatter. Define relation pairs like parent-child or spouse and the plugin keeps both sides in sync.
- Overview
- Scorecard
- Updates5
Relation Sync is a powerful Obsidian plugin that automates the management of bidirectional relationships within your vault's YAML frontmatter. Stop manually updating back-references; define your logic once and let the plugin handle the rest.
✨ Key Features
- 🔄 Automatic Bidirectional Syncing: Add a relation in one note, and the inverse is instantly added to the target note.
- 📚 Extensive Default Library: Over 50+ pre-configured relation pairs covering Family, Romantic, Professional, and Creative relationships.
- 🌍 Multi-Language Support: Fully localized in 8 languages (English, Italian, German, Spanish, French, Japanese, Portuguese, and Chinese).
- 🛠️ Fully Customizable: Define your own custom relation pairs (e.g.,
Villain↔Hero,Master↔Apprentice). - 📂 Multi-Value Aware: Handles both single links and arrays of links seamlessly.
- ⚡ Bulk Sync Tool: A specialized tool to scan and synchronize your entire vault in one click.
- 🎨 Modern Settings UI: Grouped, searchable, and filterable interface for effortless configuration.
🚀 How It Works
Imagine you are writing about your family. You add a link to your father in your note:
John Doe.md:
---
father: [[David Doe]]
---
Relation Sync will immediately detect this and update David's note:
David Doe.md:
---
child: [[John Doe]]
---
If you later change or remove the link, the plugin updates the corresponding inverse relation automatically, ensuring your graph remains perfectly consistent.
📂 Supported Categories
The plugin comes with a rich set of defaults grouped by category:
| Category | Examples |
|---|---|
| Family | Parent ↔ Child, Siblings, Spouses, Cousins, Grandparents |
| Romantic | Partner, Lover, Sweetheart, Ex-partner |
| Friendship | Best Friend, Roommate, Childhood Friend |
| Professional | Manager ↔ Employee, Colleague, Client ↔ Provider |
| Education | Teacher ↔ Student, Classmate, Mentor ↔ Mentee |
| Creative | Collaborator, Rival, Muse |
| Social | Neighbor, Acquaintance, Roommate |
⚙️ Installation
Community Plugins (Recommended)
- Open Settings in Obsidian.
- Go to Community plugins and click Browse.
- Search for
Relation Sync. - Click Install, then Enable.
Manual Installation
- Download the latest
main.js,manifest.json, andstyles.cssfrom the Releases page. - Create a folder named
relation-syncin your vault's.obsidian/plugins/directory. - Move the downloaded files into that folder.
- Reload Obsidian and enable the plugin in settings.
🛠️ Development
If you want to build the plugin yourself or contribute:
- Clone the repository.
- Run
npm installto install dependencies. - Run
npm run devto start the build process in watch mode. - Run
npm run buildfor a production release.
🤝 Contributing & Support
- Bugs & Features: Please open an issue on the GitHub repository.
- Localization: If you'd like to help translate the plugin into more languages, contributions to the
src/localesdirectory are welcome! - Support: If you find this plugin useful, consider supporting development.
Developed with ❤️ by casungo