Skip to content

Astrojorn/redstone-graph-view

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Redstone Graph View — SiYuan Plugin

A powerful graph visualization plugin for SiYuan Notes, inspired by Obsidian's graph view.


Author: @astrojorn

License: MIT — This plugin is open source. Feel free to use, modify, and distribute under the terms of the MIT license.

Repository: GitHub


Features / Recursos / 功能 / Características / Возможности

English

  • Cluster detection — automatically groups related pages by community
  • Color-coded clusters — each community gets a distinct color
  • Database nodes — databases appear as diamonds (◆) connected to their member pages
  • Local graph — shows only the current page and its direct connections
  • Straight lines — no curved edges, with optional parallel offset for overlapping connections
  • Live controls — adjust distance, cluster strength, and repulsion in real time
  • Titles toggle — show/hide node labels instantly
  • Arrows toggle — show/hide directional arrows
  • Fullscreen mode — expand to full screen with animation
  • Pin mode — lock panel position and size, persists across sessions
  • Resize handles — drag from any corner or edge to resize
  • Isolated nodes orbit — unconnected pages arrange in a ring around the main graph
  • Animated open/close — smooth scale and fade transitions
  • Disable native SiYuan graphs — option to hide the built-in Graph View and Global Graph
  • Customizable keyboard shortcut — Alt+G or Alt+Shift+G
  • 5 languages — English, 中文, Português, Español, Русский

Português

  • Detecção de clusters — agrupa automaticamente páginas relacionadas por comunidade
  • Clusters coloridos — cada comunidade recebe uma cor distinta
  • Nós de banco de dados — bancos de dados aparecem como diamantes (◆) conectados às suas páginas
  • Grafo local — mostra apenas a página atual e suas conexões diretas
  • Linhas retas — sem arestas curvas, com deslocamento paralelo opcional
  • Controles ao vivo — ajuste distância, força do cluster e repulsão em tempo real
  • Alternar títulos — mostra/esconde rótulos dos nós instantaneamente
  • Alternar setas — mostra/esconde setas direcionais
  • Tela cheia — expande para tela inteira com animação
  • Modo pin — trava posição e tamanho do painel, persiste entre sessões
  • Alças de redimensionamento — arraste por qualquer canto ou borda
  • Órbita de nós isolados — páginas não conectadas organizadas em anel
  • Abertura/fechamento animado — transições suaves de escala e opacidade
  • Desativar grafos nativos — opção para esconder o Graph View e Global Graph do SiYuan
  • Atalho personalizável — Alt+G ou Alt+Shift+G
  • 5 idiomas — English, 中文, Português, Español, Русский

Español

  • Detección de clusters — agrupa automáticamente páginas relacionadas por comunidad
  • Clusters coloreados — cada comunidad recibe un color distinto
  • Nodos de base de datos — bases de datos aparecen como diamantes (◆)
  • Grafo local — muestra solo la página actual y sus conexiones directas
  • Líneas rectas — sin bordes curvos, con desplazamiento paralelo opcional
  • Controles en vivo — ajusta distancia, fuerza del clúster y repulsión
  • Alternar títulos — muestra/oculta etiquetas al instante
  • Alternar flechas — muestra/oculta flechas direccionales
  • Pantalla completa — expande con animación
  • Modo pin — fija posición y tamaño del panel
  • Asas de redimensionamiento — arrastra desde cualquier esquina o borde
  • Nodos aislados en órbita — páginas no conectadas en anillo
  • Apertura/cierre animados — transiciones suaves
  • Desactivar grafos nativos — oculta Graph View y Global Graph de SiYuan
  • Atajo personalizable — Alt+G o Alt+Shift+G
  • 5 idiomas — English, 中文, Português, Español, Русский

中文

  • 聚类检测 — 自动按社区对相关页面进行分组
  • 彩色聚类 — 每个社区获得不同的颜色
  • 数据库节点 — 数据库显示为菱形 (◆)
  • 本地图谱 — 仅显示当前页面及其直接连接
  • 直线连接 — 无曲线边缘,可选平行偏移
  • 实时控制 — 实时调整距离、聚类强度和斥力
  • 标题切换 — 即时显示/隐藏节点标签
  • 箭头切换 — 显示/隐藏方向箭头
  • 全屏模式 — 带动画扩展至全屏
  • 固定模式 — 锁定面板位置和大小,跨会话持久化
  • 调整手柄 — 从任意角或边缘拖动调整大小
  • 孤立节点轨道 — 未连接页面排列成环状
  • 动画开/关 — 平滑的缩放和淡入淡出过渡
  • 禁用原生图谱 — 隐藏 SiYuan 内置的图谱视图和全局图谱
  • 可自定义快捷键 — Alt+G 或 Alt+Shift+G
  • 5种语言 — English, 中文, Português, Español, Русский

Русский

  • Обнаружение кластеров — автоматическая группировка связанных страниц
  • Цветные кластеры — каждая группа получает свой цвет
  • Узлы баз данных — базы данных отображаются ромбами (◆)
  • Локальный граф — показывает только текущую страницу и её связи
  • Прямые линии — без кривых, с опциональным параллельным смещением
  • Живые регуляторы — настройка расстояния, силы кластера и отталкивания
  • Переключение заголовков — показать/скрыть метки узлов
  • Переключение стрелок — показать/скрыть направленные стрелки
  • Полный экран — расширение на весь экран с анимацией
  • Режим пина — фиксация положения и размера панели
  • Ручки изменения размера — перетаскивание за любой угол или край
  • Орбита изолированных узлов — несвязанные страницы располагаются кольцом
  • Анимированное открытие/закрытие — плавные переходы
  • Отключение родных графов — скрыть встроенные Graph View и Global Graph
  • Настраиваемое сочетание клавиш — Alt+G или Alt+Shift+G
  • 5 языков — English, 中文, Português, Español, Русский

Installation / Instalação / Instalación / 安装 / Установка

Copy the plugin folder to: {workspace}/data/plugins/redstone-graph-view/

Then restart SiYuan or go to Settings → Marketplace → Installed and enable the plugin.

Usage / Uso / Uso / 使用 / Использование

Keyboard Shortcuts / Atalhos de teclado

Action Default Shortcut
Open/Close Graph Alt+Shift+G (or Alt+G when enabled in settings)
Toggle Fullscreen Alt+Shift+F

Panel Controls

Button Action
⚙️ Open settings (language, bar position, hide native graphs, shortcut)
📌 Pin panel position and size (persists across sessions)
Toggle fullscreen
Close panel

Graph Controls

  • Search — filter nodes by name
  • Titles — toggle node labels
  • Arrows — toggle directional arrows
  • ⊙ Local Graph — show only current page connections
  • ↺ Reload — refresh the graph
  • Dist slider — link distance
  • Cluster slider — grouping force
  • Repulsion slider — node repulsion

Settings / Configurações / Ajustes / 设置 / Настройки

Access via the ⚙️ button in the panel or via SiYuan Settings → Marketplace → Graph View.

  • Language / Idioma — interface language
  • Button position / Posição do botão — top bar, right sidebar, or both
  • Hide native graphs / Desativar grafos nativos — disable SiYuan's built-in Graph View and Global Graph (enabled by default)
  • Use Alt+G / Usar Alt+G — switch shortcut from Alt+Shift+G to Alt+G (enabled by default)

License / Licença / 许可证 / Лицензия

MIT License

Copyright (c) 2025 @astrojorn

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.


Made by @astrojorn — contributions welcome!

About

SiYuan Notes plugin - interactive graph view with community clustering, database diamonds, local graph, real-time D3 physics sliders, fullscreen, pin mode! 5 languages.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors