bellingcat Python script to automatically archive social media posts, videos, and images from a Google Sheets document.

Go to file

Miguel Sozinho Ramalho c640cc898a Merge pull request #385 from bellingcat/dev 1.2.0 dependencies, small bugs, 1st time contributors		2026-01-08 15:55:40 +00:00
.github	make python api tests work on gh when no env is set	2025-06-30 02:20:51 +01:00
docs	ruff-fix -> ruff-clean; there is no ruff-fix in the Makefile. Maybe the command /should/ be ruff-fix to align with the underlying ruff command; for later discussion. This at least reconciles the documentation to the Makefile	2025-08-05 21:36:32 -04:00
scripts	concludes logging standardization refactor	2025-06-26 17:20:04 +01:00
src/auto_archiver	this is ruff	2026-01-08 15:48:08 +00:00
tests	wiki fix	2026-01-08 15:49:42 +00:00
.dockerignore	…
.gitignore	…
.pre-commit-config.yaml	…
.pylintrc	…
.readthedocs.yaml	…
CONTRIBUTING.md	…
Dockerfile	browsertrix-crawler to 1.9.2 see #383	2026-01-08 15:33:40 +00:00
LICENSE	…
Makefile	…
README.md	…
docker-compose.yaml	…
poetry.lock	pyperclip version bump closes #339	2026-01-08 15:40:17 +00:00
pyproject.toml	version bump for new release	2026-01-08 15:41:27 +00:00

README.md

Auto Archiver

Auto Archiver is a Python tool to automatically archive content on the web in a secure and verifiable way. It takes URLs from different sources (e.g. a CSV file, Google Sheets, command line etc.) and archives the content of each one. It can archive social media posts, videos, images and webpages. Content can be enriched, then saved either locally or remotely (S3 bucket, Google Drive). The status of the archiving process can be appended to a CSV report, or if using Google Sheets – back to the original sheet.

See the Auto Archiver documentation for more information.

Read the article about Auto Archiver on bellingcat.com.

Installation

View the Installation Guide for full instructions

Advanced:

To get started quickly using Docker:

docker pull bellingcat/auto-archiver && docker run -it --rm -v secrets:/app/secrets bellingcat/auto-archiver --config secrets/orchestration.yaml

Or pip:

pip install auto-archiver && auto-archiver --help

Contributing

We welcome contributions to the Auto Archiver project! See the Contributing Guide for how to get involved!