https://github.com/javierarce/arena-manager
Publish content from Obsidian to Arena and the other way around.
https://github.com/javierarce/arena-manager
arena obsidian obsidian-plugin plugin
Last synced: about 1 month ago
JSON representation
Publish content from Obsidian to Arena and the other way around.
- Host: GitHub
- URL: https://github.com/javierarce/arena-manager
- Owner: javierarce
- License: mit
- Created: 2024-06-24T06:29:43.000Z (11 months ago)
- Default Branch: master
- Last Pushed: 2024-08-19T07:14:19.000Z (9 months ago)
- Last Synced: 2025-04-14T03:07:59.627Z (about 1 month ago)
- Topics: arena, obsidian, obsidian-plugin, plugin
- Language: TypeScript
- Homepage: https://obsidian.md/plugins?id=arena-manager
- Size: 85.9 KB
- Stars: 52
- Watchers: 2
- Forks: 0
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-github-repos - javierarce/arena-manager - Publish content from Obsidian to Arena and the other way around. (TypeScript)
README
# Are.na Manager
Publish content from [Obsidian](https://obsidian.md) to [Are.na](https://www.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](https://obsidian.md/plugins?id=arena-manager) and enable it.
2. Create a new Are.na application at [https://dev.are.na/oauth/applications](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
- [x] Fetch all the user's channels.
- [x] Attachment offline support.
- [x] Getting blocks by their ID or URL.
- [ ] Avoid overiding the frontmatter when pulling a block.
- [ ] Template system (from [this issue](https://github.com/javierarce/arena-manager/issues/1))
- [ ] 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](https://github.com/javierarce/arena-manager/issues).