Skip to content

This is a plugin for obsidian, to visualize files and tags as nodes in 3D graph.

License

Notifications You must be signed in to change notification settings

Slender4fun/obsidian-TagsRoutes

 
 

Repository files navigation

Obsidian plugin: TagsRoutes

GitHub Release GitHub Release

This is a plugin for obsidian, to visualize files and tags as nodes in 3D graphic.

Wiki: Organize Tags by Timestamp Using the Obsidian Plugin: "Tags Routes"

Version 1.0.6 Release Notes

This release brings two key improvements to enhance your user experience:

1. Focused Node View:

  • You can now toggle between a global and local view while focusing on a specific node.
  • Local view: Hides non-focused nodes, allowing you to concentrate on the selected node and its immediate connections. This declutters the scene and provides a clearer picture of the focused area.
  • Global view: Displays all nodes as usual.
  • Switch between these views easily to analyze your data from different perspectives.

2. Streamlined Interface:

  • The settings icon in the top right corner has been replaced with a more intuitive cycling button.
  • Click the button repeatedly to cycle through four different stages or functionalities. This change simplifies the interface and reduces visual clutter.

These updates aim to provide a more focused and efficient user experience. We hope you enjoy the improvements!

Watch this short demo to learn how to use these new features:

What's New on version 1.0.5

  1. Multiple Slots for Display Settings

    • You now have 5 slots to save your display settings. This allows you to quickly switch between them by dragging the slider.
      • So it likes that you have 5 themes to switch for better showing the graph in instance.
  2. Improved Query Function

    • The query function is now handled by a custom code block processor, eliminating the need for DataviewJS.
      • You can now delete the scripts/tag-report.js file and the scripts folder from your vault.
  3. Enhanced Tag Interaction

    • Clicking on a tag to focus on a node in the graph now works in edit mode as well.
  4. Other Fixes

    • Fix a ficker issue might occure, Refer here: kctekn#2 Thanks @ShaneNZ for the feecback.

How to operate:

nodes-operation.mp4
display-settings.mp4

This plugin provides a comprehensive graph view to visualize the relationships between files, file-tag connections, and inter-tag connections within Obsidian. It is particularly useful for users who manage extensive thoughts and ideas with numerous tags in Obsidian.

Features:

  • Node and Link Visualization :

    • Display all files and their links.

    • Display all tags and their connections, including:

      • Tag-to-tag links

      • Tag-to-file links

      • File-to-file links

  • Dynamic Node Sizing :

    • Adjust the size of file nodes based on the number of links.

    • Adjust the size of tag nodes based on their frequency of appearance.

This approach helps you identify the most significant parts of your vault at a glance.

Additional Functionalities:

  • Orphan File Linking :

    • Connect all orphan files, making them easier to review. Note that orphan files are not necessarily useless but are:
      • Non-markdown files with no links to other files.

      • For example, they could be isolated images from copy/paste operations or various collected items.

  • Orphan Excalidraw File Linking :

    • Connect all orphan Excalidraw files that are not linked by any markdown files, simplifying their review.

Interactive Features:

  • Node Interaction :

    • Click on a file node to open it in the editor, regardless of its file type.

    • Click on a tag node to generate a query result for that tag, displayed in a file in the editor.

      • Provides a clear view of the tag's content by capturing the surrounding lines until a blank line is encountered, showing the entire paragraph containing the tag.
  • Graph Focus :

    • Clicking on any file to open it in the editor will automatically focus the graph on its node.

    • Clicking on a tag in Obsidian's "Reading Mode" will focus on the tag node in the graph.

This allows you to clearly understand the status of files and tags through:

  • The file’s link status

  • The tags contained within the file

Adjustable Settings:

  • Focus distance on a node

  • Toggle tag query result page

  • Toggle log page

  • Display styles:

    • Link distance and width
    • Link particle size, number, and color
    • Node size and repulsion

Install

  • Search for "Tags routes" in Obsidian's community plugins browser, or you can find it HERE.
  • Choose to intall it.
  • You can also install it manually:
    • Download the release file, and extract to your obsidian's: valut/.obsidian/plugin/tags-routes.
  • Enable it in obsidian settings tab.

Acknowledgements

I would like to extend my sincere gratitude to the following projects, which provided invaluable resources and inspiration for this plugin:

About

This is a plugin for obsidian, to visualize files and tags as nodes in 3D graph.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • TypeScript 94.3%
  • CSS 3.0%
  • JavaScript 2.2%
  • Shell 0.5%