TWITTER

The Twitter integration connects your Roam graph to Twitter!

This extension is avaiable in Roam Depot! Install it directly from Roam by navigating to Settings > RoamDepot > Browse. To help test a development version of the extension before it's available in Roam Depot, click here to download.

Twitter

Connects your Roam graph to Twitter!

Usage

The RoamJS Twitter extension allows you to use your Roam graph as a client to your Twitter account! Included in this extension is the ability to:

  1. Send Tweets
  2. Schedule Tweets
  3. Import Tweets

Sending Tweets

In the Roam Depot Settings, a log in with Twitter button will be rendered on the configuration screen. Clicking the button will create a popup window, prompting you to authorize RoamJS to be able to send tweets on your behalf. You may need to allow popups from Roam for this to work.

To send a tweet, create a {{tweet}} button and nest the content of the tweet as a child.

The button will be replaced with a Twitter icon. Clicking the icon will render an overlay with a "Send Tweet" button.

Clicking "Send Tweet" will send the first child as the content of the Tweet! If the tweet button has multiple children, clicking "Send Tweet" will send each block as a tweet as part of a single Tweet thread.

Images, gifs, or videos in the Roam Block inline with the rest of the tweet, will be uploaded as media embedded in the tweet! The ![](url) block text will be stripped from the tweet content. Up to four images, one gif, or one video are allowed by Twitter.

After Sending

There are various behaviours you could configure to occur after tweets are successfully sent.

It could be useful to denote which blocks in Roam have already been sent by moving them to another page or block reference after sending. On Roam Depot Settings, you could add a block reference to the Sent Tweets Parent field to denote where your tweet blocks in Roam should move to after they have been successfully sent

This will move all the blocks sent as children of this block upon sending.

The label each Sent tweet thread uses could be configured with the Sent Tweets Label field. It supports the following placeholders:

  • {now} - Replaces with the current time

Instead of moving blocks to a configured destination, tweeted blocks could instead be edited upon sending. In the Roam Depot Settings, editing the Append After Tweet field will specify text that will get added to the end of the tweet after sending. It supports the following placeholders:

  • {link} - The link of the published tweet.

Instead of appending text to individual tweet blocks, you could append text to the parent block of the tweet thread. This could be configured in the Append To Parent field in Roam Depot Settings. It supports the following placeholders:

  • {link} - The link of the first tweet of the thread
  • {now} - The time the tweet was successfully sent.

Demo

View on Loom

Scheduling

With this feature enabled, you could schedule Tweets to be sent at a later date directly from within Roam. You should see a new option to schedule a tweet:

This will store your tweet thread in RoamJS to be sent at the time you specify. To view all of your current tweet threads, enter Open Scheduled Tweets from the Roam Command Palette:

For each scheduled tweet, you will see a clickable block reference pointing to the source tweet, the time you created the schedule, the time you scheduled the tweet for, and the current status. There are three statuses:

  • SUCCESS - Your scheduled tweet was successfully sent and clicking this status will take you to the link on Twitter
  • PENDING - Your tweet is still scheduled to be sent.
  • FAILED - Your tweet failed to send. Please contact support@roamjs.com for help with this issue.

Demo

View on Loom

Twitter Feed

You could configure the extension to show a feed of all tweets you liked the previous day upon opening your daily notes page. On your Roam Depot Settings, toggle on the Feed Enabled switch. Now navigate to the daily notes page or to today's page. A dialog will appear and show you a feed of all the tweets that were published yesterday and that you liked.

Clicking "Import" will add a #[[Twitter Feed]] tag to your Daily Notes page with links to all the tweets nested below it.

By default, the Twitter feed only appears on the current daily notes page and log. You can configure the feed to appear on any daily notes page by toggling on the Any Day flag from your Roam Depot Settings.

By default, the Twitter feed queries the previous day's likes relative to the current daily note page, as it's meant to review a full day's of liked tweets. You can configure the feed to show the current day's tweets by toggling on the Today flag in your Roam Depot Settings.

By default, the tweets are imported at the top of the page. Toggle on the Append Feed to Bottom from your Roam Depot Settings to import the tweets to the bottom of the page.

By default, the Twitter feed just outputs links to the tweets into the daily note page. To customize the format, edit the Feed Import Format field from your Roam Depot Settings. There are certain placeholders that will get replaced in the format:

  • {text} - The text of the tweet
  • {link} - The link to the tweet
  • {handle} - The twitter handle of the user
  • {author} - The name of the user on Twitter

Searching Tweets

In any page, create a Twitter References button by typing in {{twitter references}} (case-insensitive) in a block. Upon clicking the button, the extension will clear the button and fill the page in with the tweets where you've mentioned that page title. So, if you've tweeted about books a lot on twitter, you can head over to the books page on roam, and then pull all your tweets about books!

One caveat is that this can only pull tweets made in the last 7 days.


Contributors

This extension is brought to you by RoamJS! If you are facing any issues reach out to support@roamjs.com or click on the chat button on the bottom right.

If you get value from using this extension, consider sponsoring RoamJS by clicking on the button below!

Other Extensions