Skip to content
ePADD is a software package developed by Stanford University's Special Collections & University Archives that supports archival processes around the appraisal, ingest, processing, discovery, and delivery of email archives.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.idea added invite@ and noreply@ to banned start strings for merging corres… Aug 16, 2018
WebContent
compost
doc added design files to github Oct 17, 2018
lib
research/variants preparing for mvn -P prod Apr 5, 2017
scripts updated version of variants. Oct 10, 2016
src/java Fix for bag verification failed issue. It was due to a bug in caching… May 18, 2019
.gitignore smartening attachment rendering. Jan 17, 2018
README.build.txt updated insns for merged muse Jul 17, 2017
README.md Update README.md Nov 12, 2018
README.resources.html updated version of variants. Oct 10, 2016
build.xml
do
do.bat fixed do.bat Jun 8, 2016
ePADD 6.0.bmpr Add files via upload Mar 30, 2018
pom-common.xml final release 30Jan 19 Jan 30, 2019
pom-discovery.xml
pom.xml
version Changed version to 7.1 May 18, 2019

README.md

ePADD (Email: Process Appraise, Discover, Deliver)

https://library.stanford.edu/projects/epadd

Introduction

ePADD is a software package developed by Stanford University's Special Collections & University Archives that supports archival processes around the appraisal, ingest, processing, discovery, and delivery of email archives.

The software is comprised of four modules:

Appraisal: Allows donors, dealers, and curators to easily gather and review email archives prior to transferring those files to an archival repository.

Processing: Provides archivists with the means to arrange and describe email archives.

Discovery: Provides the tools for repositories to remotely share a redacted view of their email archives with users through a web server discovery environment. (Note that this module is downloaded separately).

Delivery: Enables archival repositories to provide moderated full-text access to unrestricted email archives within a reading room environment.

System Requirements

OS: Windows 7 SP1 / 10, Mac OS X 10.12 / 10.13, Ubuntu 16.04 Memory: 8 GB RAM (4 GB RAM allocated to the application by default) Browser: Chrome 64 or later, Firefox 58 or later Windows installations: Java Runtime Environment 8u101 or later required.

Installation

(Note that a full installation and user guide is accessible here.

ePADD has been tested on and optimized for Windows 7 SP1 / 10, Mac OS X 10.13 / 10.14, and Ubuntu 16.04 . Please follow the instructions below for your operating system.

Installing ePADD on Windows

Please download the latest ePADD distribution files (.exe) from https://github.com/ePADD/epadd/releases/. You will need to have Java 1.8 or later installed on your machine for ePADD to work properly.

When you run ePADD for the first time, a directory for the Appraisal Module is created to store working files. When ePADD starts up, it checks this directory and relies upon it to resume earlier work. If the software does not locate this directory, ePADD will create it. The ePADD Appraisal Module directory is located at c:\users<username>\epadd-appraisal.

In order for functionality for authority reconciliation to perform correctly, you must also separately download the configuration files (epadd-settings.zip), accessible via https://github.com/ePADD/epadd/releases/. Once downloaded, unzip this file into your user directory (c:\users<username>).

Depending upon your network permissions, you may be asked to allow ePADD access to your internet connection. Certain functionality (for instance, downloading email from an email account using the IMAP protocol, or communicating with DBPedia to generate relevance rankings for authority reconciliation) requires an internet connection. Upon running ePADD, the application icon will appear in the Windows Taskbar. Right-click on this icon at any point to open an ePADD window or to quit ePADD.

Note: ePADD allocates 4096 MB RAM to the application by default. If the standard RAM allocated does not suffice, you may wish to run the Java application directly from the command line (epadd-standalone.jar). From the Command Prompt, you can run the application using this command: java -Xmx#g -jar epadd-standalone.jar, where # identifies the amount of RAM (in GB) you wish to allocate.

Note: The Discovery Module is run through a separate distribution file accessible via https://github.com/ePADD/epadd/releases/. Please see the installation and user guide for more information about the Discovery Module.

Installing ePADD on OSX

Please download the latest ePADD distribution files (.dmg) from https://github.com/ePADD/epadd/releases/. When you run ePADD for the first time, a directory for the Appraisal Module is created to store working files. When ePADD starts up, it checks this directory and relies upon it to resume earlier work. If the software does not locate this directory, ePADD will create it. The ePADD Appraisal Module directory is located at Macintosh HD/Users//epadd-appraisal.

In order for functionality related to authority reconciliation to perform correctly, you must also separately download the configuration files (epadd-settings.zip), accessible via https://github.com/ePADD/epadd/releases/. Once downloaded, unzip this file into your user directory (Macintosh HD\Users<username>).

Depending upon your network permissions, you may be asked to allow ePADD access to your internet connection. Certain functionality (for instance, downloading email from an email account using the IMAP protocol, or communicating with DBPedia to generate relevance rankings for authority reconciliation) requires an internet connection. In Mac OSX, the application icon will appear in the OSX Finder Toolbar. Right-click on this icon at any point to open an ePADD window or to quit ePADD.

Note: ePADD allocates 4096 MB RAM to the application by default. If the standard RAM allocated does not suffice, you may wish to run the Java application directly from the command line (epadd-standalone.jar). From the Terminal, you can run the application using this command: java -Xmx#g -jar epadd-standalone.jar, where # identifies the amount of RAM (in GB) you wish to allocate.

Note: The Discovery Module is run through a separate distribution file accessible via https://github.com/ePADD/epadd/releases/. Please see the installation and user guide for more information about the Discovery Module.

ePADD Documentation, Help, and other Information

More information about the software and related developments, including links to the full installation and user guide, as well as a link to the community forums, can be found via [our website] (https://library.stanford.edu/projects/epadd/).

License(s)

The ePADD logo, project documentation (including installation and user guide), and other non-software products of the ePADD team are subject to the Creative Commons Attribution 2.0 Generic license (CC By 2.0).

Unless otherwise indicated, software items in this repository are distributed under the terms of the Apache License, Version 2.0 (the "License"); you may not use these files except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0. Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Credits

Research and Development:

  • Sudheendra Hangal, Ashoka University and Amuse Labs;
  • Vihari Piratla, Amuse Labs;
  • Sit Manovit, iXora Inc.;
  • Peter Chan, Stanford University Libraries;
  • Glynn Edwards, Stanford University Libraries;
  • Josh Schneider, Stanford University Libraries

Design:

  • Saumya Sarangi, Lollypop Design;
  • Mandeep RJ, Lollypop Design

Testing and Collaboration (Phase 2):

  • Elvia Arroyo-Ramirez, University of California, Irvine;
  • Laura Uglean Jackson, University of California, Irvine;
  • Skip Kendall, Harvard University;
  • Margo Padilla, Metropolitan New York Library Council (METRO);
  • Christopher Prom, University of Illinois at Urbana-Champaign;
  • Audra Eagle Yun, University of California, Irvine

Advisory Board (Phase 2):

  • Sherri Berger, California Digital Library;
  • Andrew Byers, Duke University;
  • Jackie Dooley, OCLC Research;
  • Mike Giarlo, Stanford University;
  • Marie Hicks, Illinois Institute of Technology;
  • Peter Hirtle, Cornell University;
  • Lise Jaillart, Loughborough University;
  • Jeremy Leighton John, British Library;
  • Cal Lee, University of North Carolina, Chapel Hill;
  • Evelyn McLellan, Artefactual;
  • Mark Matienzo, Digital Public Library of America;
  • T. Christian Miller, ProPublica;
  • Jessica Moran, National Library of New Zealand;
  • David Rosenthal, Stanford University;
  • Marc A. Smith, Social Media Research Foundation;
  • Terry Winograd, Stanford University;
  • Kam Woods, University of North Carolina, Chapel Hill

Testing and Collaboration (Phase 1):

  • Donald Mennerich, New York University Libraries;
  • Susan Thomas, Bodleian Library, Oxford University;
  • Riccardo Ferrante and Lynda Schmitz Fuhrig, Smithsonian Institution Archives;
  • Terry Catapano, Stephen Davis, and Dina Sokolova, Columbia University

Advisory Board (Phase 1):

  • Jeremy Leighton John, British Library;
  • Monica S. Lam, Stanford University;
  • Phillip R. Malone, Stanford University;
  • Pam Maples, Stanford University;
  • Meg McAleer, Library of Congress;
  • Chris Prom, University of Illinois;
  • Ben Shneiderman, University of Maryland;
  • Jeff Ubois, Macarthur Foundation

Initial specifications (requirements and wireframes):

  • Daniel Hartwig, Stanford University Libraries;
  • Daniel Jarvis, Hoover Institute, Stanford;
  • Lisa Miller, Hoover Institute, Stanford;
  • Aimee Morgan, formerly Stanford University Libraries;
  • Laura O'Hara, formerly SLAC National Accelerator Laboratory

Funding:

  • Instiute for Museum and Library Services (ePADD Phase 2)
  • National Historical Publications & Records Commission (ePADD Phase 1);
  • Payton J. Treat Fund from the Stanford University Libraries (ePADD Phase 1);
  • U.S. National Science Foundation (Muse);
  • Mobisocial Laboratory at Stanford University (Muse)

Software:

Under Apache License 2.0:

  • Apache Commons (fileupload, lang3, io, httpclient, cli, codec), tika, opennlp, tomcat, maven, ant © Apache Software Foundation
  • Muse © Mobisocial Laboratory, Stanford University
  • Google Gson © Google
  • OpenCSV © Glen Smith and others
  • Java SE Platform Products © Oracle - Oracle BCL
  • Launch4j © Grzegorz Kowal BSD 3-clause license and MIT license
  • Font Awesome © Dave Gandy MIT license, SIL OFL 1.1
  • Jquery-autocomplete © Tomas Kirda under MIY-style license.
  • Jsoup

Cooliris Image wall (Special thanks to Soujanya Bhumkar, Austin Shoemaker and team for making the software available to us) Copyright (c) 2015 Yahoo, Inc. This software is provided 'as-is', without any express or implied warranty. In no event will the authors be held liable for any damages arising from the use of this software. Permission is granted to anyone to use this software for any purpose, including commercial applications, and to alter it and redistribute it freely, subject to the following restrictions: 1. The origin of this software must not be misrepresented; you must not claim that you wrote the original software. If you use this software in a product, an acknowledgement in the product documentation would be appreciated but is not required. 2. Altered source versions must be plainly marked as such, and must not be misrepresented as being the original software. 3. This notice may not be removed or altered from any source distribution.

LIBSVM Copyright (c) 2000-2014 Chih-Chung Chang and Chih-Jen Lin All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: 1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. 2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. 3. Neither name of copyright holders nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

Mstor Copyright (c) 2007, Ben Fortuna All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. Neither the name of Ben Fortuna nor the names of any other contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

You can’t perform that action at this time.