bellingcat Python script to automatically archive social media posts, videos, and images from a Google Sheets document.
 
 
 
 
 
 
Go to file
msramalho 3e2c0b564b
wiki fix
2026-01-08 15:49:42 +00:00
.github make python api tests work on gh when no env is set 2025-06-30 02:20:51 +01:00
docs ruff-fix -> ruff-clean; there is no ruff-fix in the Makefile. Maybe the command /should/ be ruff-fix to align with the underlying ruff command; for later discussion. This at least reconciles the documentation to the Makefile 2025-08-05 21:36:32 -04:00
scripts concludes logging standardization refactor 2025-06-26 17:20:04 +01:00
src/auto_archiver this is ruff 2026-01-08 15:48:08 +00:00
tests wiki fix 2026-01-08 15:49:42 +00:00
.dockerignore
.gitignore Gitgnore to include launch.json and installtion docs to include build script. 2025-06-16 14:37:21 +01:00
.pre-commit-config.yaml Fix pre-commit for ruff check 2025-03-14 13:40:57 +00:00
.pylintrc
.readthedocs.yaml installs ffmpeg in readthedocs 2025-06-18 00:29:36 +01:00
CONTRIBUTING.md
Dockerfile browsertrix-crawler to 1.9.2 see #383 2026-01-08 15:33:40 +00:00
LICENSE
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 pyperclip version bump closes #339 2026-01-08 15:40:17 +00:00
pyproject.toml version bump for new release 2026-01-08 15:41:27 +00: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!