Skip to content

lluisalemanypuig/TodoListManager

Repository files navigation

Todo List Manager

This is a stand-alone program (browser-less and server-less) written in Java to create and edit simple Todo Lists, consisiting of high, medium and low priority tasks.

This software allows adding subtasks to every task and implements several states a task can be in. For example, after being Opened, a task can have somebody Working on it who, after a while, might get tired of it, and mark it as Put on hold. A task can be Cancelled and be marked as Deleted after being completed (complete a task and realise it was a bad idea, so you delete whatever changes you did to a project). In case of having made a mistake while creating a task, it can be removed from the list (note that this is not the same as marking the task Deleted!). If a task needs somebody to revise it, the user can mark it as Pending revision, or that it is already being On revision. Depending on what state the task will be marked as, the software will prompt the user to give a reason for such a change. All these changes are done under an the user's name, also know as the author of any change, or creator of a task. This information is editable at any moment.

Since a task might be edited several times, this software can handle an unlimited amount of changes and keeps track of the history of changes, including the author of each change.

The tasks are saved in a JSON-formatted file. The library used to read and write these files can be found here, which has been included in this repository for convenience (its LICENSE has been included also in this repository in the LICENSES directory).

Languages

It is our intention to translate this software into as many languages as we can. TodoListManager has been fully translated into:

  • Catalan
  • English

Execute

Copy the .jar file and lib directory wherever you like. You will also need to copy the TodoListManagerData/ directory so as to be able to see the icons of the tasks. Finally double-click on the .jar file in order to execute this software.

In case the icons do not appear

The TodoListManager outputs messages into a log file. In Windows, this log file is C:\todomanager.log, and in Linux is /tmp/todomanager.log. In this file, you will find a line with the following format

	[date]    INFO Program executed from path: PATH

where PATH is a path to (most likely) the user directory. The directory TodoListManagerData should be stored in that said PATH for the program to work properly.

FAQs

  1. Do you accept feature requests?

    Yes, go to this page to see how to fill in this request.

  2. The program is buggy... When will you fix it?

    Developing a software like this one is quite a time-consuming task. Every feature added has to be tested always taking into account that many other features' behaviour might have been affected. This means that bugs could happen. Yes, I will be very happy to fix them, but I need to know where these bugs are. Please, report the bug here.

Sample

How the software looks like when the user opens the file sample file