36 lines
1.2 KiB
Markdown
Raw Normal View History

2015-08-10 00:48:48 -05:00
# Wayback Machine Downloader
Download any website from the Internet Archive Wayback Machine.
## Installation
2015-08-12 17:14:21 -05:00
You need to install Ruby on your system (>= 1.9.2) - if you don't already have it, then run:
2015-08-10 00:48:48 -05:00
gem install wayback_machine_downloader
2015-08-12 17:14:21 -05:00
## Usage
2015-08-10 00:48:48 -05:00
2015-08-10 01:02:43 -05:00
### Basic
2015-08-10 01:10:41 -05:00
Run wayback_machine_downloader with the base url of the website you want to retrieve as a parameter (e.g., http://example.com):
2015-08-10 00:48:48 -05:00
wayback_machine_downloader http://example.com
2015-08-10 01:02:43 -05:00
### How it works
2015-08-10 00:48:48 -05:00
2015-08-10 00:59:43 -05:00
It will download the last version of every file present on Wayback Machine to `websites/example.com/`. It will also re-create a directory structure and auto-create `index.html` pages to work seamlessly with Apache and Nginx. URLs and links structure are preserved as much as possible.
2015-08-10 00:48:48 -05:00
2015-08-10 01:10:41 -05:00
### Optional Timestamp
2015-08-10 00:48:48 -05:00
2015-08-10 00:59:43 -05:00
You may want to supply a specific timestamp to lock your backup to an older version of the website. Wayback Machine Downloader will then fetch only file versions on or prior to the timestamp specified:
2015-08-10 00:48:48 -05:00
2015-08-19 11:23:13 -05:00
wayback_machine_downloader http://example.com --timestamp 20060716231334
2015-08-10 00:48:48 -05:00
2015-08-10 01:02:43 -05:00
### Contributing
2015-08-10 00:48:48 -05:00
Contributions are welcome! Just submit a pull request via GitHub.
To run the tests:
rake test