Repository navigation
Study Assistant v1.1.0: a Getting Started tutorial, a study planner and a new Calendar, Import From Calendar (Canvas, Brightspace and Google Calendar), a tree of your courses, a much bigger Library, and prompts that make your own AI assistant (Claude, ChatGPT or Gemini) write pages the app reads.
Windows: download StudyAssistant-1.1.0-Windows-Installer.zip, extract the whole zip and run Install Study Assistant.exe (keep the payload folder next to it).
macOS: the disk images are attached by GitHub's build a few minutes after this release is published. Your files are never touched by an update.
Verify your download (optional): SHA256SUMS.txt holds the SHA-256 fingerprint of the zip. In PowerShell run Get-FileHash StudyAssistant-1.1.0-Windows-Installer.zip (on a Mac shasum -a 256 <file>); if the result is the same as the line in the checksum file, the file is intact and exactly the one published here. The Windows zip is checked against SHA256SUMS.txt; each Mac disk image has its own file, SHA256SUMS-macOS-Apple-Silicon.txt or SHA256SUMS-macOS-Intel.txt.
Your antivirus or SmartScreen may warn about the app because it is new and not code-signed; it is a false alarm (see Install).
Getting started and calendars
- Getting Started tutorial. A new student (no course yet) gets a welcome window, a check chain of seven steps at the top of Home (a green tick for each one done, the next in blue; the app counts
them from your own data) and a guided tour. The tour takes you to the page, opens the window, dims everything except the thing to click or fill, points at it with a glowing box and an arrow, and
explains it in a helper card in the corner that is farthest from it, with Back, Next and Skip Tutorial. It moves on by itself when you do what a step asks (a course saved, a term added ...). It covers
adding a course, setting up the term, class times, adding files, making study guides with an AI assistant, importing tasks and Auto-Plan. Skip Tutorial closes it at any time; a Show the Tutorial
button stays at the right of the Home title (and in Settings > Help) so it can be started again whenever you like. - Import From Calendar (Task List). Bring the assignments and events of Canvas, Brightspace and Google Calendar into the planner: paste the private calendar link of the service (it is
read again to keep things up to date: Sync Now, and when the app opens, at most every 3 hours) or import an.icsfile once. You check a table first (task or event, course found from the
course number in the title, category); repeating events and time zones are handled; an item is never added twice, a changed one is updated, and one you deleted is not brought back. The link is
only read, and kept only in the settings file of this computer.
Study planner and Calendar
- A study planner. Set up a term (first day, last day of classes and exams, time zone, wake and bed time, the shortest study block) and the planner knows how much free study time you have. The
cushion of a task is the free time left before its deadline after the work due by then; red means the work cannot fit, yellow is under 2 hours, green is more. Everything is stored in UTC and
shown in the term's time zone (daylight-saving days included); the time zone list shows UTC offsets such asAmerica/New_York (UTC-05:00, EST). - Courses, activities, events. Courses and activities (office hours, work, gym, me-time) have weekly times with weekdays, place and an optional last day; an activity can be non-busy and can run
through breaks. Events have a start and an end, an all-day switch, a place, travel time before and after (counted as busy) and a busy switch; exams and other dated events open the same way. - Tasks. A task has a title, a course (or none: a personal task that can also be planned in a break), a category (Homework, Exam, Quiz, Reading, Project, Lab, Other), a due moment, an estimate,
optional start-ahead days, a state and the minutes logged. A new task takes the course's default estimate for its category (Default Estimates per course), or a built-in one. - Study sessions and Auto-Plan. Auto-Plan fills the free time, earliest deadline first, with sessions of at least the shortest block; running it again replaces only the automatic sessions that have not
started. Manual sessions stay. A placement that breaks a hard rule (outside the term, in a break, over another session) is refused; a soft one (over a class, outside the awake hours) asks "Place It
Anyway?". Work that does not fit is reported, with an x to dismiss the warning, Don't Show Again and a switch in Settings > Study Planner. - Tracking. A study timer starts on a task or a session (Stop and Log adds the minutes, and it survives closing the app); time can be logged by hand. Logged time counts as work done, a session
shows planned against used, and the Add Task form suggests an estimate from your finished tasks of that category. - The Calendar page. Day, Week (the usual view) and Month, with Prev, Today and Next (and a swipe on a touch screen). The grid shows classes (colored by course), activities, events with their
travel time and the study sessions, with free time shaded and its length written on it (Show Free Time switches it off). The line next to the hours zooms the time scale (drag; double-click resets). - Drag and click on the schedule. Drag a session, an event, a class or an activity to move it (the new time shows while you drag, and a cancelled change bounces back at once); drag its top or bottom
edge to change the start or the end; drag over empty time to add a session or an event. A tile shows a map pin before its place and a trash bin. Click one for a compact dialog (title bar in the course
color, date and times in one row, repeat and until, place, Free; Delete, Cancel, Save). - Repeating classes and activities. After a drag, or from the dialog, the app asks what to change: this event, this and the following events on that weekday, this and all following events, or all
events. Deleting asks the same; an event or a study session asks before it is deleted. A day can be changed or skipped without touching the other weeks. - The left panel. Your courses and activities as blocks (a custom event block, too) to drag onto the schedule: a course or an activity adds a weekly time, the custom event block opens the new-event
form. Blocks have a grip to drag them into a new order, a ⋯ menu (Details, Rename, Change Color, Hide, Delete), rename on double-click, and a Hidden section. Delete asks first; a course is deleted only
after the database is copied toBackups\Before Delete <time>. The panel folds, and its border is dragged to change the width (double-click: usual width). Tasks are in the Task List. - Terms. A term list above the calendar (and on the Task List) switches the active term; Manage Terms adds, changes and deletes terms, with the wake-up time, the start and end dates and the holidays
and breaks of that term. The panels show the active term's courses first and the others in a folded section. Removing a holiday or a class time asks first.
Task List
- Every task in one table, filtered by course (the same blocks as the Calendar panel), grouped by course, category or due week, searched, and sorted by clicking any column head (up, down, or both
arrows when not sorted by it). A picked course shows its tasks under its name in its color, with its Completed tasks below. Edit all fields, mark done, time, log or delete. - Import From Syllabus. One button reads each course of the term: the homework and exams already on its course page, and the dated work and class times of its syllabus file. New tasks are added at
once (a graded homework or a past exam as finished, exams also on the Calendar) and never twice. One course can be checked row by row first. It can also write the homework and exams on the course pages
(on by default).
Courses
- Course page. The Overview is a fixed order of foldable sections: a row of numbers, Coming Up (homework, exams, tasks), Grades, Syllabus and How Well You Know the Material. Add Syllabus reads a
syllabus pdf (grading, letter grades, instructor, outline); Edit Syllabus changes any of it. Resources starts with Links and every section folds. Edit Outline is written lecture by lecture or chapter
by chapter in a table, as free text, or pasted. - Courses tree. Courses > All > Tree is a tree that grows upward from All Disciplines at the bottom: branches for domains, fields and topics (similar fields on the same branch) and a bubble for each
course, with its photo as the background. Click a bubble to fold or unfold its branches, click a course to open it, drag any bubble to move it (it lifts while held, settles when dropped, its branches
and courses follow, bubbles and lines never overlap: what a held bubble comes near is pushed away, it slides along lines instead of crossing them, and every bubble stays inside the map's rectangle; a line runs from the border of a bubble to the border of its parent), zoom with + / - or the wheel, drag the map to move it, Fit, Reset View (the view and every bubble back where it was) and Collapse All. Self-study courses sit on the branch of their
own field with a dashed outline. A field with only one topic has no extra "General" bubble, and a course's whole title is shown. - Merge Courses. Make two or more courses one (MA 266 / MA 303): choose the course that stays and a tag for each part. Files, homework and exams get the tag, everything of the other courses moves
over, they are deleted, and a copy of the database and settings is kept inBackups\Before Merge. A merged course's number is written out.
Library
- Sort and views. Sort by Type (a tile for each type, the usual view), Course (a tile for each course, like the Courses page), Date Added (a chain of bullets by day, month or year, newest or oldest
first; every group folds) or Title. Files show as Cards, Tiles or a Details table. Long lists are drawn 120 files at a time. - Import menu. Add a File, Import a Zip (every pdf and html file of a zip, folders included, on a confirmation page where the type, title, lecture and course of each can be changed and files unchecked)
and Update From Folder (also on every course page as Update Files): new and changed files are listed for confirmation, files already in the Library (same content) are recognized, homework and exam
documents come first. Your folders are only read, never changed. - Imported files are named the Library's way: HW 5, HW 5 Solution, Midterm 1 Practice, a note's topic with its number in the lecture field, Syllabus. The Type box of Add File and Edit File shows
the general types first; Homework and Exam show their own types (helper, solution, graded paper, grade explanation, preparation ...) only when chosen. - Prompt for AI (Library > Import). Pick a course, a kind of page (a study guide, a homework helper, a homework or exam grade explanation, an exam reflection or an exam preparation page) and
your AI assistant (Claude, ChatGPT or Gemini), and the app writes a prompt to paste into your own chat with it. It carries the page's contents and style rules, the file name the page
must have, and the exact format the app reads (section ids, problem cards, grader-comment badges, quiz questions, link texts), and can list your notes from the Library so the assistant links to
them. Only the way the finished page is handed over differs between the assistants (an artifact for Claude; a downloadable.htmlfile or one code block for ChatGPT; Canvas or one code
block for Gemini). Download the HTML it makes and import it as usual. The Library also recognizes... Midterm 1 Reflection.htmland... Final Exam Preparation.htmlas those page types,
and the app reads a link of the form.../artifact/<id>at any address (notes pages that are not on the web are linked ashttps://study-assistant.local/artifact/notes-<lecture number>#<section id>).
The prompt texts are instudy/prompts/and can be edited. - Grade reports are read by the app. When a graded homework or exam (a Gradescope graded copy, whose first pages are the grade report) is opened and has no grade data yet, the app reads the
problems, scores, grader comments and where each comment sits on the paper, so a grade explanation can mark the paper. Nothing has to be run by hand. - Tidy Up. Finds files that are in the Library twice and lets you remove the extra ones (the book that stays takes over their courses), and suggests titles in the Library's own form. Both ask
first, and the database is copied to Backups.
Windows, macOS and the GitHub pages
- Study Assistant for macOS. A
.dmgfor Apple silicon and one for Intel Macs: open it, drag the app into Applications and approve it once (right-click > Open). The files live in
~/Library/Application Support/Study Assistant; an export from Windows imports on a Mac and the other way round. Screenshots (F2), the folder and file pickers use the macOS tools. The Mac app is built
and checked by GitHub (.github/workflows/build-macos.yml,tools/build_mac.py). - A new setup wizard (Windows), drawn at the screen's real resolution with a picture panel and Back / Next / Cancel: welcome, existing version, shortcuts, ready, progress with percentage, finish
(with links to the project page, Help and the issue page). Larger check boxes. - The installer finds an installed version and offers Update (the old program is removed only after the new one is in place), Uninstall the older version first, or Keep both (own folder, shortcut and
Settings > Apps entry, with a warning that both share one data folder and one address). A newer installed version is warned about, and a folder not made by the installer is only renamed. Your files
are never replaced. A Desktop shortcut and a Start menu entry are options; the uninstaller removes both. - Fewer antivirus false alarms. The installer says up front that an antivirus or SmartScreen may warn; the exes carry version information and are not compressed with UPX; every release publishes
its SHA-256 checksum. - The GitHub page has tabs (Overview, Install, Your Files, Shortcuts, Help, Changelog), each its own page in
docs/; the README has a gallery of the current screens (with made-up courses and files).
Settings, speed and small things
- The code is grouped in folders (
core,library,study,datafiles,desktop,planner,views, andtoolsfor the build scripts and the installer) instead of one long list of files. - Streamlit is limited to 1.50 up to 1.66 in
requirements.txt(what the app was tested with); the exe carries its own copy. - Fixes found while checking this release: the hover note of the Import button no longer stays on top of the window the Import menu opens, the tree's buttons no longer wrap to two lines on a narrow window, a cancelled repeating-event change bounces back, the Import menu closes behind the
window it opens, and the Remove buttons in Edit Schedule are right-aligned. - Help and Report an Issue in Settings. Help answers the common questions; Report an Issue opens a ready-made GitHub issue in the browser (optional steps, technical details, a log excerpt with your
name and folders replaced, screenshots you pick or the newest F2 ones). The app sends nothing by itself and keeps no e-mail address. - Settings has a bar to jump to a section (Appearance, Eye Rest, Study Planner, Backup, Keyboard Shortcuts, Help, Report an Issue, Danger Zone, About), styled like the tabs of a course page.
- 3D views in guides work without the internet. three.js (r128, which the guides use) is kept with the app (
study/vendor) and put into a guide's page instead of being fetched, so the 3D
tools show on a device whose network blocks the CDN. The window also lets WebView2 fall back to software drawing when a graphics driver is on its block list, which is what turns WebGL off.
(The math in guides still comes from the MathJax CDN.) - Speed on slower devices. Settings > Speed and Effects: Light turns off animations, shadows and blur; Automatic does it by itself when the screen draws slowly and remembers it.
- Buttons at the top of every page look alike (outlined, one size, icon and text centered), and the Remove buttons in Edit Schedule and Manage Terms use normal text.
- The old quiz files are gone. The Quiz tab asks the questions that are in the notes themselves (the
Qarray of a study guide, or a note's Self-check); thequizzesfolder of question
files that had to be written outside the app is no longer read. - Back and Forward return to the same place inside a page (the Task List, a Library tile and its sort), in the order the places were visited.
- The loading screen shows the app icon with a bar from 0 to 100% and waits at least 1 second.