Are.na Archiver

CLI for archiving and downloading Are.na channels, including images, media, attachments, links, and text blocks.

Installation

Install globally via npm. Requires Node.js 20 or higher.

npm i -g arena-archiver

Usage

arena-archiver get <slug> [options]

Files are saved to <cwd>/arena-archiver/<slug>/ by default. Each block is written as <block-id>_<slugified-title>.<ext>.

# Download a channel into ./arena-archiver/channel-slug/
arena-archiver get channel-slug

Options

--dir <path>

Override the output directory. The <slug> subfolder is always appended, so --dir ~/downloads saves into ~/downloads/<slug>/. Defaults to <cwd>/arena-archiver.

# Save into ~/downloads/channel-slug/
arena-archiver get channel-slug --dir ~/downloads

--existing <skip|overwrite>

Controls what happens when a file already exists on disk. Defaults to skip, which makes re-running the command cheap and incremental — useful for periodically syncing a channel without re-downloading everything. Use overwrite when blocks have been replaced upstream and you want the local copy to match.

# Default: leave existing files alone
arena-archiver get channel-slug

# Replace local files with the current upstream versions
arena-archiver get channel-slug --existing overwrite

--types <list>

Comma-separated list of block classes to download. Defaults to image,media,attachment — the classes that produce binary files. Extend it with link or text when you want to archive a channel's full editorial content (link previews, text notes) and not just its media.

Supported values: image, media, attachment, link, text.

# Download PDFs and other attachments only
arena-archiver get channel-slug --types attachment

# Archive everything, including text notes and link previews
arena-archiver get channel-slug --types image,media,attachment,link,text

Credits

Fork of tg-z/arena-archiver.

License

MIT