From 66187f2603fc8810ffab43c0b54033835de7cd78 Mon Sep 17 00:00:00 2001 From: Nick Sweeting Date: Thu, 8 Apr 2021 07:21:04 -0400 Subject: [PATCH] Update README.md --- README.md | 59 ++++++++++++++++++++++++++++++++----------------------- 1 file changed, 34 insertions(+), 25 deletions(-) diff --git a/README.md b/README.md index dca6e8b4..54e62672 100644 --- a/README.md +++ b/README.md @@ -30,20 +30,31 @@
-ArchiveBox is a powerful self-hosted internet archiving solution written in Python. You feed it URLs of pages you want to archive, and it saves them to disk in a variety of formats depending on setup and content within. +ArchiveBox is a powerful internet archiving solution that works like a self-hosted Wayback Machine. You feed it URLs of pages you want to archive (as bookmarks, browser history, RSS, etc.), and it saves them to disk in a variety of formats depending on setup and content within. -**🔢  Run ArchiveBox via [Docker Compose (recommended)](#Quickstart), Docker, Apt, Brew, or Pip ([see below](#Quickstart)).** +It supports taking URLs in one at a time, or scheduled importing from browser bookmarks or history, RSS, services like Pocket/Pinboard and more. For a full list see input formats. +It saves Snapshots of the URLs you feed it as HTML, PDFs, Screenshots, plain text, and more out-of-the-box, with a wide variety of content extracted and preserved automatically (audio/video, git repos, etc.). See output formats for a full list. + +At the end of the day, the goal is to sleep soundly knowing that the part of the internet you care about will be automatically preserved in multiple, durable long-term formats that will be accessible and sharable for many decades. + +**🔢  First, get ArchiveBox via [Docker Compose (recommended)](#Quickstart), or Docker, Apt, Brew, Pip ([see below](#Quickstart)).** + +1. Once you have ArchiveBox, run this in a new empty folder to get started ```bash -apt/brew/pip3/etc install archivebox - -archivebox init --setup # run this in an empty folder -archivebox add 'https://example.com' # start adding URLs to archive -curl https://example.com/rss.xml | archivebox add # or add via stdin -archivebox schedule --every=day https://example.com/rss.xml +archivebox init --setup # this creates a new collection ``` -For each URL added, ArchiveBox saves several types of HTML snapshot (wget, Chrome headless, singlefile), a PDF, a screenshot, a WARC archive, any git repositories, images, audio, video, subtitles, article text, [and more...](#output-formats). +2. Then add some URLs you want to archive +```bash +archivebox add 'https://example.com' # one at a time +curl https://example.com/rss.xml | archivebox add # piped via stdin +archivebox schedule --every=day https://example.com/rss.xml # frequent imports +``` + +For each URL added, ArchiveBox saves several types of HTML snapshot (wget, Chrome headless, singlefile), a PDF, a screenshot, a WARC archive, any git repositories, images, audio, video, subtitles, article text, . + +3. Then view your archive collection ```bash archivebox server 0.0.0.0:8000 # use the interactive web UI @@ -51,9 +62,7 @@ archivebox list 'https://example.com' # use the CLI commands (--help for more) ls ./archive/*/index.json # or browse directly via the filesystem ``` -You can then manage your snapshots via the [filesystem](https://github.com/ArchiveBox/ArchiveBox/wiki/Usage#disk-layout), [CLI](https://github.com/ArchiveBox/ArchiveBox/wiki/Usage#CLI-Usage), [Web UI](https://github.com/ArchiveBox/ArchiveBox/wiki/Usage#UI-Usage), [SQLite DB](https://github.com/ArchiveBox/ArchiveBox/blob/dev/archivebox/core/models.py) (`./index.sqlite3`), [Python API](https://docs.archivebox.io/en/latest/modules.html) (alpha), [REST API](https://github.com/ArchiveBox/ArchiveBox/issues/496) (alpha), or [desktop app](https://github.com/ArchiveBox/electron-archivebox) (alpha). - -At the end of the day, the goal is to sleep soundly knowing that the part of the internet you care about will be automatically preserved in multiple, durable long-term formats that will be accessible for decades (or longer). +**⤵️ See the [Quickstart](#Quickstart) below for more...**


@@ -63,9 +72,13 @@ At the end of the day, the goal is to sleep soundly knowing that the part of the
. . . . . . . . . . . . . . . . . . . . . . . . . . . .

+cli init screenshot +cli init screenshot +server snapshot admin screenshot +server snapshot details page screenshot +
- ## Key Features - [**Free & open source**](https://github.com/ArchiveBox/ArchiveBox/blob/master/LICENSE), doesn't require signing up for anything, stores all data locally @@ -79,19 +92,13 @@ At the end of the day, the goal is to sleep soundly knowing that the part of the - Planned: support for archiving [content requiring a login/paywall/cookies](https://github.com/ArchiveBox/ArchiveBox/wiki/Configuration#chrome_user_data_dir) (working, but ill-advised until some pending fixes are released) - Planned: support for running [JS scripts during archiving](https://github.com/ArchiveBox/ArchiveBox/issues/51), e.g. adblock, [autoscroll](https://github.com/ArchiveBox/ArchiveBox/issues/80), [modal-hiding](https://github.com/ArchiveBox/ArchiveBox/issues/175), [thread-expander](https://github.com/ArchiveBox/ArchiveBox/issues/345), etc. -
+

-cli init screenshot -cli init screenshot -server snapshot admin screenshot -server snapshot details page screenshot -

grassgrass
- ### Quickstart **🖥  Supported OSs:** Linux/BSD, macOS, Windows (w/ Docker)     **🎮  CPU Architectures:** x86, amd64, arm7, arm8 (raspi >=3) @@ -106,7 +113,9 @@ No matter which install method you choose, they all roughly follow this 3-step p
  • View the archive: archivebox server or archivebox list ..., ls ./archive/*/index.html
  • -#### ⚡️  Install +
    + +#### ⬇️  Install *(click to expand your preferred **► `distribution`** below for full setup instructions)* @@ -275,7 +284,6 @@ archivebox help # to see more options -
    #### ⚡️  CLI Usage @@ -291,16 +299,17 @@ archivebox help - `archivebox oneshot` archive single URLs without starting a whole collection - `archivebox shell/manage dbshell` open a REPL to use the [Python API](https://docs.archivebox.io/en/latest/modules.html) (alpha), or SQL API -#### ⚡️  Web UI Usage + +#### 🖥  Web UI Usage ```bash +archivebox manage createsuperuser archivebox server 0.0.0.0:8000 ``` Then open http://127.0.0.1:8000 to view the UI. ```bash -# optionally lock down the Web UI to require logging in with an admin account -archivebox manage createsuperuser +# you can also configure whether or not login is required for most features archivebox config --set PUBLIC_INDEX=False archivebox config --set PUBLIC_SNAPSHOTS=False archivebox config --set PUBLIC_ADD_VIEW=False