Skip to content

About

A JavaFX desktop task manager for creating, tracking, and completing work tasks. Features time estimates, setup and cleanup options, completion timestamps, live productivity analytics, and interactive visual feedback.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

3 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 

Repository files navigation

Task Manager

A desktop maintenance task manager built with Java, JavaFX, and FXML. The application helps users plan repetitive work, estimate time requirements, track completion, and monitor progress through a responsive graphical interface.

Status: Beta / learning project. Tasks are currently stored in memory during an app session; persistent storage is not implemented.

Overview

Task Manager began as a console-based application and was redesigned as a JavaFX desktop app. The graphical version focuses on straightforward task entry, live tables, useful completion statistics, and visual feedback.

Features

Create and organize tasks

  • Choose from predefined maintenance work types.
  • Specify the number of tasks to add at once.
  • Estimate the time required in half-hour increments, from 0.5 to 24 hours.
  • Mark whether setup and cleanup are required.
  • Review active tasks in an interactive JavaFX TableView.

Track completion

  • Mark individual tasks as complete.
  • Automatically move completed tasks to a separate table.
  • Record the completion date and time.
  • Display fireworks when a task is completed and an "All Done!" celebration when the active list becomes empty.

Live productivity statistics

  • Hours remaining: Sum of the estimated hours for active tasks.
  • Hours completed: Sum of the estimated hours for completed tasks.
  • Most common work type: Identifies the most frequent active category; ties are resolved using the highest estimated task duration.

These statistics are recalculated as tasks are added or completed. The completed-hours figure is based on task estimates, not a stopwatch or measured elapsed time.

Tech stack

Technology Role
Java Application logic and task modeling
JavaFX 17.0.6 Desktop interface controls
FXML Declarative UI layout
Maven Build configuration and dependencies
JavaFX properties and collections Observable task data and UI binding
JUnit 5 Test dependencies configured in Maven

The current pom.xml sets the Java compiler's source and target levels to Java 24.

Getting started

Prerequisites

  • JDK 24 to match the repository's current Maven compiler configuration
  • An operating system supported by JavaFX
  • Internet access on the first build to resolve Maven dependencies

Clone and run

  1. Clone the repository:

    git clone https://github.com/Scorpio7736/Task_Manager.git
    cd Task_Manager/Task_Manager_Beta
  2. Run the JavaFX application using the included Maven wrapper.

    Windows (PowerShell):

    .\mvnw.cmd javafx:run

    macOS / Linux:

    ./mvnw javafx:run

    Alternatively, with Maven installed:

    mvn javafx:run
  3. The Maintenance Task Manager window opens. Select a work type, quantity, estimated hours, and optional setup/cleanup requirements, then add tasks.

If the wrapper does not launch in your environment, import Task_Manager_Beta/pom.xml as a Maven project in an IDE with JDK 24 configured.

How to use

  1. Select a Work Type from the drop-down menu.
  2. Choose Hours Required and the number of tasks.
  3. Check Setup Required or Cleanup Required, if applicable.
  4. Add the task(s) to the active table.
  5. Select Mark Complete on a task to move it to the completed table.
  6. Watch the hours and most-common-category statistics update.

Project structure

Task_Manager/
├── README.md
└── Task_Manager_Beta/
    ├── pom.xml
    ├── mvnw
    ├── mvnw.cmd
    └── src/
        └── main/
            ├── java/com/example/task_manager_beta/
            │   ├── HelloApplication.java
            │   ├── HelloController.java
            │   ├── MaintenanceTask.java
            │   ├── WorkTypes.java
            │   └── Fireworks.java
            └── resources/com/example/task_manager_beta/
                └── hello-view.fxml

Key components

  • HelloApplication — JavaFX entry point and main application window.
  • HelloController — Handles task input, table configuration, completion events, and statistics.
  • MaintenanceTask — Represents task type, estimated hours, setup/cleanup flags, and completion timestamp.
  • WorkTypes — Defines available maintenance categories.
  • Fireworks — Provides visual completion feedback.
  • hello-view.fxml — Defines the interface layout and controls.

Engineering concepts demonstrated

  • Object-oriented modeling of tasks and work categories
  • Event-driven UI programming
  • JavaFX ObservableList and property bindings
  • Table cells with embedded actions
  • Collection processing using Java Streams
  • Aggregate statistics and tie-breaking logic
  • FXML-based separation of layout and controller code

Current limitations

  • No persistent storage: Tasks and completion records are not retained after closing the application.
  • Estimated, not measured, time: The statistics add configured task-hour estimates; they do not time actual work.
  • Predefined task types: Work categories are provided by the application's WorkTypes enum.

Potential future improvements

  • Save and restore tasks using JSON or a database.
  • Add due dates, custom task categories, and editable tasks.
  • Introduce more advanced sorting and prioritization.
  • Add search, filtering, and task-history reporting.
  • Expand automated tests and input validation.
  • Improve keyboard navigation and accessibility.

Demo

A project walkthrough is available on YouTube.

Contributing

Feedback, bug reports, and ideas for improvement are welcome through the repository's GitHub Issues, where available.


Created as a hands-on Java development project exploring desktop UI design, task modeling, event handling, and productivity analytics.

About

A JavaFX desktop task manager for creating, tracking, and completing work tasks. Features time estimates, setup and cleanup options, completion timestamps, live productivity analytics, and interactive visual feedback.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages