QuickSched is a robust, dynamic scheduling platform that provides unparalleled automation for generating timetabled daily/weekly schedules. This platform comes with its own scheduling, timetabling, serialization tooling, intelligent/flexible parser, integrated systems logging, and Google Calendar support.
Head over to here and download the latest release. To run the application:
# Mac, Linux
sh run.sh
# Windows
run.bat
Note1: You need Java 17 (or newer) to run this application
Note2: To get access to Google Calendar features, join the slack link below or email me at: [email protected]
Newbie Tip: To see how
QuickSchedworks without having to create the data yourself, you can have it generate dummy data for you. See here for more details.
QuickSched makes it trivially simple to create a fully customizable schedule. Here we go over how to work with some of these core mechanics.
This platform supports the following:
- Add/Mod/Delete/Get Tasks, Cards, & Events
- Customizable scheduling preferences (e.g. number of hours, time of day, etc.)
- Dynamic scheduling closely integrated with settings
- Intelligent timetabling that works around time-blocks and uses 'clean' start/end times
- Serialization tooling that handles pointer referencing and automatic task deprecation
- Intelligent parser that allows 'flexible' argument entry and time expressions
- Export schedule to Google Calendar
- Generate detailed reports with the 'report' command
- Bespoke log tooling
We'll be taking a closer look at what each command involves below.
Tasks are activities that have an estimated number of hours and are due on a particular day (note: Tasks can be broken up into SubTasks unlike Events).
Usage:
task
task <name> <hours> [cardId] @ <date>
Notes:
- Use '@' to signal the start of a time expression. It must be on its own, followed by the date.
Required:
- name Name for the created Task (whitespace only is not permitted, quotes required).
- hours Number of hours for a given Task (decimal is allowed, but only 0.5).
- date Due date so the scheduling platform can assign it appropriate days.
Optional:
- cardId Id referencing a Card for its tag and color. Must prefix with '+C'.
Examples:
task
task "finish hw3" 3.5 @ eow
task +C2 @ 01-11-2024 6.0 "prep for exam"
When no args are provided, a chart is displayed of all the previously created Tasks.
Cards serve as labels and colors for Tasks and Events. This helps will logically grouping data together.
Usage:
card
card <name> <color>
Required:
- name Name for created Card (whitespace only is not permitted, quotes required).
- color Color for Card.
Examples:
card
card "Supply Chain" GREEN
card blue "Business Law"
When no args are provided, a chart is displayed of all the previously created Cards.
Events serve the role of time-blocks, both recurring and individual. Events are best compared to workouts, classes, and meetings. Events cannot be broken up.
Usage:
event
event true <name> [cardId] @ <date> <timestamp>
event false <name> [cardId] @ [date] <timestamp>
Notes:
- Use '@' to signal the start of a time expression. It must be on its own, followed by the date/timestamp.
- Recurring Events allow multiple dates for 'days of the week'. However, individual Events allow only 1 date.
Required:
- bool Whether the event is recurring
- name Name for created Event (whitespace only is not permitted, quotes required).
- timestamp Timestamp for the Event that represents the start/end time for the day
Optional:
- date Days on which the Event is to be assigned
- cardId Id referencing a Card for its tag and color. Must prefix with '+C'.
Examples:
event
event false "study" @ 9-4
event true @ mon wed fri 11-12:45 +C2 "Class2"
When no args are provided, a chart is displayed of all the previously created Events.
QuickSched offers multiple ways to view your upcoming schedule.
Usage:
sched
This command tells QuickSched to both schedule/timetable all your scheduling data as well as generate a table for you to view.
However, another useful command to quickly view your scheduled Tasks is this command here.
Usage:
subtask
This displays all your scheduled/timetabled Tasks in an easy to follow chart. This command tells QuickSched to both schedule/timetable all your scheduling data as well as generate a table for you to view.
A great benefit of QuickSched is that you can quickly export your generated schedule over to Google Calendar for easy access across all devices.
Usage:
google
One feature that greatly helps with bug reporting and seeing how the scheduler worked is our built-in EventLogger.
Usage:
log
Example:
log
This generates a timestamped log from the start of the session till the current moment.
User configurations is what drives the customizability and dynamic nature of QuickSched. We've designed the Config Dialog to be both straightforward and brief.
Usage:
config
Simply enter the id for whatever option you'd like to modify and then follow the provided format.
QuickSched makes it very convenient to quickly load up scheduling data from your serialization file.
usage:
read
read <filename>
Required:
- name Name of the serialization file being read
Examples:
read
read fall
When no arguments are provided, it displays all the available serialization files. When a file is provided, it deserializes the file contents.
As for saving, QuickSched makes the process quick and simple.
Usage:
save
save <name>
Required:
- name Name of the serialization file being saved
Examples:
save
save my_data
When no arguments are provided, it saves to the last saved or read file location.
And here is a sample serialization file:
CARD {
"MA" LIGHT_BLUE
"LIT" LIGHT_GREEN
"CS" LIGHT_CORAL
"PHI" YELLOW
"Food" BLUE
}
TASK {
"Finish Math Homework" 4.0 +C0 @ 20-09-2024
"Read assigned chapters for Literature" 3.0 +C1 @ 21-09-2024
"Complete Coding Assignment" 6.0 +C2 @ 22-09-2024
"Write Philosophy Essay" 5.0 +C3 @ 23-09-2024
"Prepare for Math Quiz" 2.5 +C0 @ 24-09-2024
"Start Final Literature Project" 8.0 +C1 @ 27-09-2024
"Work on Group Coding Project" 7.0 +C2 @ 28-09-2024
"Study for Philosophy Midterm" 5.0 +C3 @ 29-09-2024
"Complete Math Extra Credit" 3.0 +C0 @ 30-09-2024
"Submit Final Philosophy Essay" 6.0 +C3 @ 01-10-2024
"work" 4.0 @ 05-10-2024
}
EVENT {
true "MA Class" +C0 @ MON WED FRI 09:00am-10:15am
true "PHI Class" +C3 @ TUE THU 01:00pm-02:30pm
true "Lunch" +C4 @ MON TUE WED THU FRI 12:00pm-01:00pm
true "LIT Class" +C1 @ TUE THU 10:30am-12:00pm
true "CS Class" +C2 @ MON WED FRI 02:00pm-03:30pm
}
DAY {
18-09-2024 T0 07:00am-09:00am T0 10:15am-11:45am T0 01:00pm-01:30pm T1 01:30pm-02:00pm T1 03:30pm-06:00pm T2 06:00pm-07:00pm E0 E2 E4
19-09-2024 T2 07:00am-10:30am T2 02:30pm-04:00pm T3 04:00pm-06:00pm E3 E2 E1
20-09-2024 T3 07:00am-09:00am T3 10:15am-11:15am T4 11:15am-11:45am T4 01:00pm-02:00pm T4 03:30pm-04:00pm E0 E2 E4
21-09-2024 T4 07:00am-07:30am T5 07:30am-09:00am
22-09-2024
23-09-2024 T5 07:00am-09:00am T5 10:15am-11:45am T5 01:00pm-01:30pm E0 E2 E4
24-09-2024 T5 07:00am-09:30am T6 09:30am-10:30am T6 02:30pm-05:00pm E3 E2 E1
25-09-2024 T6 07:00am-09:00am T6 10:15am-11:45am T7 01:00pm-02:00pm T7 03:30pm-07:00pm E0 E2 E4
26-09-2024 T7 07:00am-07:30am T8 07:30am-10:30am T9 02:30pm-06:00pm E3 E2 E1
27-09-2024 T9 07:00am-09:00am T9 10:15am-10:45am T10 10:45am-11:45am T10 01:00pm-02:00pm T10 03:30pm-04:00pm E0 E2 E4
28-09-2024 T10 07:00am-08:30am
}
To quickly generate a dummy schedule, simply read the provided serialization file and afterwards build your schedule via sched. Enter the following:
read fall
sched
This will populate your Tasks, Cards, Events, as well as generate your Schedule and SubTasks.
Quick Sched is a dynamic scheduling platform that automates the process of creating a comprehensive schedule.
Command Categories:
Task Management:
- task Create a new Task or display all Task data
- card Create a new Card or display all Card data
- event Create a new Event or display all Event data
- mod Modify a scheduling item
- delete Delete a scheduling item
- get Retrieves Task, Events, or Cards to be displayed
Scheduling Operations:
- build Builds a fresh schedule
- sched Display user schedule
- subtask Displays all scheduled SubTasks
- report Produce a report of all schedule data
File Management:
- read Display all serialization files or read in a file
- save Update the stored db with new scheduling data
- google Export schedule data to Google Calendar
- doc Display documentation for a command
- ls Display all available commands
System and Configuration:
- config View or modify user config settings
- log Display the system log to console
- quit Exit application
References:
- date List of all valid date formats
- ts List of all valid timestamp formats
- color List of all valid colors
Use 'doc <topic>' to view detailed information.
We welcome contributions from everyone who is interested in improving QuickSched and expanding its capabilities. Whether you're fixing bugs, adding new features, or improving documentation, your help is appreciated!
Before you start contributing, please make sure to read our CONTRIBUTING.md file. It contains all the information you need to get started, including how to submit pull requests, our coding standards, and the process for reporting bugs.