Roam Research Block Reference Counter

WHAT IT DOES

Roam Research Block Reference Counter scans the current page for Roam Research blocks, extracting block content, references, tags, and page information from Roam Research pages and graph views. The floating panel shows block reference counts, backlink counts, and orphan blocks (blocks without references). A summary of reference statistics is provided, highlighting heavily referenced and unreferenced blocks with suggestions for improving connectivity. Filter by page and tag, and export reference data as CSV or text. Reference trends are tracked over time, and blocks with high reference counts are highlighted.

WHERE IT RUNS

Works on Roam Research pages, including graph views, page views, and block references. The script detects blocks using Roam-specific selectors and extracts reference metadata. It works best on Roam Research graph and page views.

HOW TO USE

The panel displays a summary of block statistics (total blocks, referenced, orphans, average references) followed by a list of all blocks with their reference counts and backlinks. Each block shows its content, tags, reference count (color-coded green for high, yellow for medium, red for low/orphan), and backlink count. Click "Scan Blocks" to detect all blocks on the current page. Export the reference data as text for analysis or graph improvement. The panel highlights orphan blocks and suggests improvements for connectivity.

MECHANISM — BLOCK EXTRACTION WITH REFERENCE COUNTING

The script detects Roam blocks by finding block containers using selectors (.roam-block, .block). From each container, it extracts the block content, references ([[page]] patterns), tags (#tag patterns), and page context. Reference counting analyzes each block's content for links to other blocks and pages. Backlinks are calculated by checking which other blocks reference the current block. Orphan detection identifies blocks with zero references. The summary calculates total blocks, orphan count, referenced count, and average references. All extraction and counting runs client-side with no network calls.

THE PANEL

The floating panel is fully draggable and remembers its position per domain. Click the minimize button to collapse it to a small bubble, or press Escape to hide it. The panel automatically adjusts to different screen sizes and can be resized to show more content. All settings, including reference thresholds, are saved per domain. The panel integrates smoothly with any page layout using the BGPanel framework, maintaining clean separation from page content.

PLEASE NOTE

This script requires the free BotGentz extension to run. It does not send any data to external servers; all extracted block data, references, and settings remain entirely local to your browser using GM_setValue. The script never reads password fields, hidden inputs, or file inputs. It stores only block content, references, tags, and counts from publicly visible Roam Research page content. Block detection depends on the page structure; if blocks are not detected, use the "Scan Blocks" button to refresh extraction. The script works on Roam Research pages and detects pages by hostname. Reference counting is based on page content and may not capture all cross-graph references. Data persists across browser sessions and is isolated per browser profile.