WorkTable is a simple assignment list program which uses bars with different length and colors to represent different due dates. It is written in C++ with FLTK as UI library.
- Bars spanning across the timeline with different lengths and colors to represent a task with a specific due date. It can also have a group of tasks, showing different colors with different lengths representing each tasks in a single bar representing the group as a whole.
- Tasks can also be dragged around to merge with another task or group to form a group, or dragged out of.
In the release section of this repo, a compiled build using Windows 10 build 19045 and mingw-w64-x86_64-gcc 13.2.0-6 in MSYS2 environment is provided. I have no clue on how to release a binary release lol. So give that a try and see how that goes :D
- A compiler which supports C++20
- Make
- A built FLTK codebase and its prerequisites.
- Doxygen (optional, documentation for developers)
WorkTable is based in part on the work of the FLTK project (http://www.fltk.org).
Follow the official building procedures from FLTK documentation.
- Download the source code of the project and extract it to where you would like. Navigate to the extracted directory. We will refer to this directory as "project directory".
- In the project directory, copy "user_fltk_flags - template" and rename it as "user_fltk_flags". In the FLTK directory you have successfully built (or in the project directory if FLTK is installed to your environment. If so, don't type the preceding ./), run
./fltk-config --cxxflags
./fltk-config --ldflags
This would output something like
-I/mingw64/include -march=nocona -msahf -mtune=generic -pipe -Wp,-D_FORTIFY_SOURCE=2 -fstack-protector-strong -D_LARGEFILE_SOURCE -D_LARGEFILE64_SOURCE -D_FILE_OFFSET_BITS=64 ; from --cxxflags
-L/mingw64/lib -pipe -Wl,-subsystem,windows -mwindows -lfltk -lole32 -lcomctl32 -lws2_32 ; from --ldflags
You would need to copy these to FLTK_CXXFLAGS and FLTK_LDFLAGS in user_fltk_flags respectively. Which would look like this:
FLTK_CXXFLAGS := -I/mingw64/include -march=nocona -msahf -mtune=generic -pipe -Wp,-D_FORTIFY_SOURCE=2 -fstack-protector-strong -D_LARGEFILE_SOURCE -D_LARGEFILE64_SOURCE -D_FILE_OFFSET_BITS=64
FLTK_LDFLAGS := -L/mingw64/lib -pipe -Wl,-subsystem,windows -mwindows -lfltk -lole32 -lcomctl32 -lws2_32
- Run Make with no specific target in the project directory.
- The executable is located in bin as build.exe. The tasks.txt file will be searched and created by the executable from the directory it was called from. For example, navigating to the bin directory then running the executable would result in the task file to be in the bin directory. Running it from the project directory by calling ./bin/build.exe would result the file to be in the project directory, etc... Just a tip. :D
- (Optional) Developer documentation in html Doxygen.
Navigate to the doc folder and run
Doxygen docconfto generate the offline html documentation. The landing page of the documentation is in ./doc/html/index.html.
And with that, a warning dialog should pop up as a first boot greet!
Because the tasks.txt file (task file) is not present, the program will notify that it couldn't open the file. It also tells you to not save; this only applies when you have a valid task file with your valuable tasks, but it failed to open the file (for an unknown reason), so you don't wipe your task file clean by saving an empty state. Because we actually don't have the file, we can proceed and save when we made changes to the task file.
Click the paper with folded top right edge to create a new task, the button is in the bottom left. A window should appear.
Let's create your first task. Any task name is valid, but an open curly bracket at the end of the task name is prohibited. For the due date, we use yyyy/(m)m/(d)d format. The parenthesis are optional digits of month or day. So you can fill in either 05 or just 5 for May. The same applies for days as well, 09 or 9 for the 9th day of the month. You can also mix the month having a leading zero, but the days don't, or the other way around as well :D I'll create a task for getting groceries like the following:
Click create, and a bar should appear. The color and length of the bar depends on how close the task is to its due date. If a task is overdue, it gets moved behind the current date line, indicating the task is overdue.
Click on the task you wish to manipulate. A window will pop up. Clicking delete would delete the task. For editing, you can edit the name and the due date, click Save, and the bar will adjust according to your changes. If you don't want to do either, press ESC to close the window.
The save button (floppy disk) and the discard button (undo symbol, hemispheric arrow pointing counterclockwise) are in the bottom left corner, right of the new task button. Clicking the save button saves the current state of your tasks and groups (we will get to this). Clicking the discard button reverts the current state of tasks and groups back to of the task file.
You can narrow down or widen the timescale view with the buttons in the bottom right corner. The button with plus symbol narrows down the timescale (zooms in), but button with minus does the opposite. The lengths of your tasks would change to be relative to the timescale, the color and position will not. The timescale is 1 month by default. The line on the left represents today, the line on the right represents (timescale) ahead from today.
Default timescale (1 month)
Narrowed down to 2 weeks
Try dragging a task on top of another. A group is made. You can also merge a task with existing group (or the other way), or merge group with another group by drag and drop.
Clicking a group will enter "group view", where all the bars are only a single task. So before we clicked and entered the group, we were viewing in "root view", where bars can either be a group or a single task. A button with a straight arrow pointing to the left is now active, this indicates we are in group view and is how we return to root view by clicking it. Group view interacts very similarly with root view, the only difference is you cannot merge tasks to get a group; but a box on the left would appear, dragging the task to the box would pop the task out of the group.
To do so, you must be in root view. Right click the group, a window will appear. It is very similar to window of a task, except it doesn't have an input for a specific due date.
Deleting the group means deleting the tasks in it as well.
That covers all the functionality of WorkTable. Have fun!