bellingcat Python script to automatically archive social media posts, videos, and images from a Google Sheets document.
 
 
 
 
 
 
Go to file
msramalho c0be41950d
Merge branch 'dev' of https://github.com/bellingcat/auto-archiver into dev
2025-06-04 17:06:42 +01:00
.github update runner os to matrix os. 2025-03-31 12:00:24 +01:00
docs finish removing screenshot_enricher references 2025-06-04 14:31:07 +01:00
scripts Bump the actions group in /scripts/settings with 4 updates 2025-06-02 20:21:07 +00:00
src/auto_archiver minimal changes: standard naming 2025-06-04 15:06:08 +01:00
tests fixing s3 storage tests 2025-06-04 14:41:00 +01:00
.dockerignore docker initial files 2022-10-31 17:10:55 +00:00
.gitignore removes unnecessary ignored files 2025-06-04 14:19:25 +01: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 removes geckodriver dependencies following screenshot enricher removal 2025-06-04 14:09:13 +01: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 update repo badges 2025-03-31 16:19:29 +01:00
docker-compose.yaml Cleanup docker-compose 2025-03-20 16:48:30 +04:00
poetry.lock dropping screenshot enricher 2025-06-04 12:08:59 +01:00
pyproject.toml dropping screenshot enricher 2025-06-04 12:08:59 +01:00

README.md

Auto Archiver

Documentation Status PyPI version Docker Image Version (latest by date) Core 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!