Repository navigation
Releases
Study Assistant v1.1.0
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. S...
Study Assistant v1.0.1
What's new in 1.0.1
Quizzes
- Two ways to check answers. Choose Check After Each Answer (the answer is marked and explained right away, then locked) or Check After Finishing (marked at the end, as before).
- Save For Later. Pause a quiz and Resume it from the quiz list, exactly where you stopped.
- View finished quizzes again. Open any past attempt to see your answers, the right answers and the explanations. Every attempt is kept until you choose Clear Attempt History.
- Answer options are shuffled on every attempt, so the right answer isn't usually the second one.
Keyboard shortcuts and window
- F11 full screen · F5 refresh the page (Ctrl + F5 reloads everything) · F2 saves a screenshot of the app window to
%APPDATA%\Study Assistant\screenshots. - m hides or shows the menu bar (point at the left edge to bring it back). While it is shown, press h Home, a Calendar, l Library, n Note Reader, c Courses or s Settings.
- Streamlit's own Deploy button, three-dot menu and "Running…" text are hidden.
Courses
- Equation sheets for past exams. The Exams tab lists every exam, so you can build a sheet for a midterm that is already over.
- Preparation link on past exams, next to Solution, Reflection and Graded.
- Instructor's notes on a homework (what to hand in, hints) show under its row.
Reliability
- Fewer lost connections. The app keeps your session for a day after sleep or a locked screen. If the hidden server stops, the window restarts it instead of showing "Connection error". The installed app writes
logs\server.logto help diagnose problems. - Export and Import show a progress bar. Import now writes every file in the zip, so existing files are replaced by the zip's versions. Files that differ are copied to
Backups\Before Import …first.
Install or update
- Download StudyAssistant-1.0.1-Windows-Installer.zip below and extract it.
- Run Install Study Assistant.exe.
Updating from 1.0.0: your files are not touched. They live in %APPDATA%\Study Assistant, and this is a clean installer with no personal files in it. The installer renames your old program folder to study-assistant (old <date time>) and installs the new one. You can delete that old folder later. Close Study Assistant before you run the installer.
Antivirus note: some antivirus or firewall software may flag a new, unsigned app like this one. It is a false alarm; you can safely allow it.
Full list of changes: CHANGELOG.md
Study Assistant v1.0.0
Study Assistant 1.0.0
The first release of Study Assistant, a personal study desk for university coursework. Keep a course's textbooks, lecture slides, notes, homework and exams in one library, read them side by side, and let the app keep track of deadlines, grades and outlines. It runs entirely on your computer; nothing is sent anywhere.
Download and install (Windows 10 or 11)
- Download StudyAssistant-1.0.0-Windows-Installer.zip below (under Assets).
- Extract the whole zip, then run Install Study Assistant.exe from the extracted folder (keep the
payloadfolder next to it). - Open Study Assistant from the desktop shortcut. It starts empty; add your own courses and files.
It installs for your user only (no administrator needed) and appears under Settings > Apps, where it can be uninstalled. Your files are kept unless you choose to remove them.
Your antivirus or firewall may warn about the installer or the app, and may even call it malware. This is a false alarm: the program is packaged with PyInstaller and is not code-signed, which security software often distrusts. If it blocks the file, choose "More info > Run anyway" (Windows SmartScreen), or allow / restore the file in your security software, and ignore the warning. The whole source code is in this repository.
Highlights
- Course library for PDFs and HTML pages (textbooks, lecture slides, notes, homework, exams, syllabi). Imports are copies; your originals are never changed.
- Note Reader: interactive notes with tabs for the notes, mind map, equation sheet, assumptions, quiz and errata. Click an equation or a source line and the matching slide or textbook page opens beside it.
- PDF reader: single, double or continuous pages, zoom and drag to move (Ctrl + wheel to zoom), search, and pen or highlighter drawing saved with the file.
- Homework and exams: helper and grade-explanation pages beside the problem or graded paper, Gradescope grade reports, exam preparation pages.
- Course outlines build themselves from the syllabus topics or the lecture titles, and can be edited as plain text (Edit Outline, Auto Build).
- Calendar and Home: weekly class schedule, holidays and exams, and what is due next.
- Quizzes and eye rest: quizzes from your notes with scores per chapter, and a reminder to rest your eyes every 20 minutes.
- Backup, export and import: automatic snapshots, a library backup in a folder you choose, and Export My Files / Import to keep a copy or take everything to another computer. Nothing is deleted on import.
Notes
- Your files live in
%APPDATA%\Study Assistant. To move to another computer, install the app there, then use Settings > Backup > Import with a zip made by Export My Files. - The full list of changes is in CHANGELOG.md.