Are.na Manager

Publish content from Obsidian to Are.na and the other way around.

Commands

Currently this plugin offers 5 commands:

Command	Description
Get blocks from channel	Get all the blocks from a channel and create a new note in Obsidian with the content of each block.
Pull block	Updates the current open note with the content of a block from Are.na.
Push note	Pushes the content of the current open note to a block in Are.na.
Get block from Are.na	Creates a new note with the content of a block from your Are.na account.
Get block by its ID or URL	Creates a new note with the content of a block from Are.na by its ID or URL.
Go to block in Are.na	Opens the block in the Are.na website.

Installation

1. Install the plugin and enable it.
2. Create a new Are.na application at https://dev.are.na/oauth/applications. You can use any valid URL in the Redirect URI field.
3. Submit the form and copy the Personal Access Token.
4. Open the plugin settings page and set the following options:
   • Personal Access Token: the Personal Access Token you copied earlier.
   • Username: Your Are.na slug (e.g., username in https://www.are.na/username).
   • Folder: The folder where you want to store the notes (the folder is called arena by default).
5. You are done! Use any of the commands above to interact with your Are.na blocks and channels.

Attachments download

The plugin doesn’t download attachments by default. If you want to download them, you can enable the Download attachments option in the settings. You can choose from the following download locations:

• Download inside the channel folder: Attachments will be stored in the same folder as the note. For example: arena/fantastic-channel/{folder name}. If you leave the field empty, your attachments will be stored in the channel folder.
• Download to a custom folder: Attachments will be stored in a custom folder. For example: attachments/web/files-i-saved-in-arena

Frontmatter structure

When you get a block from Are.na, the plugin will add some frontmatter automatically to allow syncronizing your note and the block.

Property	Description
blockid	the id of the block in Are.na
class	the class of the block in Are.na (e.g. Link or Attachment)
title	the title of the block in Are.na
user	the user who created the block in Are.na
channel	the channel where the block was pulled from
source title	the title of the block's source
source url	the url of the block's source

Roadmap

• Fetch all the user's channels.
• Attachment offline support.
• Getting blocks by their ID or URL.
• Avoid overiding the frontmatter when pulling a block.
• Template system (from this issue)
• Getting blocks to folders outside of the Are.na directory designated in the settings.
• Getting blocks from other users’ channels.
• Downloading blocks by URL.
• Creating new channels from the content of a note or directory

Contributing

If you have ideas, suggestions, or bug reports feel free to open an issue.