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

Go to file

Patrick Robertson 09e09e9ab9 Document module renames in 'upgrading from 0.12' how to		2025-03-07 16:28:17 +00:00
.github/workflows	Update docker-publish.yaml to use docker registry.	2025-03-07 15:34:56 +00:00
docs	Document module renames in 'upgrading from 0.12' how to	2025-03-07 16:28:17 +00:00
scripts	Don't force enable a module under all types - allows modules to be set as only feeder/only extractor etc.	2025-03-07 14:59:11 +00:00
src/auto_archiver	Merge branch 'main' into merge_modules	2025-03-07 16:19:51 +00:00
tests	Merge branch 'main' into merge_modules	2025-03-07 16:19:51 +00:00
.dockerignore	…
.gitignore	…
.pylintrc	…
.readthedocs.yaml	…
CONTRIBUTING.md	…
Dockerfile	…
LICENSE	…
README.md	…
docker-compose.yaml	…
poetry.lock	…
pyproject.toml	…

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 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 --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!