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.
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.
- 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.
- 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.
- 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.
| 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.
- 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 the repository:
git clone https://github.com/Scorpio7736/Task_Manager.git cd Task_Manager/Task_Manager_Beta -
Run the JavaFX application using the included Maven wrapper.
Windows (PowerShell):
.\mvnw.cmd javafx:runmacOS / Linux:
./mvnw javafx:run
Alternatively, with Maven installed:
mvn javafx:run
-
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.
- Select a Work Type from the drop-down menu.
- Choose Hours Required and the number of tasks.
- Check Setup Required or Cleanup Required, if applicable.
- Add the task(s) to the active table.
- Select Mark Complete on a task to move it to the completed table.
- Watch the hours and most-common-category statistics update.
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
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.
- Object-oriented modeling of tasks and work categories
- Event-driven UI programming
- JavaFX
ObservableListand 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
- 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
WorkTypesenum.
- 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.
A project walkthrough is available on YouTube.
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.