🐋 Web Archiving Integration Layer: One-Click User Instigated Preservation
Clone or download
Latest commit e386d11 Aug 22, 2018

README.md

WAIL logo

"One-Click User Instigated Preservation"


Web Archiving Integration Layer (WAIL) is a graphical user interface (GUI) atop multiple web archiving tools intended to be used as an easy way for anyone to preserve and replay web pages.

Tools included and accessible through the GUI are Heritrix 3.2.0 and OpenWayback 2.3.2. Support packages include Apache Tomcat, pyinstaller, and MemGator.

WAIL is written in Python and compiled to a native executable using PyInstaller.

NOTE: WAIL has also been reimagined in WAIL-Electron. The reimagined version enables high fidelity web archiving using modern capture and replay tools as well as collection-based archive organization. For natively using conventional institutional-grade Web archiving tools like OpenWayback and Heritrix, the repo where you reside is the place to be.

Installing WAIL

WAIL is an application that runs either on your macOS (.app) or Windows (.exe) system. To install WAIL, first download the appropriate package for your file system (.dmg for macOS or .zip for Windows), open the package, and follow the instructions to drag-and-drop the WAIL application to the correct location on your file system.

Running WAIL

This section is intended only to run WAIL from source. To download the compiled application, see the downloads section.

End-user execution is meant to be accessed through the binary file, either WAIL.app on macOS or WAIL.exe on Windows (7+). To run it using Python for testing, run the following from the root of the WAIL source directory:

python ./bundledApps/WAIL.py

Since Wayback and Heritrix configurations rely on absolute paths on the system, checks and interactions with services may not work in debugging mode unless a binary of WAIL (e.g., WAIL.app) currently exists in directory specific to your operating system (see below).

You may need to install other dependencies on your system to compile from source like wxWidgets depending on your local python configuration.

Python is not required to be installed for end-users, just double-click (see above) and go!

Development

To build WAIL from source to a native system executable (.app or .exe), open a terminal or console session and move into the root of the WAIL source directory then:

macOS

sh bundledApps/MAKEFILE.sh
This will create /Applications/WAIL.app on macOS.

Windows

From the Windows shell:
bundledApps\MAKEFILE.bat
then move the WAIL source directory to the root of your C drive (thus making C:\WAIL\).

Problems? Questions?

Please see the Frequently Asked Questions page.

Contact

WAIL is a project of the Web Science and Digital Libraries (WS-DL) Research Group at Old Dominion University (ODU), created by Mat Kelly with additional extensive contributions by John Berlin.

For support e-mail wail@matkelly.com or tweet to us at @machawk1 and/or @WebSciDL.