gmdo

Get my data out

A command-line tool where a TinyFish agent signs in to your school’s Canvas and saves every grade, assignment and file you have there.

Type a command or pick one below. The answer comes from a real export of one student’s account, with every name taken out.

Portal: 43 courses, 1,168 assignments, 58 documents (140 MB)
Changed since last export: 0 course(s) → agent runs (est. ~$0.00)

Three commands

Sign in once, export, open the files. TinyFish does the browsing; gmdo keeps the record straight.

Sign in once, yourself.

gmdo opens a TinyFish browser profile on your school’s sign-in page. You log in there, Google or Microsoft included. The profile keeps the cookies; gmdo keeps only the profile id.

gmdo setup
canvas.your-school.edu/?login_success=1TinyFish
Browser profile
gmdo-canvas
Signed in with
Google, by you, in this window
Saved to profile
55 cookies
Password stored
None

Export everything.

Every course’s Grades page goes to the TinyFish agent as one run, all in a single batch. gmdo follows each run to the end and compares the rows it read with the number Canvas reports.

gmdo export --terms "2025-2026,2026-2027"
Agent runs, one per course
CourseRows readCanvas listsStepsRun

Open the files.

One row per assignment, in CSV and JSON, each with a stable key, so running it again updates rows instead of adding duplicates. Your documents sit beside them in documents/.

open export/records.csv
records.csv
record_keyassignment_namesubmittedscoreout ofmatches Canvas

Choose what it saves

Each switch is a real flag you can pass to the export command.

Download the files you handed in.

Your own uploads and every attachment on your submissions, checked byte for byte. --docs own,submissions

Add your teachers’ course files.

1,780 more files, about 3.3 GB of slides and worksheets. --docs course

Read only the courses that changed.

Unchanged courses never reach the agent, so they cost nothing.

Start again from scratch.

Every course goes back to the agent. --full

Hide the scores in the showcase too.

Names are always taken out; this blanks the marks as well. --hide-scores

Every course checked

After each run, gmdo asks Canvas how many assignments the course has and compares. A course that comes back short is read again; if it is still short, the export says so and lists what is missing.

School yearCourseRows read / Canvas listsResult

Questions

Does gmdo ever see my password? No. gmdo setup opens a TinyFish browser on your school’s sign-in page and you sign in there yourself, Google or Microsoft included. The browser profile keeps the cookies. The tool stores a profile id and nothing else.

What does TinyFish do here? Four things. A browser profile holds your sign-in. The agent opens each course’s Grades page and reads every row, sent as one batch of runs. The runs endpoint tracks each run to the end and resumes after a crash. The same signed-in browser downloads your files.

Why have an agent read the page? It reads what you can see, the way you would. gmdo also reads the data Canvas loads behind that page, and uses it to check the agent: the count of assignments per course, and whether each score matches.

What does a run cost? TinyFish charges per agent step, $0.016 at the time of writing. A course takes six to twelve steps. Unchanged courses are never sent, so a rerun in a quiet week costs nothing. --dry-run prints the estimate first, and --budget stops anything above it.

What happens if I get signed out? gmdo notices before it exports anything and tells you to run gmdo setup again. It never saves a sign-in page as your data.

What if a run comes back short or fails? It is read once more. If it is still short, courses.csv marks the course incomplete and manifest.json lists the assignments that are missing.

What if Canvas hasn’t posted a grade? The cell stays empty and the row records Canvas’s own state, such as pending review. gmdo never fills in a number.

Is this allowed? It reads your own account, at a human pace, and the agent is told never to submit or change anything. Check your school’s rules before running it on a schedule.

Can I share my export? Run gmdo showcase. Course names become plain subjects, names of students and teachers become [student] and [teacher], comments become a count, and the copy is searched for every name before it is kept.

Does it work on other portals? It is built and tested on one school’s Canvas. Everything Canvas-specific lives in one adapter file, so another Canvas school should need little or no change.

The code, the tests and a setup guide are on GitHub. Clone