Skip to content

Releases

Study Assistant v1.1.0

Choose a tag to compare

@Chiyami1213 Chiyami1213 released this 16 Nov 06:41

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 .ics file 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 as America/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 to Backups\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 in Backups\Before Merge. A merged course's number is written out.

Library

  • Sort and views. S...
Read more

Study Assistant v1.0.1

Choose a tag to compare

@Chiyami1213 Chiyami1213 released this 15 Nov 16:24

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.log to 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

  1. Download StudyAssistant-1.0.1-Windows-Installer.zip below and extract it.
  2. 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

Choose a tag to compare

@Chiyami1213 Chiyami1213 released this 10 Nov 05:21

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)

  1. Download StudyAssistant-1.0.0-Windows-Installer.zip below (under Assets).
  2. Extract the whole zip, then run Install Study Assistant.exe from the extracted folder (keep the payload folder next to it).
  3. 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.