Metadata-Version: 2.4
Name: auto-archiver
Version: 1.1.5
Summary: Automatically archive links to videos, images, and social media content from Google Sheets (and more).
License-Expression: MIT
License-File: LICENSE
Keywords: archive,oosi,osint,scraping
Author: Bellingcat
Author-email: tech@bellingcat.com
Requires-Python: >=3.10,<3.13
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Requires-Dist: beautifulsoup4 (>=0.0.0)
Requires-Dist: bgutil-ytdlp-pot-provider (>=1.0.0)
Requires-Dist: boto3 (>=1.28.0,<2.0.0)
Requires-Dist: bs4 (>=0.0.0)
Requires-Dist: cryptography (>=46.0.3)
Requires-Dist: dataclasses-json (>=0.0.0)
Requires-Dist: dateparser (>=0.0.0)
Requires-Dist: ffmpeg-python (>=0.0.0)
Requires-Dist: google-api-python-client (>=0.0.0)
Requires-Dist: google-auth-httplib2 (>=0.0.0)
Requires-Dist: google-auth-oauthlib (>=0.0.0)
Requires-Dist: gspread (>=0.0.0)
Requires-Dist: instaloader (>=0.0.0)
Requires-Dist: jinja2 (>=0.0.0)
Requires-Dist: jsonlines (>=0.0.0)
Requires-Dist: loguru (>=0.0.0)
Requires-Dist: numpy (==2.1.3)
Requires-Dist: oauth2client (>=0.0.0)
Requires-Dist: opentimestamps (>=0.4.5,<0.5.0)
Requires-Dist: pdqhash (>=0.0.0)
Requires-Dist: pillow (>=0.0.0)
Requires-Dist: pyautogui (>=0.9.54,<0.10.0)
Requires-Dist: pyperclip (==1.8.2)
Requires-Dist: pysubs2 (>=0.0.0)
Requires-Dist: python-slugify (>=0.0.0)
Requires-Dist: python-twitter-v2 (>=0.0.0)
Requires-Dist: requests[socks] (>=0.0.0)
Requires-Dist: retrying (>=0.0.0)
Requires-Dist: rfc3161-client (>=1.0.5)
Requires-Dist: rich-argparse (>=1.6.0,<2.0.0)
Requires-Dist: ruamel-yaml (>=0.18.10,<0.19.0)
Requires-Dist: secretstorage (>=3.3.3,<4.0.0)
Requires-Dist: seleniumbase (>=4.36.4,<5.0.0)
Requires-Dist: telethon (>=0.0.0)
Requires-Dist: tqdm (>=0.0.0)
Requires-Dist: warcio (>=0.0.0)
Requires-Dist: yt-dlp[curl-cffi,default] (>=2025.5.22,<2026.0.0)
Project-URL: Documentation, https://github.com/bellingcat/auto-archiver
Project-URL: Homepage, https://github.com/bellingcat/auto-archiver
Project-URL: Repository, https://github.com/bellingcat/auto-archiver
Description-Content-Type: text/markdown

<h1 align="center">Auto Archiver</h1>

[![Documentation Status](https://readthedocs.org/projects/auto-archiver/badge/?version=latest)](https://auto-archiver.readthedocs.io/en/latest/?badge=latest)
[![PyPI version](https://badge.fury.io/py/auto-archiver.svg)](https://badge.fury.io/py/auto-archiver)
[![Docker Image Version (latest by date)](https://img.shields.io/docker/v/bellingcat/auto-archiver?sort=semver&logo=docker&color=#69F0AE)](https://hub.docker.com/r/bellingcat/auto-archiver)
[![Core Test Status](https://github.com/bellingcat/auto-archiver/workflows/Core%20Tests/badge.svg)](https://github.com/bellingcat/auto-archiver/actions/workflows/tests-core.yaml)
<!-- [![Download Test Status](https://github.com/bellingcat/auto-archiver/workflows/Download%20Tests/badge.svg)](https://github.com/bellingcat/auto-archiver/actions/workflows/tests-download.yaml) -->

<!-- ![Docker Pulls](https://img.shields.io/docker/pulls/bellingcat/auto-archiver) -->
<!-- [![PyPI download month](https://img.shields.io/pypi/dm/auto-archiver.svg)](https://pypi.python.org/pypi/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 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.

<div class="hidden_rtd">
  
**[See the Auto Archiver documentation for more information.](https://auto-archiver.readthedocs.io/en/latest/)**

</div>

Read the [article about Auto Archiver on bellingcat.com](https://www.bellingcat.com/resources/2022/09/22/preserve-vital-online-content-with-bellingcats-auto-archiver-tool/).


## Installation

View the [Installation Guide](https://auto-archiver.readthedocs.io/en/latest/installation/installation.html) 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](https://auto-archiver.readthedocs.io/en/latest/contributing.html) for how to get involved!


