Obsidian Stats logoObsidian Stats

O-Tie

by Andre482
5
4
3
2
1
New Plugin
Install Code

Description

Build and edit risk bowtie diagrams in a visual editor with barriers, escalation factors, analysis stacks, and PNG export. - This plugin has not been manually reviewed by Obsidian staff.

Reviews

No reviews yet.

Stats

stars
downloads
0
forks
0
days
NaN
days
NaN
days
0
total PRs
0
open PRs
0
closed PRs
0
merged PRs
0
total issues
0
open issues
0
closed issues
0
commits

Latest Version

Invalid date

Changelog

See all version on GitHub

README file from

Github

O-Tie

Build and edit risk bowtie diagrams in Obsidian with an interactive visual editor. O-Tie is for bowtie risk analysis — a visual method used in process safety, operations, and HSE work to show how a hazard can lead to a top event (loss of control), which threats can cause it, which consequences may follow, and which barriers prevent or reduce harm.

Diagrams are stored as .bowtie files in your vault and auto-save as you edit.

Features

  • Interactive bowtie editor with fan-in/fan-out layout
  • Threats, prevention barriers, top event, mitigation barriers, consequences, and hazard
  • Escalation factors and escalation barriers
  • Per-barrier analysis stacks (type, effectiveness, criticality, and custom rows)
  • Toolbar: add elements, undo/redo, fit, zoom, PNG export, help
  • Inspector panel for label, notes, and delete
  • Pan and zoom on the canvas
  • Auto-save to .bowtie files

Bowtie structure

Threats → Prevention Barriers → Top Event → Mitigation Barriers → Consequences
                                      ↑
                                   Hazard

Installation

From Obsidian Community Plugins

  1. Open Settings → Community plugins.
  2. Turn off Restricted mode if needed.
  3. Click Browse, search for O-Tie, and install.
  4. Enable the plugin.

Manual installation

  1. Download main.js, manifest.json, and styles.css from the latest release.
  2. Copy them into <vault>/.obsidian/plugins/o-tie/.
  3. Reload Obsidian and enable O-Tie under Settings → Community plugins.

Usage

  1. Click the bowtie ribbon icon or run O-Tie: Create new bowtie.
  2. Enter a name — a .bowtie file opens in the editor.
  3. Edit on the diagram:
    • Toolbar: add threat, consequence, or barrier; fit; zoom; export; help
    • Double-click a node or title to rename
    • Click a node to inspect it in the bottom panel
    • Right-click for context menus
    • Hover nodes for quick add/delete buttons
    • Drag empty canvas space to pan; scroll to zoom
    • Delete removes the selected node
    • Ctrl+Z / Ctrl+Y for undo and redo
  4. Changes save automatically.

Settings

Open Settings → O-Tie to configure:

  • Default folder for new bowties
  • Column gap, row gap, node width, and node height

Commands

Command Description
Create new bowtie Create a new .bowtie file
Open bowtie file Open the active .bowtie file in the editor
Export bowtie as image Export the diagram as PNG

File format

.bowtie files are JSON. Example:

{
  "name": "Defective Steamcracker",
  "hazard": "High pressure ethylene",
  "topEvent": "Loss of containment",
  "threats": [{ "label": "Corrosion", "preventionBarriers": [] }],
  "consequences": [{ "label": "Fire", "mitigationBarriers": [] }],
  "view": { "zoom": 1, "panX": 0, "panY": 0 }
}

See examples/steamcracker.bowtie.

Changelog

See CHANGELOG.md.

Development

npm install
npm run dev    # watch mode
npm run build  # production build
npm run lint   # Obsidian plugin guidelines check

Third-party licenses

This plugin bundles html-to-image (MIT) for PNG export.

License

MIT — see LICENSE.

Sponsors