Introduction

DueDates is an easy-to-use tool for keeping track of items that you have checked-out from libraries. It accesses your library accounts online, checks what items you have borrowed and when they are due, and displays this information in a convenient format. If you've ever forgotten about a due date or had an overdue fine, then DueDates is the tool for you!

Features

• Supports the University of Hawaii Library System and the Hawaii State Public Library System
• Customizable alerts to notify you when items are almost due
• Check multiple libraries
• Sort results by library, due date, or title
• Custom-filter results to display only items that are due soon
• User-friendly interface
• Open source! Add your own libraries!

System Requirements

• Java 6 or higher
• An account at your library’s website

Installation

• Install Java SE Runtime Environment (JRE) Version 6.
• Install JavaMail 1.4.1, and copy the mail.jar file to your Java JRE extension folder.
• Create your own read-in data file:
• In your home directory, create a directory called .duedates

In console

    > mkdir .duedates
    > cd .duedates

• Create a file called, duedates.xml

Other text editors can be used

    > vi duedates.xml

• In that file create your user profile in the format shown below:

Be sure to change the credentials in green

<DueDates>
  <SmtpServer>mail.hawaii.edu</SmtpServer>
  <Users>
    <User name="Erin Kim" email="your_email@gmail.edu" password="your_password">
      <Library name="University of Hawaii" username="your_uhnumber"  password="your_password"/>
      <Library name="Hawaii State Library" username="your_barcode"  password="your_pin"/>
    </User>
  </Users>
</DueDates>

• Download DueDates.jar
• In console execute the following:

  java -jar path/to/DueDates-polu-2.0.jar

The following output indicates success:

17 [main] INFO org.mortbay.log - Logging to org.slf4j.impl.SimpleLogger(org.mortbay.log) via org.mortbay.log.Slf4jLog
174 [main] INFO org.mortbay.log - jetty-2.0.1207
787 [main] INFO org.apache.wicket.Application - [DueDatesApplication] init: Wicket extensions initializer
795 [main] INFO org.apache.wicket.protocol.http.WebApplication - [DueDatesApplication] Started Wicket version 2.0.1207 in development mode
********************************************************************
*** WARNING: Wicket is running in DEVELOPMENT mode.              ***
***                               ^^^^^^^^^^^                    ***
*** Do NOT deploy to your live server(s) without changing this.  ***
*** See Application#getConfigurationType() for more information. ***
********************************************************************
809 [main] INFO org.mortbay.log - Started SocketConnector@0.0.0.0:7070

Application at http://localhost:7070/duedates-polu-wicket. Press return to exit.

Screen Walkthrough

The initial screen is a login screen. Use the information in the .duedates/duedates.xml file that you created earlier to log in.

After logging in, you can choose to update certain libraries, filter results within a certain amount of days, or set up email alerts.

The alerts can be setup on this page.