bellingcat Python script to automatically archive social media posts, videos, and images from a Google Sheets document.
 
 
 
 
 
 
Go to file
erinhmclark 441f341139 Merge branch 'main' into linting_etc
# Conflicts:
#	src/auto_archiver/core/consts.py
#	src/auto_archiver/core/orchestrator.py
#	src/auto_archiver/core/storage.py
#	src/auto_archiver/modules/local_storage/local_storage.py
#	src/auto_archiver/modules/s3_storage/s3_storage.py
#	tests/storages/test_S3_storage.py
#	tests/storages/test_local_storage.py
#	tests/storages/test_storage_base.py
2025-03-11 10:39:47 +00:00
.github/workflows Ruff format with defaults. 2025-03-10 18:44:54 +00:00
docs Ruff format with defaults. 2025-03-10 18:44:54 +00:00
scripts Ruff format with defaults. 2025-03-10 18:44:54 +00:00
src/auto_archiver Merge branch 'main' into linting_etc 2025-03-11 10:39:47 +00:00
tests Merge branch 'main' into linting_etc 2025-03-11 10:39:47 +00:00
.dockerignore
.gitignore Fix sorting of steps in the outputted file 2025-03-04 11:51:26 +00:00
.pre-commit-config.yaml Ruff fix on src. 2025-03-10 19:03:45 +00:00
.pylintrc
.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 Remove geckodriver .tar file 2025-03-07 11:52:14 +00:00
LICENSE
README.md Adds new extractor for tiktok via unofficial API (#237) 2025-03-10 11:56:45 +00:00
docker-compose.yaml
poetry.lock Switch to ruff 2025-03-10 16:05:23 +00:00
pyproject.toml Implementing ruff suggestions. 2025-03-10 21:45:30 +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 --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!