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

Go to file

Patrick Robertson f54d6519a8 Fix sorting of steps in the outputted file		2025-03-04 11:51:26 +00:00
.github/workflows	removes fixed oscrypto dependency, it blocked pypi publishing (#195 )	2025-02-14 10:51:56 +00:00
docs	Rename 'upgrading...' page to 'upgrading from...' because it's also valid for 0.13+ versions	2025-03-03 19:58:47 +00:00
scripts	Fix sorting of steps in the outputted file	2025-03-04 11:51:26 +00:00
src/auto_archiver	Better error logs if users have XXXX_archiver modules enabled in config	2025-03-03 19:57:09 +00:00
tests	Fix tests for moving orchestration to secrets/orchestration.yaml	2025-02-21 19:05:39 +00:00
.dockerignore	docker initial files	2022-10-31 17:10:55 +00:00
.gitignore	Fix sorting of steps in the outputted file	2025-03-04 11:51:26 +00:00
.pylintrc	Ignore pylint statements for manifest files	2025-01-21 17:59:52 +01:00
.readthedocs.yaml	Overwrite settings_base file	2025-02-27 22:02:44 +00:00
CONTRIBUTING.md	Fix links to docs	2025-02-12 11:41:54 +00:00
Dockerfile	modifies base docker image to use browsertrix 1.4.2 (#182 )	2025-01-24 13:59:29 +00:00
LICENSE	Add LICENSE	2021-06-24 16:14:32 +02:00
README.md	Better documentation based on the discord feedbackgst	2025-02-24 22:42:57 +00:00
docker-compose.yaml	Add docker-compose for easy building and running of docker image in dev	2025-01-15 14:36:02 +01:00
poetry.lock	Updates tests to use pytest-mock.	2025-02-18 23:32:03 +00:00
pyproject.toml	Merge pull request #210 from bellingcat/logger_fix	2025-02-19 15:11:42 +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 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!