v0.5.0
waybackpack Waybackpack is a command-line tool that lets you download the entire Wayback Machine archive for a given URL.
For instance, to download every copy of the Department of Labor's homepage through 1996 (which happens to be the first year the site was archived), you'd run:
waybackpack http://www.dol.gov/ -d ~/Downloads/dol-wayback --to-date 1996
Result:
~/Downloads/dol-wayback/
โโโ 19961102145216
โย ย โโโ www.dol.gov
โย ย โโโ index.html
โโโ 19961103063843
โย ย โโโ www.dol.gov
โย ย โโโ index.html
โโโ 19961222171647
โย ย โโโ www.dol.gov
โย ย โโโ index.html
โโโ 19961223193614
โโโ www.dol.gov
โโโ index.html
Or, just to print the URLs of all archived snapshots:
waybackpack http://www.dol.gov/ --list
Installation
pip install waybackpack
Usage
usage: waybackpack [-h] [--version] (-d DIR | --list) [--raw] [--root ROOT]
[--from-date FROM_DATE] [--to-date TO_DATE]
[--user-agent USER_AGENT] [--follow-redirects]
[--uniques-only] [--collapse COLLAPSE] [--ignore-errors]
[--max-retries MAX_RETRIES] [--no-clobber] [--quiet]
[--progress]
url
positional arguments:
url The URL of the resource you want to download.
optional arguments:
-h, --help show this help message and exit
--version show program's version number and exit
-d DIR, --dir DIR Directory to save the files. Will create this
directory if it doesn't already exist.
--list Instead of downloading the files, only print the list
of snapshots.
--raw Fetch file in its original state, without any
processing by the Wayback Machine or waybackpack.
--root ROOT The root URL from which to serve snapshotted
resources. Default: 'https://web.archive.org'
--from-date FROM_DATE
Timestamp-string indicating the earliest snapshot to
download. Should take the format YYYYMMDDhhss, though
you can omit as many of the trailing digits as you
like. E.g., '201501' is valid.
--to-date TO_DATE Timestamp-string indicating the latest snapshot to
download. Should take the format YYYYMMDDhhss, though
you can omit as many of the trailing digits as you
like. E.g., '201604' is valid.
--user-agent USER_AGENT
The User-Agent header to send along with your requests
to the Wayback Machine. If possible, please include
the phrase 'waybackpack' and your email address. That
way, if you're battering their servers, they know who
to contact. Default: 'waybackpack'.
--follow-redirects Follow redirects.
--uniques-only Download only the first version of duplicate files.
--collapse COLLAPSE An archive.org `collapse` parameter. Cf.: https://gith
ub.com/internetarchive/wayback/blob/master/wayback-
cdx-server/README.md#collapsing
--ignore-errors Don't crash on non-HTTP errors e.g., the requests
library's ChunkedEncodingError. Instead, log error and
continue. Cf.
https://github.com/jsvine/waybackpack/issues/19
--max-retries MAX_RETRIES
How many times to try accessing content with 4XX or
5XX status code before skipping?
--no-clobber If a file is already present (and >0 filesize), don't
download it again.
--quiet Don't log progress to stderr.
--progress Print a progress bar. Mutes the default logging.
Requires `tqdm` to be installed.
Support
Waypackback is written in pure Python, depends only on requests
, and should work wherever Python works. Should be compatible with both Python 2 and Python 3.
Thanks
Many thanks to the following users for catching bugs, fixing typos, and proposing useful features: