Release (StarV2)

System	Program	Extra
MacOS	StudentAssignmentDownloaderMac	Launch Terminal Run cd Downloads Run chmod +x StudentAssignmentDownloaderMac Double click program Allow app to run through the settings app
Windows	StudentAssignmentDownloader.exe	Windows protected your PC > More info > Run anyway
Linux	StudentAssignmentDownloaderLinux	Open Terminal Run cd Downloads Run chmod +x StudentAssignmentDownloaderLinux Run ./StudentAssignmentDownloaderLinx

How to create Canvas Token:

1. Go to Canvas (Web)
2. Navigate to Account > Settings
3. + New Access Token
4. Give it any name and an optional expiration date
5. Copy the token to give to the program

How to get institution and course ID:

1. Go to Canvas (Web)
2. Click into any course
3. Get information from URL

• Institution of https://sfsu.instructure.com/courses/123456 is sfsu
• Course ID of https://sfsu.instructure.com/courses/123456 is 123456

Update Config

• To update the config, open Canvas.cfg in any text editor
• To fully reset, delete Canvas.cfg

Rubrics:

• In the past, I maintained a remote source of rubrics that the program sources from
• There is an optional setting to link to a remote source of rubrics
  • Leave it empty if you wish to source rubrics locally
  • If you wish to host your own remote source of rubrics, check out Rubric Repo Demo
    • If you are using the same rubrics from Spring 2024, you can use https://raw.githubusercontent.com/Nexumi/rubric-repo-demo/main/
• If you are sourcing your rubrics locally:
  • Place rubric within the same location as the script
  • You can create a folder for the rubrics if you would like, the script will search through every file in the current and sub folders
  • Rubrics are detected by having a file name that starts with Assignment- or Exam- and ends with -Rubric.xlsx
  • This also means that you can customize the default state of the rubric

Note:

• Chrome might block the download
• Each operating system will probably give you some sort of warning about running an unknown file. If you trust, please proceed. If you do not trust, do not use. You can download the source file directly and run it directly using Python3 if you know how.

MacOS Warning:

• If you have used Release (Spring 2024), there was a bug that caused CanvasToken.cfg to be created at ~
  • If there is a CanvasToken.cfg at ~ you should delete it

Release (Star)

System	Program	Extra
MacOS	StudentAssignmentDownloaderMac	Launch Terminal Run cd Downloads Run chmod +x StudentAssignmentDownloaderMac Double click program Allow app to run through the settings app
Windows	StudentAssignmentDownloader.exe	Windows protected your PC > More info > Run anyway
Linux	StudentAssignmentDownloaderLinux	Open Terminal Run cd Downloads Run chmod +x StudentAssignmentDownloaderLinux Run ./StudentAssignmentDownloaderLinx

How to create Canvas Token:

1. Go to Canvas (Web)
2. Navigate to Account > Settings
3. + New Access Token
4. Give it any name and an optional expiration date
5. Copy the token to give to the program

How to get institution and course ID:

1. Go to Canvas (Web)
2. Click into any course
3. Get information from URL

• Institution of https://sfsu.instructure.com/courses/123456 is sfsu
• Course ID of https://sfsu.instructure.com/courses/123456 is 123456

Update Config

• To update the config, open Canvas.cfg in any text editor
• To fully reset, delete Canvas.cfg

Rubrics:

• In the past, I maintained a remote source of rubrics that the program sources from
• There is an optional setting to link to a remote source of rubrics
  • Leave it empty if you wish to source rubrics locally
  • If you wish to host your own remote source of rubrics, check out Rubric Repo Demo
    • If you are using the same rubrics from Spring 2024, you can use https://raw.githubusercontent.com/Nexumi/rubric-repo-demo/main/
• If you are sourcing your rubrics locally:
  • Place rubric within the same location as the script
  • You can create a folder for the rubrics if you would like, the script will search through every file in the current and sub folders
  • Rubrics are detected by having a file name that starts with Assignment and ends with -Rubric.xlsx
  • This also means that you can customize the default state of the rubric

Note:

• Chrome might block the download
• Each operating system will probably give you some sort of warning about running an unknown file. If you trust, please proceed. If you do not trust, do not use. You can download the source file directly and run it directly using Python3 if you know how.

MacOS Warning:

• If you have used Release (Spring 2024), there was a bug that caused CanvasToken.cfg to be created at ~
  • If there is a CanvasToken.cfg at ~ you should delete it

Release (Universal)

System	Program	Extra
MacOS	StudentAssignmentDownloaderMac	Launch Terminal Run cd Downloads Run chmod +x StudentAssignmentDownloaderMac Double click program Allow app to run through the settings app
Windows	StudentAssignmentDownloader.exe	Windows protected your PC > More info > Run anyway
Linux	StudentAssignmentDownloaderLinux	Open Terminal Run cd Downloads Run chmod +x StudentAssignmentDownloaderLinux Run ./StudentAssignmentDownloaderLinx

WARNING:
I am not very smart and the config file does not generate properly. An update is on the way with some additional features, but the current workaround it to open Canvas.cfg and remove the 4th line (the duplicate line).

Rubrics:

• In the past, I maintained a remote source of rubrics that the program sources from
• You will now have to source a copy of the rubric yourself
  • Place rubric within the same location as the script
  • You can create a folder for the rubrics if you would like, the script will search through every file in the current and sub folders
  • Rubrics are detected by having a file name that starts with Assignment and ends with -Rubric.xlsx
  • This also means that you can customize the default state of the rubric

How to create Canvas Token:

1. Go to Canvas (Web)
2. Navigate to Account > Settings
3. + New Access Token
4. Give it any name and an optional expiration date
5. Copy the token to give to the program

How to get institution and course ID:

1. Go to Canvas (Web)
2. Click into any course
3. Get information from URL

• Institution of https://sfsu.instructure.com/courses/123456 is sfsu
• Course ID of https://sfsu.instructure.com/courses/123456 is 123456
• To update the config, open Canvas.cfg in your favorite text editor
  • Line 1: Institution
  • Line 2: Canvas Token
  • Line 3: Course ID
• To fully reset, delete Canvas.cfg

Note:

• Chrome might block the download
• Each operating system will probably give you some sort of warning about running an unknown file. If you trust, please proceed. If you do not trust, do not use. You can download the source file directly and run it directly using Python3 if you know how.

MacOS Warning:

• There was a bug in the code that caused CanvasToken.cfg to be created at ~
  • If there is a CanvasToken.cfg at ~ you can delete it
  • Alternatively you can move the file to the correct location (same folder as the program file)
    • Also rename it to Canvas.cfg

Release (Spring 2024)

System	Program	Extra
MacOS	StudentAssignmentDownloaderMac	Launch Terminal Run cd Downloads Run chmod +x StudentAssignmentDownloaderMac Double click program Allow app to run through the settings app
Windows	StudentAssignmentDownloader.exe	Windows protected your PC > More info > Run anyway
Linux	StudentAssignmentDownloaderLinux	Open Terminal Run cd Downloads Run chmod +x StudentAssignmentDownloaderLinux Run ./StudentAssignmentDownloaderLinx

How to create Canvas Token:

1. Go to Canvas (Web)
2. Navigate to Account > Settings
3. + New Access Token
4. Give it any name and an optional expiration date
5. Copy the token to give to the program

Notes:

• Chrome might block the download
• Each operating system will probably give you some sort of warning about running an unknown file. If you trust, please proceed. If you do not trust, do not use. You can download the source file directly and run it directly using Python3 if you know how.

MacOS Warning:

• There is a bug in the code that causes CanvasToken.cfg to be created at ~
  • You can safely delete CanvasToken.cfg from ~ when you are done using the program

Release (Spring 2024) [GradeBot Edition]

System	Program	Extra
MacOS	StudentAssignmentDownloaderMac	Launch Terminal Run cd Downloads Run chmod +x StudentAssignmentDownloaderMac Double click program Allow app to run through the settings app
Windows	StudentAssignmentDownloader.exe	Windows protected your PC > More info > Run anyway
Linux	StudentAssignmentDownloaderLinux	Open Terminal Run cd Downloads Run chmod +x StudentAssignmentDownloaderLinux Run ./StudentAssignmentDownloaderLinx

How to create Canvas Token:

1. Go to Canvas (Web)
2. Navigate to Account > Settings
3. + New Access Token
4. Give it any name and an optional expiration date
5. Copy the token to give to the program

Notes:

• Chrome might block the download
• Each operating system will probably give you some sort of warning about running an unknown file. If you trust, please proceed. If you do not trust, do not use. You can download the source file directly and run it directly using Python3 if you know how.
• This version was built as half a joke about turning a lie into a truth
  • Now you can actually tell your students that the program automatically gives them zeros for incorrect file names (and no submissions)

GradeBot:

• As files are being downloaded, students with no submission automatically get a zero.
• GradeBot will check for file naming. A list of mistakes that were detected are displayed. You can manually pardon naming that you think are fine.
  • e.i. A student uses their preferred name

Release (Fall 2023)

System	Program	Extra
MacOS	Direct Run only	Check README.md for instructions
Windows	StudentAssignmentDownloader.exe	Chrome might block the download Windows protected your PC > More info > Run anyway
Linux	Direct Run only	Check README.md for instructions