Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Are.na Sync for Eagle

Import Are.na channels into Eagle — and keep them in sync. Link a channel once, then re-sync any time to pull in only the blocks you don't already have. Built for designers who collect on Are.na and organize in Eagle.

Are.na Sync running inside Eagle

Eagle 4.0+ Are.na v3 API License: MIT

Why

Are.na is where a lot of design reference gets collected; Eagle is where it gets organized — tagged, searchable, offline, next to the rest of your library. Moving between them has always been manual, one image at a time. This bridges them: a channel becomes an Eagle folder, and stays current with a click.

What it does

  • Link a channel by pasting its URL or slug. Image blocks import into an Eagle folder of the same name.
  • Sync, don't re-import. Re-syncing a linked channel imports only new blocks — nothing is duplicated, ever, even across reinstalls.
  • Ordering preserved. Each item's date added is stamped to when the block was connected on Are.na, so Eagle's sort mirrors the channel.
  • Provenance kept. Every item carries the block's source URL, a back-link to its Are.na permalink, and the channel slug as a tag.
  • Private channels work too — add an Are.na personal access token in settings (stored locally on your machine, sent only to api.are.na).

How the sync stays correct

Dedup is derived statelessly from your library, not a cache that can drift. Each imported item carries an arena:<blockId> tag — a structured, collision-proof key. On every sync the plugin reads the destination folder's existing tags and imports only the blocks that aren't there yet. Lose the plugin's settings, reinstall, move the folder — dedup still holds, because the truth lives on the items themselves. The channel→folder registry in localStorage is pure convenience; if it's gone, you just re-link and nothing re-imports.

Install

From the Eagle Plugin Center (recommended, once published): search "Are.na" in Eagle's Plugin Center and install.

From source (now):

  1. Download or clone this repo.
  2. In Eagle, open the Plugin panel (press P) → DeveloperImport Local Project.
  3. Point it at this folder, run it, paste a channel, hit Link.

Private channels

Create a personal access token at dev.are.na → paste it into the plugin's Settings (⚙). It's stored only in local storage on your machine and used solely to read channels you have access to.

Requirements

Eagle 4.0 build18+ (the plugin sets each item's import time to preserve ordering).

Project layout

manifest.json      plugin metadata (window plugin, i18n)
index.html         UI shell
css/style.css      theme-aware styling (follows Eagle light/dark)
js/arena.js        Are.na v3 API client
js/sync.js         Eagle-side import + stateless dedup
js/store.js        link registry (localStorage, per-library)
js/app.js          UI controller
_locales/          en, zh_CN, zh_TW, ja_JP, ko_KR

Build & publish

Right-click the plugin in Eagle's Plugin panel → Pack Plugin → export .eagleplugin, then submit at the Eagle Plugin Center.

Contributing

Issues and PRs welcome — especially locale fixes and edge cases in odd channel/block shapes.

License

MIT © mwdwrd

About

Import Are.na channels into Eagle and keep them in sync — link a channel once, re-sync to pull only new blocks. Eagle 4 plugin.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages