Skip to content
The Archives Unleashed Toolkit is an open-source toolkit for analyzing web archives.
Scala Java Python
Branch: master
Clone or download
ruebot and ianmilligan1 Add audio & video binary extraction (#341)
- Add Audio & Video binary extraction.
- Add filename, and extenstion column to audio, pdf, and video DF
- Pass binary bytes instread of string to DetectMimeTypeTika in DF (s/getContentString/getBinaryBytes)
- Updates saveToDisk to use file extension from DF column
- Adds tests for Audio, PDF, and Video DF extraction
- Add test fixtures for Audio, PDF, and Video DF extraction
- Rename SaveBytesTest to SaveImageBytes test
- Eliminate bytes->string->bytes conversion that was causing data loss in DetectMimeTypeTika
- Update tika-parsers dep from JitPack
- Remove tweet cruft
- Resolves #306
- Resolves #307
- Includes work by @jrwiebe, see #341 for all commits before squash
Latest commit 54c0c3e Aug 13, 2019

The Archives Unleashed Toolkit

Build Status codecov Maven Central Javadoc Scaladoc LICENSE Contribution Guidelines

The Archives Unleashed Toolkit is an open-source toolkit for analyzing web archives built around Apache Spark. This toolkit is part of the Archives Unleashed Project.

The toolkit grew out of a previous project called Warcbase. The following article provides a nice overview, much of which is still relevant:

Getting Started


If you have Apache Spark ready to go, it's as easy as:

$ spark-shell --packages "io.archivesunleashed:aut:0.17.0"

A little less easy

You can download the latest release here and include it like so:

$ spark-shell --jars /path/to/aut-0.17.0-fatjar.jar"

Even less easy

Build it yourself as per the instructions below:

Clone the repo:

$ git clone

You can then build The Archives Unleashed Toolkit.

$ mvn clean install

For the impatient, to skip tests:

$ mvn clean install -DskipTests

I want to use Docker!

Ok! Take a quick spin with aut with Docker.

Documentation! Or, how do I use this?

Once built or downloaded, you can follow the basic set of recipes and tutorials here.


Licensed under the Apache License, Version 2.0.


This work is primarily supported by the Andrew W. Mellon Foundation. Additional funding for the Toolkit has come from the U.S. National Science Foundation, Columbia University Library's Mellon-funded Web Archiving Incentive Award, the Natural Sciences and Engineering Research Council of Canada, the Social Sciences and Humanities Research Council of Canada, and the Ontario Ministry of Research and Innovation's Early Researcher Award program. Any opinions, findings, and conclusions or recommendations expressed are those of the researchers and do not necessarily reflect the views of the sponsors.

You can’t perform that action at this time.