8bitgentleman / roam-depot-send-to-graph

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

A Roam Research extension to send blocks from one graph to another. The destination graph does not need to be open. This is a one-way push. The blocks are added to the new graph as if you had created them manually yourself.

Features

  • Send blocks to another graph with a simple right-click command or via hotkey.
  • Configure multiple graphs to send blocks to.
  • Option to nest sent blocks under a parent block (for example an #inbox tag) in the destination graph.

Setup

This extension uses the new Roam backend API to allow sending of blocks to graphs that you do not have open. Note: only the creator of a graph can create new API tokens.

  1. In your destination graph go to the Graph Settings page and select New API Token
  2. Name the token however you want but make sure to set the Access Scope to Edit Access. This gives the extention edit permissions to the graph.
    • Note: When sending blocks I ONLY add to the destination graph. There is no code to modify or delete ANYTHING.
  3. Select Create to generate your unique graph API token. Make sure to save the generated token before navigating away as it is not possible to see the token again once you have navigated away.
  4. Open up the Source Graph and navigate to the Send To Graph settings page.
  5. Add the Graph name and Edit Access token for the destination graph to the settings panel and hit the plus symbol. If either of these is incorrect in any way blocks you attempt to send will not go through. You can add as many graphs as you like.

Usage

There are 2 ways of using the Send-To-Graph extension:

  1. Right-click on a block and select "Send to Graph". If you have multiple graphs configured, you will be asked to select the destination graph.
  2. Alternatively, assign a hotkey via the settings panel to send the currently focused block to another graph.

Example

example.mp4

About

License:MIT License


Languages

Language:JavaScript 93.9%Language:CSS 6.0%Language:Shell 0.1%