Skip to content

javierarce/arena-manager

Repository files navigation

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.