bellingcat Python script to automatically archive social media posts, videos, and images from a Google Sheets document.
 
 
 
 
 
 
Go to file
Patrick Robertson 3550a009e6
v1.0.0 release 🎉
2025-03-28 13:53:29 +00:00
.github Merge pull request #280 from bellingcat/download-tests 2025-03-28 13:33:30 +04:00
docs
scripts
src/auto_archiver Merge pull request #279 from bellingcat/telethon_tweaks 2025-03-28 14:13:26 +04:00
tests Simplify telethon unit tests for CI (don't use TestExtractorBase - it causes loading issues) 2025-03-26 23:51:21 +04:00
.dockerignore
.gitignore
.pre-commit-config.yaml
.pylintrc
.readthedocs.yaml
CONTRIBUTING.md
Dockerfile
LICENSE
Makefile
README.md
docker-compose.yaml
poetry.lock Lock poetry file 2025-03-26 15:43:03 +04:00
pyproject.toml v1.0.0 release 🎉 2025-03-28 13:53:29 +00:00

README.md

Auto Archiver

PyPI version Docker Image Version (latest by date) Core Test Status Download Test Status

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.

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!