Skip to content

jtan29/reading-timer

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

39 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Reading Time Tracker

Features:

  • Store a text's name, associated genre, and word count (provided by the user)
  • Track multiple texts at the same time
  • In-app timer
  • Calculation of estimated reading speed using logged time
  • Calculation of estimated reading time for given word count and genre, using the calculated reading speed from other texts
  • Options to manually adjust logged time

Potential Users:

  • People interested in improving reading speed
  • People interested in estimating time needed to complete reading a given text
  • People interested in tracking how much time they spend reading

Why:

  • Reading/writing is one of my hobbies, and something that I wish I had when reading was a way to keep track of how long it took me to finish a particular book or other text, and how this time frame could vary depending on the genre. Additionally, I could see this being useful to estimate the time that should be alloted to reading a specific text.

User Stories

  • As a user, I want to be able to add and remove texts from a list of texts currently be tracked.
  • As a user, I want to know the total time I spent reading on a specific text.
  • As a user, I want to know my mean reading speed on a text.
  • As a user, I want to know my mean reading speed over multiple texts.
  • As a user, I want to be able to mark when I have finished reading a text, so that the reading speed can be calculated.
  • As a user, I want to provide a category for a text (graphic novel, novel, short story, non-fictional, class reading etc.)
  • As a user, I want to be able to estimate the time needed to finish reading a text using data from selected previously completed texts.
  • As a user, I want to be able to save my texts, with their word counts, genres, and recorded times, to a file
  • As a user, I want to be able to load my texts (with their details) from a file when launching the app, allowing recording to resume

Instructions (GUI)

  • Load data:
    • Upon running ReadingTimerAppGUI, select either "Load saved data" to load previous data, or "skip" to start a new save
  • Add a new Text:
    • To add a new Text, click the "Manage Texts" option in the menu bar, then click on "Add Text"
    • Enter a title and click submit
    • Enter a word count (must be an integer) and click submit
    • Select one of the genre options from the buttons shown
  • Remove a Text:
    • Select the text to be deleted
    • Click on "Manage Texts" in the menu bar and select delete
  • Save a Text:
    • Click on "Manage Texts" and select "Save Data"
  • Visual component:
    • When timer is running, a timer icon is shown

Citations

  • Parts of the persistence package are sourced from the JsonSerialization demo
  • Referenced Java documentation to create the listener for closing the GUI window

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages