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

Go to file

Patrick Robertson 17d2d14680 Fix running 'cleanup' method on extractors that fail to start		2025-03-26 22:52:52 +04:00
.github	Don't run ruff on non-python file changes	2025-03-24 18:00:14 +04:00
docs	Add note that authentication only works for some modules	2025-03-24 18:28:35 +04:00
scripts	Update node module versions	2025-03-24 18:28:30 +04:00
src/auto_archiver	Fix running 'cleanup' method on extractors that fail to start	2025-03-26 22:52:52 +04:00
tests	Fix running 'cleanup' method on extractors that fail to start	2025-03-26 22:52:52 +04:00
.dockerignore	docker initial files	2022-10-31 17:10:55 +00:00
.gitignore	Script to auto-generate a service account	2025-03-17 15:42:43 +00:00
.pre-commit-config.yaml	Fix pre-commit for ruff check	2025-03-14 13:40:57 +00:00
.pylintrc	Ignore pylint statements for manifest files	2025-01-21 17:59:52 +01:00
.readthedocs.yaml	Fix incorrect path in cp	2025-03-16 10:33:52 +00:00
CONTRIBUTING.md	Fix links to docs	2025-02-12 11:41:54 +00:00
Dockerfile	Bump browsertrix version	2025-03-24 17:39:44 +04:00
LICENSE	Add LICENSE	2021-06-24 16:14:32 +02:00
Makefile	Update style_guide.md to clarify pre-commit setup, add Docker commands to Makefile and merge ruff actions.	2025-03-13 20:26:29 +00:00
README.md	Add '-it' to the list of docker flags, so that docker gives a colour log output	2025-03-17 09:45:12 +00:00
docker-compose.yaml	Cleanup docker-compose	2025-03-20 16:48:30 +04:00
poetry.lock	Also remove certvalidator from poetry/project	2025-03-26 15:11:25 +04:00
pyproject.toml	Also remove certvalidator from poetry/project	2025-03-26 15:11:25 +04: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!